refactor(build): [SITE-BUILD-01] stage outputs and stabilize documentation builds

test/build-docs.test.js

@@ -9,23 +9,50 @@ import { fileURLToPath } from 'node:url'
 
 const root = fileURLToPath(new URL('../', import.meta.url))
 
-test('documentation build forwards child failure and success exit codes', () => {
+test('documentation build uses pinned Yarn, forwards exit codes and retains old output until success', () => {
+  assert(process.env.npm_execpath, 'Run this test through Yarn')
   const cache = path.join(root, 'refactor/.cache')
   fs.mkdirSync(cache, { recursive: true })
   const fixture = fs.mkdtempSync(path.join(cache, 'docs-exit-'))
   try {
     const pkg = path.join(fixture, 'packages/artplayer-vitepress')
     fs.mkdirSync(pkg, { recursive: true })
+    const output = path.join(fixture, 'docs/document')
+    fs.mkdirSync(output, { recursive: true })
+    fs.writeFileSync(path.join(output, 'index.html'), 'Old site')
+    fs.writeFileSync(
+      path.join(pkg, 'fixture.cjs'),
+      `
+const fs = require('node:fs'); const path = require('node:path');
+if (!process.env.npm_config_user_agent.startsWith('yarn/1.22.22')) process.exit(91);
+const outDir = process.argv[process.argv.indexOf('--outDir') + 1];
+fs.mkdirSync(outDir, { recursive: true });
+fs.writeFileSync(path.join(outDir, 'index.html'), 'New site');
+process.exit(Number(process.env.DOCS_TEST_EXIT));
+`,
+    )
     for (const code of [23, 0]) {
-      fs.writeFileSync(path.join(pkg, 'package.json'), JSON.stringify({
-        private: true,
-        scripts: { build: `node -e "process.exit(${code})"` },
-      }))
-      const result = spawnSync(process.execPath, [path.join(root, 'scripts/build-docs.js')], {
-        cwd: fixture,
-        encoding: 'utf8',
-      })
+      fs.writeFileSync(
+        path.join(pkg, 'package.json'),
+        JSON.stringify({
+          private: true,
+          scripts: { build: 'node fixture.cjs' },
+        }),
+      )
+      const result = spawnSync(
+        process.execPath,
+        [path.join(root, 'scripts/build-docs.js')],
+        {
+          cwd: fixture,
+          encoding: 'utf8',
+          env: { ...process.env, DOCS_TEST_EXIT: String(code) },
+        },
+      )
       assert.equal(result.status, code, result.stderr)
+      assert.equal(
+        fs.readFileSync(path.join(output, 'index.html'), 'utf8'),
+        code ? 'Old site' : 'New site',
+      )
     }
   }
   finally {