Skip to content

🎥 Make videos programmatically with React

4.7 KB
Raw Blame
import {spawn} from 'child_process';
import {defaultDocsBuildConcurrency} from './build-concurrency';

const isVercel = process.env.VERCEL === '1' || process.env.VERCEL === 'true';
const lowMemoryBuild =
	isVercel || process.env.REMOTION_DOCS_LOW_MEMORY_BUILD === '1';
const heartbeatIntervalMs = process.env.REMOTION_DOCS_BUILD_HEARTBEAT_MS
	? parseInt(process.env.REMOTION_DOCS_BUILD_HEARTBEAT_MS, 10)
	: isVercel
		? 60_000
		: 0;

const formatDuration = (ms: number) => {
	const seconds = ms / 1000;
	if (seconds < 60) {
		return `${seconds.toFixed(1)}s`;
	}

	const minutes = Math.floor(seconds / 60);
	const remainingSeconds = Math.floor(seconds % 60)
		.toString()
		.padStart(2, '0');
	return `${minutes}m ${remainingSeconds}s`;
};

const appendNodeOption = (value: string) => {
	const current = process.env.NODE_OPTIONS ?? '';
	if (current.includes('--max-old-space-size=')) {
		return current;
	}

	return [current, value].filter(Boolean).join(' ');
};

const nodeOldSpaceSize = process.env.REMOTION_DOCS_NODE_OLD_SPACE_MB
	? parseInt(process.env.REMOTION_DOCS_NODE_OLD_SPACE_MB, 10)
	: lowMemoryBuild
		? 3072
		: 4096;

const run = (
	label: string,
	command: string,
	args: string[],
	env: Record<string, string | undefined> = {},
) =>
	new Promise<void>((resolve, reject) => {
		const start = performance.now();
		console.log(`[docs build] Starting ${label}...`);
		const child = spawn(command, args, {
			env: {
				...process.env,
				// Rspack, SWC and Lightning CSS use Rayon for native parallel work.
				...(!isVercel
					? {
							RAYON_NUM_THREADS:
								process.env.RAYON_NUM_THREADS ??
								String(defaultDocsBuildConcurrency),
						}
					: null),
				...env,
			},
			shell: false,
			stdio: 'inherit',
		});
		const heartbeat =
			heartbeatIntervalMs > 0 && Number.isFinite(heartbeatIntervalMs)
				? setInterval(() => {
						console.log(
							`[docs build] Still running ${label} after ${formatDuration(
								performance.now() - start,
							)}...`,
						);
					}, heartbeatIntervalMs)
				: null;
		heartbeat?.unref();

		const clearHeartbeat = () => {
			if (heartbeat) {
				clearInterval(heartbeat);
			}
		};

		child.on('close', (code, signal) => {
			clearHeartbeat();
			if (code === 0) {
				console.log(
					`[docs build] Finished ${label} in ${formatDuration(
						performance.now() - start,
					)}.`,
				);
				resolve();
			} else {
				reject(
					new Error(
						`${label} (${command} ${args.join(' ')}) exited with code ${code}, signal ${signal}`,
					),
				);
			}
		});

		child.on('error', (err) => {
			clearHeartbeat();
			reject(err);
		});
	});

const docusaurusEnv = {
	DOCUSAURUS_IGNORE_SSG_WARNINGS: 'true',
	DOCUSAURUS_NO_PERSISTENT_CACHE: lowMemoryBuild ? 'true' : undefined,
	DOCUSAURUS_PERF_LOGGER:
		process.env.DOCUSAURUS_PERF_LOGGER ?? (isVercel ? 'true' : undefined),
	NODE_OPTIONS: appendNodeOption(`--max-old-space-size=${nodeOldSpaceSize}`),
	DOCUSAURUS_SSG_WORKER_THREAD_COUNT:
		process.env.DOCUSAURUS_SSG_WORKER_THREAD_COUNT ??
		String(lowMemoryBuild ? 1 : defaultDocsBuildConcurrency),
	...(lowMemoryBuild
		? {
				DOCUSAURUS_SSG_WORKER_THREAD_RECYCLER_MAX_MEMORY:
					process.env.DOCUSAURUS_SSG_WORKER_THREAD_RECYCLER_MAX_MEMORY ??
					String(512 * 1024 * 1024),
				DOCUSAURUS_SSG_WORKER_THREAD_TASK_SIZE:
					process.env.DOCUSAURUS_SSG_WORKER_THREAD_TASK_SIZE ?? '1',
				DOCUSAURUS_SSR_CONCURRENCY:
					process.env.DOCUSAURUS_SSR_CONCURRENCY ?? '2',
			}
		: null),
};

const twoslashEnv = lowMemoryBuild
	? {
			TWOSLASH_WORKER_COUNT: process.env.TWOSLASH_WORKER_COUNT ?? '2',
			TWOSLASH_RECYCLE_LIMIT_BYTES:
				process.env.TWOSLASH_RECYCLE_LIMIT_BYTES ?? String(1024 * 1024 * 1024),
		}
	: {};
const docusaurusBuild = lowMemoryBuild
	? {
			command: 'node',
			args: ['build-docusaurus-low-memory.cjs'],
		}
	: {
			command: 'bunx',
			args: ['docusaurus', 'build'],
		};

await run('generate option docs', 'bun', ['generate-option-docs.ts']);
await run('copy raw docs', 'bun', ['copy-raw-docs.ts']);
await run('fetch prompt submissions', 'bun', ['fetch-prompt-submissions.ts']);
await run('prepare Browser Studio workspace', 'bun', [
	'prepare-browser-studio-workspace.ts',
]);
await run('prewarm twoslash', 'bun', ['prewarm-twoslash.ts'], twoslashEnv);
await run(
	'Docusaurus build',
	docusaurusBuild.command,
	docusaurusBuild.args,
	docusaurusEnv,
);
await run('validate generated JavaScript', 'bun', [
	'validate-built-javascript.ts',
]);
await run('build standalone Browser Studio', 'bun', [
	'build-browser-studio-standalone.ts',
]);
await run('copy convert assets', 'bun', ['copy-convert.ts']);
await run('copy Vibe Code editor', 'bun', ['copy-experimental-sdk.ts']);
await run('generate asset manifest', 'bun', ['generate-asset-manifest.ts']);
await run('count generated pages', 'bun', ['count-pages.ts']);