CI failures

Author: adamziel

packages/docs/site/playwright.config.ts

@@ -1,8 +1,35 @@
 import { defineConfig } from '@playwright/test';
+import fs from 'fs';
+import path from 'path';
 
 const port = process.env.DOCS_E2E_PORT ?? '4173';
 const host = process.env.DOCS_E2E_HOST ?? '127.0.0.1';
 const baseUrl = process.env.DOCS_E2E_BASE_URL ?? `http://${host}:${port}`;
+const rawBasePath = process.env.DOCS_E2E_BASE_PATH ?? '/wordpress-playground';
+const normalizedBasePath =
+	rawBasePath === '/' ? '/' : `/${rawBasePath.replace(/^\/|\/$/g, '')}`;
+const healthPath =
+	process.env.DOCS_E2E_HEALTH_PATH ?? `${normalizedBasePath}/index.html`;
+const repoRoot =
+	process.env.DOCS_E2E_REPO_ROOT ?? path.resolve(__dirname, '../../..');
+const buildDir =
+	process.env.DOCS_E2E_BUILD_DIR ?? path.join(repoRoot, 'dist/docs/build');
+
+const mountDir =
+	normalizedBasePath === '/'
+		? null
+		: path.join(buildDir, normalizedBasePath.replace(/^\//, ''));
+
+if (mountDir && fs.existsSync(buildDir) && !fs.existsSync(mountDir)) {
+	try {
+		fs.symlinkSync(buildDir, mountDir, 'junction');
+	} catch (error) {
+		console.warn(
+			`docs-site e2e: failed to create symlink for base path ${normalizedBasePath}`,
+			error
+		);
+	}
+}
 
 export default defineConfig({
 	testDir: './tests',
@@ -17,8 +44,8 @@ export default defineConfig({
 		video: 'retain-on-failure',
 	},
 	webServer: {
-		command: `npx http-server dist/docs/build -p ${port} -c-1`,
-		url: `${baseUrl}/wordpress-playground/`,
+		command: `npx http-server "${buildDir}" -p ${port} -a ${host} -c-1`,
+		url: `${baseUrl}${healthPath}`,
 		reuseExistingServer: !process.env.CI,
 		timeout: 120_000,
 	},

packages/docs/site/plugins/docusaurus-dedupe-aliases.js

@@ -1,4 +1,5 @@
 const fs = require('fs');
+const path = require('path');
 const moduleRequire = require('module').createRequire(__dirname);
 
 const PACKAGES_TO_DEDUPE = [
@@ -41,19 +42,45 @@ function normalizeSubpath(pkgName, subpath) {
 	return `${pkgName}/${subpath.replace(/^\.\//, '')}`;
 }
 
-function buildAliasesForPackage(pkgName) {
-	let pkgJsonPath;
+function resolvePackageMetadata(pkgName) {
+	let entryPoint;
 	try {
-		pkgJsonPath = moduleRequire.resolve(`${pkgName}/package.json`);
+		entryPoint = moduleRequire.resolve(pkgName);
 	} catch (error) {
 		console.warn(
-			`docusaurus-dedupe-aliases: unable to resolve ${pkgName}`,
+			`docusaurus-dedupe-aliases: unable to resolve entry for ${pkgName}`,
 			error
 		);
+		return null;
+	}
+
+	let currentDir = path.dirname(entryPoint);
+	const fsRoot = path.parse(currentDir).root;
+
+	while (currentDir && currentDir !== fsRoot) {
+		const candidate = path.join(currentDir, 'package.json');
+		if (fs.existsSync(candidate)) {
+			const pkgJson = JSON.parse(fs.readFileSync(candidate, 'utf8'));
+			if (pkgJson?.name === pkgName) {
+				return { pkgJson, pkgRoot: currentDir };
+			}
+		}
+		currentDir = path.dirname(currentDir);
+	}
+
+	console.warn(
+		`docusaurus-dedupe-aliases: could not locate package.json for ${pkgName}`
+	);
+	return null;
+}
+
+function buildAliasesForPackage(pkgName) {
+	const metadata = resolvePackageMetadata(pkgName);
+	if (!metadata) {
 		return [];
 	}
 
-	const pkgJson = JSON.parse(fs.readFileSync(pkgJsonPath, 'utf8'));
+	const { pkgJson, pkgRoot } = metadata;
 	const exportKeys = getExportKeys(pkgJson.exports);
 
 	return exportKeys.flatMap((subpath) => {
@@ -64,6 +91,21 @@ function buildAliasesForPackage(pkgName) {
 				subpath === '.' ? `${pkgName}$` : specifier.replace(/\\/g, '/');
 			return [[aliasKey, target]];
 		} catch (error) {
+			const aliasKey =
+				subpath === '.' ? `${pkgName}$` : specifier.replace(/\\/g, '/');
+			const fallbackTarget =
+				subpath === '.'
+					? path.join(pkgRoot, pkgJson.main ?? 'index.js')
+					: path.join(pkgRoot, subpath.replace(/^\.\//, ''));
+
+			if (fs.existsSync(fallbackTarget)) {
+				console.warn(
+					`docusaurus-dedupe-aliases: resolved ${specifier} via fallback path ${fallbackTarget} due to`,
+					error.message
+				);
+				return [[aliasKey, fallbackTarget]];
+			}
+
 			console.warn(
 				`docusaurus-dedupe-aliases: unable to resolve specifier ${specifier}`,
 				error

packages/docs/site/tests/api-reference.spec.ts

@@ -1,5 +1,12 @@
 import { test, expect } from '@playwright/test';
 
+const rawBasePath = process.env.DOCS_E2E_BASE_PATH ?? '/wordpress-playground';
+const normalizedBasePath =
+	rawBasePath === '/' ? '/' : `/${rawBasePath.replace(/^\/|\/$/g, '')}`;
+const apiPath =
+	process.env.DOCS_E2E_API_PATH ??
+	`${normalizedBasePath === '/' ? '' : normalizedBasePath}/api`;
+
 test.describe('Docs API reference', () => {
 	test('loads without runtime errors', async ({ page }) => {
 		const pageErrors: Error[] = [];
@@ -20,7 +27,7 @@ test.describe('Docs API reference', () => {
 			}
 		});
 
-		await page.goto('/wordpress-playground/api', {
+		await page.goto(apiPath, {
 			waitUntil: 'networkidle',
 		});
 		await expect(page.locator('.apiPage')).toBeVisible();