📕 docs(none): release post and docs (#1548)

6.3.0 release post and related documentation updates.

- added a pre-commit hook to make sure the test registry isn't polluting the lockfile.
- added a `yarn @bud info` command to hopefully highlight any problems with mismatched versions, missing deps, registry problems.

refers:

- none

## Type of change

**NONE: internal change**



This PR includes breaking changes to the following core packages:

- none

This PR includes breaking changes to the follow extensions:

- none

## Dependencies

### Adds

- none

### Removes

- none

.github/workflows/test.yml

@@ -43,34 +43,49 @@ jobs:
           restore-keys: |
             ${{ runner.os }}-yarn-
 
-      - name: Install
+      - name: yarn install
         run: |
           yarn install
 
-      - name: Lint (dependencies)
+      - name: yarn @bud build
+        run: |
+          yarn @bud build
+
+      - name: yarn @bud lint dependencies
         run: |
           yarn @bud lint dependencies
 
-      - name: Lint (syntax)
+      - name: yarn @bud lint
         run: |
           yarn @bud lint
 
-      - name: Lint (style)
+      - name: yarn @bud format
         run: |
           yarn @bud format --no-fix
 
-      - name: Lint (module exports)
+      - name: yarn @bud lint exports
         run: |
           yarn @bud lint exports
 
-      - name: Build
+      - name: yarn @bud test run unit
         run: |
-          yarn @bud build
+          yarn @bud test run unit --verbose --maxWorkers 2
+
+      - name: yarn @bud registry install
+        run: |
+          yarn @bud registry install
+      - name: yarn @bud registry start
+        run: |
+          yarn @bud registry start
+
+      - name: yarn @bud test run integration
+        run: |
+          yarn @bud test run integration --verbose --maxWorkers 2
 
-      - name: Test (unit)
+      - name: yarn @bud test run e2e/js
         run: |
-          yarn @bud test unit --verbose --maxWorkers 2
+          yarn @bud test run e2e/js --verbose --maxWorkers 2
 
-      - name: Test (integration)
+      - name: yarn @bud test run e2e/css
         run: |
-          yarn @bud test integration --verbose --maxWorkers 2
+          yarn @bud test run e2e/css --verbose --maxWorkers 2

.vscode/settings.json

@@ -40,5 +40,7 @@
   "prettier.ignorePath": "config/.prettierignore",
   "prettier.prettierPath": ".yarn/sdks/prettier",
   "typescript.tsdk": ".yarn/sdks/typescript",
-  "typescript.enablePromptUseWorkspaceTsdk": true
+  "typescript.enablePromptUseWorkspaceTsdk": true,
+  "spellright.language": ["en"],
+  "spellright.documentTypes": ["markdown", "latex"]
 }

examples/babel/bud.config.cjs

@@ -1,31 +1,27 @@
 module.exports = async app => {
   app
     .entry('app', '*.{js,css}')
+    .template({template: app.path('./public/index.html')})
     .when(app.isProduction, app => {
       app.splitChunks().minimize().runtime('single')
     })
-    .proxy({
-      target: 'http://localhost:8080',
+
+    .babel.setPresets({
+      '@babel/preset-env': require.resolve('@babel/preset-env'),
+    })
+    .setPlugins({
+      '@babel/plugin-transform-runtime': [
+        require.resolve('@babel/plugin-transform-runtime'),
+        {helpers: false},
+      ],
+      '@babel/plugin-proposal-object-rest-spread': require.resolve(
+        '@babel/plugin-proposal-object-rest-spread',
+      ),
+      '@babel/plugin-syntax-dynamic-import': require.resolve(
+        '@babel/plugin-syntax-dynamic-import',
+      ),
+      '@babel/plugin-proposal-class-properties': require.resolve(
+        '@babel/plugin-proposal-class-properties',
+      ),
     })
-    .tap(({babel}) =>
-      babel
-        .setPresets({
-          '@babel/preset-env': require.resolve('@babel/preset-env'),
-        })
-        .setPlugins({
-          '@babel/plugin-transform-runtime': [
-            require.resolve('@babel/plugin-transform-runtime'),
-            {helpers: false},
-          ],
-          '@babel/plugin-proposal-object-rest-spread': require.resolve(
-            '@babel/plugin-proposal-object-rest-spread',
-          ),
-          '@babel/plugin-syntax-dynamic-import': require.resolve(
-            '@babel/plugin-syntax-dynamic-import',
-          ),
-          '@babel/plugin-proposal-class-properties': require.resolve(
-            '@babel/plugin-proposal-class-properties',
-          ),
-        }),
-    )
 }

examples/babel/package.json

@@ -6,6 +6,7 @@
   ],
   "devDependencies": {
     "@roots/bud": "latest",
-    "@roots/bud-babel": "latest"
+    "@roots/bud-babel": "latest",
+    "@roots/bud-postcss": "latest"
   }
 }

