[Blueprints] Move blueprints.phar to the Blueprints package (#2471)

## Motivation for the change, related issues

Moves the `blueprints.phar` file from the Playground CLI package into
the `@wp-playground/blueprints` package to enable in-browser usage.

## Implementation details

Exposes the `blueprints.phar` binary using a dynamic import that fetches
a `.js` file with an inlined version of the base64 binary.

In addition, this PR adds a `vite-global-extensions.ts` file with
plugins applied in all vite config files across the entire Playground
repository.

Base64 encoding adds decoding time and increases the file size by ~30%.
This isnot ideal, but there's no other standard solution for shipping
static files with isomorphic npm CJS+ESM packages so this will have to
do until a better solution emerges.

Some other packages in this repository are published with lines such as
`await import('php.wasm')` and rely on bundler configuration for correct
handling. This is fine as they're fairly low-level, isomorphic,
multi-purpose packages. `@wp-playground/blueprints`, however, is a
higher-level package that's already consumed by projects without special
configuration for importing non-JS files. We don't want to break them.

## Testing Instructions (or ideally a Blueprint)

Confirm the CI checks are green. This PR only moves code around and does
not change any features.

Author: adamziel

packages/meta/src/node-es-module-loader/loader.mts

@@ -117,7 +117,7 @@ export async function resolve(
 	}
 
 	const specifierUrl = new URL(specifier, 'file://');
-	for (const format of ['raw', 'json', 'url']) {
+	for (const format of ['raw', 'json', 'url', 'base64']) {
 		if (specifierUrl.searchParams.has(format)) {
 			// This is a custom format import and can be handled by our custom loader.
 			return {
@@ -189,6 +189,19 @@ export async function load(
 		};
 	}
 
+	if (context.format === 'base64' || urlObj.searchParams.has('base64')) {
+		// Load binary file content and export as base64 string
+		const content = readFileSync(urlObj.pathname);
+		const base64 = content.toString('base64');
+		return {
+			format: 'module',
+			shortCircuit: true,
+			source: `export default Uint8Array.from(atob(${JSON.stringify(
+				base64
+			)}), c => c.charCodeAt(0));`,
+		};
+	}
+
 	if (context.format === 'json' || urlObj.pathname.endsWith('.json')) {
 		const source = readFileSync(urlObj.pathname, 'utf8');
 		return {

packages/nx-extensions/vite.config.ts

@@ -1,11 +1,13 @@
 /// <reference types="vitest" />
 import { defineConfig } from 'vite';
 import { nxViteTsPaths } from '@nx/vite/plugins/nx-tsconfig-paths.plugin';
+// eslint-disable-next-line @nx/enforce-module-boundaries
+import viteGlobalExtensions from '../vite-extensions/vite-global-extensions';
 
 export default defineConfig({
 	cacheDir: '../../../node_modules/.vite/nx-extensions',
 
-	plugins: [nxViteTsPaths()],
+	plugins: [nxViteTsPaths(), ...viteGlobalExtensions],
 
 	test: {
 		globals: true,

packages/php-wasm/cli/vite.config.ts

@@ -1,12 +1,14 @@
 /// <reference types="vitest" />
 import { defineConfig } from 'vite';
 import { nxViteTsPaths } from '@nx/vite/plugins/nx-tsconfig-paths.plugin';
+// eslint-disable-next-line @nx/enforce-module-boundaries
+import viteGlobalExtensions from '../../vite-extensions/vite-global-extensions';
 
 export default defineConfig({
 	assetsInclude: ['**/*.ini'],
 	cacheDir: '../../../node_modules/.vite/php-cli',
 
-	plugins: [nxViteTsPaths()],
+	plugins: [nxViteTsPaths(), ...viteGlobalExtensions],
 
 	// Configuration for building your library.
 	// See: https://vitejs.dev/guide/build.html#library-mode

packages/php-wasm/fs-journal/vite.config.ts

@@ -8,6 +8,8 @@ import { join } from 'path';
 import { viteTsConfigPaths } from '../../vite-extensions/vite-ts-config-paths';
 // eslint-disable-next-line @nx/enforce-module-boundaries
 import { getExternalModules } from '../../vite-extensions/vite-external-modules';
+// eslint-disable-next-line @nx/enforce-module-boundaries
+import viteGlobalExtensions from '../../vite-extensions/vite-global-extensions';
 
 export default defineConfig({
 	cacheDir: '../../../node_modules/.vite/php-wasm-fs-journal',
@@ -22,6 +24,8 @@ export default defineConfig({
 		viteTsConfigPaths({
 			root: '../../../',
 		}),
+
+		...viteGlobalExtensions,
 	],
 
 	// Configuration for building your library.

packages/php-wasm/logger/vite.config.ts

@@ -8,6 +8,8 @@ import { join } from 'path';
 import { viteTsConfigPaths } from '../../vite-extensions/vite-ts-config-paths';
 // eslint-disable-next-line @nx/enforce-module-boundaries
 import { getExternalModules } from '../../vite-extensions/vite-external-modules';
+// eslint-disable-next-line @nx/enforce-module-boundaries
+import viteGlobalExtensions from '../../vite-extensions/vite-global-extensions';
 
 export default defineConfig({
 	cacheDir: '../../../node_modules/.vite/php-wasm-logger',
@@ -22,6 +24,8 @@ export default defineConfig({
 		viteTsConfigPaths({
 			root: '../../../',
 		}),
+
+		...viteGlobalExtensions,
 	],
 
 	// Configuration for building your library.

packages/php-wasm/node-polyfills/vite.config.ts

@@ -5,6 +5,8 @@ import dts from 'vite-plugin-dts';
 import viteTsConfigPaths from 'vite-tsconfig-paths';
 // eslint-disable-next-line @nx/enforce-module-boundaries
 import { getExternalModules } from '../../vite-extensions/vite-external-modules';
+// eslint-disable-next-line @nx/enforce-module-boundaries
+import viteGlobalExtensions from '../../vite-extensions/vite-global-extensions';
 
 export default defineConfig({
 	cacheDir: '../../../node_modules/.vite/php-wasm-node-polyfills',
@@ -18,6 +20,8 @@ export default defineConfig({
 			tsconfigPath: join(__dirname, 'tsconfig.lib.json'),
 			pathsToAliases: false,
 		}),
+
+		...viteGlobalExtensions,
 	],
 
 	// Uncomment this if you are using workers.

packages/php-wasm/node/vite.config.ts

@@ -9,6 +9,8 @@ import path from 'path';
 import type { Plugin } from 'vite';
 // eslint-disable-next-line @nx/enforce-module-boundaries
 import { getExternalModules } from '../../vite-extensions/vite-external-modules';
+// eslint-disable-next-line @nx/enforce-module-boundaries
+import viteGlobalExtensions from '../../vite-extensions/vite-global-extensions';
 
 export default defineConfig(function () {
 	return {
@@ -52,6 +54,8 @@ export default defineConfig(function () {
 					return null;
 				},
 			} as Plugin,
+
+			...viteGlobalExtensions,
 		],
 
 		// Configuration for building your library.

packages/php-wasm/progress/vite.config.ts

@@ -8,6 +8,8 @@ import { join } from 'path';
 import { viteTsConfigPaths } from '../../vite-extensions/vite-ts-config-paths';
 // eslint-disable-next-line @nx/enforce-module-boundaries
 import { getExternalModules } from '../../vite-extensions/vite-external-modules';
+// eslint-disable-next-line @nx/enforce-module-boundaries
+import viteGlobalExtensions from '../../vite-extensions/vite-global-extensions';
 
 export default defineConfig({
 	cacheDir: '../../../node_modules/.vite/php-wasm-progress',
@@ -22,6 +24,8 @@ export default defineConfig({
 		viteTsConfigPaths({
 			root: '../../../',
 		}),
+
+		...viteGlobalExtensions,
 	],
 
 	// Uncomment this if you are using workers.

packages/php-wasm/scopes/vite.config.ts

@@ -8,6 +8,8 @@ import { join } from 'path';
 import { viteTsConfigPaths } from '../../vite-extensions/vite-ts-config-paths';
 // eslint-disable-next-line @nx/enforce-module-boundaries
 import { getExternalModules } from '../../vite-extensions/vite-external-modules';
+// eslint-disable-next-line @nx/enforce-module-boundaries
+import viteGlobalExtensions from '../../vite-extensions/vite-global-extensions';
 
 export default defineConfig({
 	cacheDir: '../../../node_modules/.vite/php-wasm-scope',
@@ -22,6 +24,8 @@ export default defineConfig({
 		viteTsConfigPaths({
 			root: '../../../',
 		}),
+
+		...viteGlobalExtensions,
 	],
 
 	// Configuration for building your library.

packages/php-wasm/stream-compression/vite.config.ts

@@ -6,6 +6,8 @@ import * as path from 'path';
 import { viteTsConfigPaths } from '../../vite-extensions/vite-ts-config-paths';
 // eslint-disable-next-line @nx/enforce-module-boundaries
 import { getExternalModules } from '../../vite-extensions/vite-external-modules';
+// eslint-disable-next-line @nx/enforce-module-boundaries
+import viteGlobalExtensions from '../../vite-extensions/vite-global-extensions';
 
 export default defineConfig({
 	cacheDir: '../../../node_modules/.vite/php-wasm-stream-compression',
@@ -19,6 +21,8 @@ export default defineConfig({
 		viteTsConfigPaths({
 			root: '../../../',
 		}),
+
+		...viteGlobalExtensions,
 	],
 
 	// Uncomment this if you are using workers.