chore: attempt to get netlify build to work via cache-busting (#77)

* chore: attempt to get netlify build to work via cache-busting

* chore: fix lockfile in docs

- format TOML with Prettier

* chore(netlify): add some comments to config

* chore(scripts): eliminate extra npm build call

* chore(scripts): do not build docs in parallel

lint-staged.config.js

@@ -2,7 +2,7 @@
 
 module.exports = {
   '*.js': ['eslint --fix'],
-  '*.{yml,md,mdx}': ['prettier --write'],
+  '*.{yml,md,mdx,toml}': ['prettier --write'],
   'packages/*/package.json': ['syncpack format'],
   './README.md': [
     'sync-monorepo-packages --no-package-json -p packages/report-toolkit --force README.md'

netlify.toml

@@ -1,3 +1,12 @@
 [build]
-  publish = "packages/docs/public"
-  command = "npm run build:docs:netlify"
+publish = "packages/docs/public"
+# 1. bust the node_modules cache
+# 2. run `npm ci` (which calls `lerna-bootstrap`)
+# 3. build gatsby for production (without `--prefix-paths`)
+command = """
+  rm -rf $NETLIFY_CACHE_DIR/node_modules && \
+  npm ci && \
+  npm run build:docs:netlify \
+  """
+# this, I think, tells netlify's built-in `npm install` to do nothing
+environment = { NPM_FLAGS = "--dry-run" }

package.json

@@ -31,8 +31,8 @@
     "build": "concurrently npm:build:dist npm:build:declarations",
     "build:declarations": "tsc -p tsconfig.declarations.json",
     "build:dist": "rollup -c",
-    "build:docs": "npm run build && concurrently npm:build:docs:cli-output npm:build:docs:api && npm run build:docs:site",
-    "build:docs:netlify": "npm run build && concurrently npm:build:docs:cli-output npm:build:docs:api && npm run build:docs:site:netlify",
+    "build:docs": "npm run build:docs:api && npm run build:docs:cli-output && npm run build:docs:site",
+    "build:docs:netlify": "npm run build:docs:api && npm run build:docs:cli-output && npm run build:docs:site:netlify",
     "build:docs:api": "typedoc --tsconfig tsconfig.docs.json --plugin typedoc-plugin-markdown,@boneskull/typedoc-plugin-external-module-name",
     "build:docs:cli-output": "node scripts/build-cli-output.js",
     "build:docs:site": "lerna run --stream --scope @report-toolkit/docs build",
@@ -107,6 +107,7 @@
     "module-alias": "^2.2.2",
     "nyc": "^15.0.0",
     "prettier": "^1.19.1",
+    "prettier-plugin-toml": "^0.3.1",
     "proxyquire": "^2.1.3",
     "readdir-withfiletypes": "^1.0.2",
     "replace-in-files-cli": "^0.3.1",