examples/babel/public/index.html

@@ -3,14 +3,9 @@
   <head>
     <meta charset="utf-8" />
     <title>Webpack App</title>
-    <meta
-      name="viewport"
-      content="width=device-width,initial-scale=1"
-    />
-    <script defer src="/app.js"></script>
+    <meta name="viewport" content="width=device-width,initial-scale=1" />
   </head>
   <body>
-    <a href="http://localhost:8080">some link</a>
-    <div class="target"></div>
+    <div class="app"></div>
   </body>
 </html>

examples/babel/src/app.js

@@ -1,8 +1,3 @@
-import './demo'
+document.querySelector('.app')?.classList.add('init')
 
-/**
- * Accept module updates
- *
- * @see https://webpack.js.org/api/hot-module-replacement
- */
-import.meta.webpackHot.accept(console.error)
+module?.hot?.accept()

examples/basic/src/index.js

@@ -1,2 +1,5 @@
-console.log('hello')
-console.log('world')
+import './styles.css'
+
+document.querySelector('body')?.classList.add('init')
+
+module?.hot?.accept()

examples/basic/src/styles.css

@@ -0,0 +1,3 @@
+body {
+  background-color: white;
+}

package.json

@@ -9,17 +9,17 @@
   },
   "license": "MIT",
   "engines": {
-    "node": "^16.15.0"
+    "node": "16.15.1"
   },
   "volta": {
     "node": "16.15.1",
-    "yarn": "1.22.19"
+    "yarn": "1.22.19",
+    "npm": "8.13.2"
   },
   "workspaces": {
     "packages": [
       "sources/@roots/*",
       "sources/@repo/*",
-      "workbench/**",
       "tests/util/project"
     ]
   },
@@ -28,6 +28,7 @@
     "@swc/core": "1.2.210",
     "@swc/jest": "0.2.21",
     "@types/express": "4.17.13",
+    "@types/fs-extra": "9.0.13",
     "@types/jest": "28.1.2",
     "@types/lodash-es": "4.17.6",
     "@types/node": "16.11.41",
@@ -39,10 +40,13 @@
     "eslint-plugin-react-hooks": "4.6.0",
     "eslint-plugin-simple-import-sort": "7.0.0",
     "eslint-plugin-tsdoc": "0.2.16",
+    "execa": "6.1.0",
+    "fs-extra": "10.1.0",
     "import-meta-resolve": "2.0.3",
     "jest": "28.1.1",
     "json5": "2.2.1",
     "lodash-es": "4.17.21",
+    "playwright": "1.23.2",
     "prettier": "2.6.2",
     "syncpack": "8.0.0",
     "ts-node": "10.8.1",

sources/@repo/constants/index.js

@@ -75,7 +75,7 @@ export const paths = {
   config: join(REPO_PATH, 'config'),
   sources: join(REPO_PATH, 'sources'),
   tests: join(REPO_PATH, 'tests'),
-  mocks: join(REPO_PATH, './storage/mocks'),
+  mocks: join(REPO_PATH, 'storage/mocks'),
 }
 
 let projectConfig

sources/@repo/docs/config/docusaurus.theme.cjs

@@ -9,7 +9,7 @@ const config = require('../../../../config/monorepo.config.cjs')
  */
 const announcementBar = {
   id: 'announcementBar-4', // Increment on change
-  content: `🚀 SWC support and more in v6.2.0. <a href="/blog/tags/v-6">Release notes available here</a>`,
+  content: `🚀 SWC support and more in v6.3.0. <a href="/blog/tags/v-6">Release notes for v6.x.x releases available here</a>`,
 }
 
 /**