@janga/norna 0.7.22 → 0.7.24

package/scripts/build-site.mjs

@@ -14,3 +14,4 @@ await runScript('scripts/sync-content-sections.mjs', ['--check']);
 await runScript('scripts/sync-site-public.mjs');
 await runScript('scripts/generate-images.mjs');
 await runAstroInherit(['build']);
+await runScript('scripts/generate-search-index.mjs');

package/scripts/check-config.mjs

@@ -1,9 +1,12 @@
-import { siteConfigLabel, sitePublicLabel, siteThemeLabel } from './lib/site-paths.mjs';
+import path from 'node:path';
+import { siteConfigLabel, sitePagesDir, sitePublicLabel, siteThemeLabel } from './lib/site-paths.mjs';
 import { getLogoAssets, getPublicAssetInspection } from './lib/logo-assets.mjs';
-import { logoAssetFilenames } from './lib/public-asset-conventions.mjs';
+import { logoAssetFilenames, socialImageAssetFilenames } from './lib/public-asset-conventions.mjs';
+import { getSocialImageAssets } from './lib/social-image-assets.mjs';
 import { readSitewideContent } from './lib/sitewide-content.mjs';
 import { assertSectionBackgroundPatternCompatibility } from './lib/presentation.mjs';
 import { readThemeConfig, validatePageThemeFiles } from './lib/theme-config.mjs';
+import { mergePageThemeConfig } from './lib/theme-presets.mjs';
 
 const formatErrorMessage = (error) => {
 	if (error instanceof Error) {
@@ -14,10 +17,26 @@ const formatErrorMessage = (error) => {
 };
 
 try {
-	const { projectConfig } = await import('./lib/project-config.mjs');
+	const { projectConfig, resolveThemeVisualConfig } = await import('./lib/project-config.mjs');
 	const themeConfig = await readThemeConfig();
 	const sitewideContent = await readSitewideContent();
 	const pageThemeFiles = await validatePageThemeFiles();
+	const pageThemesByDirectory = new Map(pageThemeFiles.map((file) => [path.dirname(file.path), file]));
+	for (const pageThemeFile of pageThemeFiles) {
+		const ancestorThemes = [];
+		let directory = path.dirname(pageThemeFile.path);
+		while (directory.startsWith(`${sitePagesDir}${path.sep}`)) {
+			const ancestorTheme = pageThemesByDirectory.get(directory);
+			if (ancestorTheme) ancestorThemes.unshift(ancestorTheme);
+			directory = path.dirname(directory);
+		}
+
+		const resolvedPageTheme = ancestorThemes.reduce(
+			(current, ancestor) => mergePageThemeConfig(current, ancestor.config),
+			themeConfig,
+		);
+		resolveThemeVisualConfig(resolvedPageTheme, pageThemeFile.label);
+	}
 	if (projectConfig.navigation.mode === 'tree') {
 		assertSectionBackgroundPatternCompatibility(themeConfig, siteThemeLabel, 'tree');
 		for (const pageThemeFile of pageThemeFiles) {
@@ -25,6 +44,7 @@ try {
 		}
 	}
 	const logoAssets = getLogoAssets();
+	const socialImageAssets = getSocialImageAssets();
 	const publicAssetInspection = getPublicAssetInspection();
 	const logoAssetPaths = logoAssetFilenames.map((filename) => `${sitePublicLabel}/${filename}`);
 	for (const issue of publicAssetInspection.suspicious) {
@@ -38,6 +58,13 @@ try {
 		].join('\n'));
 	}
 
+	if (socialImageAssets.length > 1) {
+		throw new Error([
+			`Found multiple social sharing images in ${sitePublicLabel}. Keep exactly one of ${socialImageAssetFilenames.join(', ')}.`,
+			...socialImageAssets.map(({ filename }) => `- ${sitePublicLabel}/${filename}`),
+		].join('\n'));
+	}
+
 	if (logoAssets.length === 0) {
 		if (sitewideContent.logo) {
 			throw new Error(`Site-wide logo is configured, but no logo file was found. Add exactly one of ${logoAssetPaths.join(', ')}, or remove logo.`);
@@ -49,18 +76,22 @@ try {
 	console.log('Config check passed.');
 	console.log(`Site URL: ${projectConfig.site.url}`);
 	console.log(`Base path: ${projectConfig.site.basePath}`);
+	console.log(`Edit links: ${projectConfig.editLink?.baseUrl ?? '(disabled)'}`);
 	console.log(`Theme preset: ${themeConfig.preset ?? '(none)'}`);
 	console.log(`Page width: ${projectConfig.layout.pageWidth}`);
 	console.log(`Gutter: desktop ${projectConfig.layout.gutter.desktop}, mobile ${projectConfig.layout.gutter.mobile}`);
 	console.log(`Content spacing: ${projectConfig.layout.contentSpacing}`);
 	console.log(`Text width: ${projectConfig.layout.textWidth}`);
+	console.log(`Image presentation: ${projectConfig.images.presentation}`);
 	console.log(`Image area width: ${projectConfig.images.width}`);
 	console.log(`Image max available width: desktop ${projectConfig.images.maxAvailableWidthPercent.desktop}%, mobile ${projectConfig.images.maxAvailableWidthPercent.mobile}%`);
-	console.log(`Image max available height: desktop ${projectConfig.images.maxAvailableHeightPercent.desktop}%, mobile ${projectConfig.images.maxAvailableHeightPercent.mobile}%`);
+	if (projectConfig.images.maxAvailableHeightPercent) {
+		console.log(`Image max available height: desktop ${projectConfig.images.maxAvailableHeightPercent.desktop}%, mobile ${projectConfig.images.maxAvailableHeightPercent.mobile}%`);
+	}
 	console.log(`Font family: ${projectConfig.typography.fontFamily}`);
 	console.log(`Language: ${projectConfig.locale.lang}`);
 	console.log(`Navigation mode: ${projectConfig.navigation.mode}`);
-	console.log(`Section tracking: ${projectConfig.navigation.sectionTracking ? 'enabled' : 'disabled'}`);
+	console.log(`Static search: ${projectConfig.search.enabled ? 'enabled' : 'disabled'}`);
 	console.log(`Scroll behavior: ${projectConfig.navigation.scrollBehavior}`);
 } catch (error) {
 	console.error('Config check failed.');

package/scripts/deploy-site.mjs

@@ -41,7 +41,6 @@ const allowedExactPaths = new Set([
 	`${sitePublicLabel}/favicon.ico`,
 	`${sitePublicLabel}/favicon.svg`,
 	`${sitePublicLabel}/robots.txt`,
-	`${sitePublicLabel}/sitemap.xml`,
 	'tsconfig.json',
 ]);
 const failedConclusions = new Set(['action_required', 'cancelled', 'failure', 'startup_failure', 'timed_out']);

package/scripts/dev-local.mjs

@@ -1,23 +1,32 @@
-import { execFile, spawn } from 'node:child_process';
+import { execFile } from 'node:child_process';
 import { mkdir, readFile, rm, writeFile } from 'node:fs/promises';
 import net from 'node:net';
 import { networkInterfaces } from 'node:os';
 import path from 'node:path';
 import { promisify } from 'node:util';
 import { getAstroArgs, runAstroInherit } from './lib/astro-command.mjs';
-import projectConfig from './lib/project-config.mjs';
 import { astroCacheDir, engineRoot, siteProjectRoot } from './lib/site-paths.mjs';
 
 const execFileAsync = promisify(execFile);
 
-const port = 4321;
+const port = Number.parseInt(process.env.NORNA_DEV_PORT ?? '4321', 10);
+if (!Number.isInteger(port) || port < 1 || port > 65_535) {
+	throw new Error('NORNA_DEV_PORT must be an integer from 1 through 65535.');
+}
+let projectConfig;
+try {
+	({ default: projectConfig } = await import('./lib/project-config.mjs'));
+} catch (error) {
+	console.error(error instanceof Error ? error.message : String(error));
+	process.exit(1);
+}
 const localHost = '127.0.0.1';
 const localUrl = `http://${localHost}:${port}${projectConfig.site.basePath}`;
 const probeUrls = [
 	localUrl,
 	`http://localhost:${port}${projectConfig.site.basePath}`,
 ];
-const skipOpen = process.env.WALDE_NO_OPEN === '1';
+const skipOpen = process.env.NORNA_NO_OPEN === '1';
 const statePath = path.join(astroCacheDir, 'dev-local.json');
 const logPath = path.join(astroCacheDir, 'dev.log');
 const args = process.argv.slice(2);
@@ -42,19 +51,6 @@ const generateImages = async () => execFileAsync(process.execPath, [path.join(en
 	maxBuffer: 1024 * 1024 * 10,
 });
 
-const getPortPids = async () => {
-	try {
-		const { stdout } = await execFileAsync('lsof', ['-nP', `-iTCP:${port}`, '-sTCP:LISTEN', '-t']);
-		return [...new Set(stdout.trim().split(/\s+/).map(Number).filter(Number.isInteger))];
-	} catch (error) {
-		if (error.code === 1 || error.code === 'ENOENT') {
-			return [];
-		}
-
-		throw error;
-	}
-};
-
 const readState = async () => {
 	try {
 		return JSON.parse(await readFile(statePath, 'utf8'));
@@ -72,10 +68,9 @@ const getLanUrls = () => Object.values(networkInterfaces())
 	.filter((network) => network?.family === 'IPv4' && !network.internal)
 	.map((network) => `http://${network.address}:${port}${projectConfig.site.basePath}`);
 
-const writeState = async (pid, host) => {
+const writeState = async (host) => {
 	await mkdir(path.dirname(statePath), { recursive: true });
 	await writeFile(statePath, `${JSON.stringify({
-		pid,
 		port,
 		host,
 		mode: host === '0.0.0.0' ? 'lan' : 'local',
@@ -88,6 +83,26 @@ const removeState = async () => {
 	await rm(statePath, { force: true });
 };
 
+const readDevLog = async () => {
+	try {
+		return await readFile(logPath, 'utf8');
+	} catch (error) {
+		if (error.code === 'ENOENT') return '';
+		throw error;
+	}
+};
+
+const getLogExcerpt = (source) => {
+	const lines = source.trim().split('\n');
+	if (lines.length === 1 && lines[0] === '') return '';
+
+	const structuredErrorIndex = lines.findLastIndex((line) => /^\[[^\]]*Error\]/u.test(line.trim()));
+	const genericErrorIndex = lines.findLastIndex((line) => /^Error(?::|\s+(?!reference\b))/u.test(line.trim()));
+	const errorIndex = structuredErrorIndex >= 0 ? structuredErrorIndex : genericErrorIndex;
+	const firstLine = errorIndex >= 0 ? errorIndex : Math.max(0, lines.length - 30);
+	return lines.slice(firstLine, firstLine + 30).join('\n');
+};
+
 const isPortFreeOnHost = (loopbackHost) => new Promise((resolve, reject) => {
 	const server = net.createServer();
 
@@ -110,14 +125,36 @@ const isPortFreeOnHost = (loopbackHost) => new Promise((resolve, reject) => {
 	server.listen({ port, host: loopbackHost, ipv6Only: loopbackHost === '::1' });
 });
 
-const isPortFree = async () => {
-	for (const loopbackHost of ['127.0.0.1']) {
-		if (!(await isPortFreeOnHost(loopbackHost))) {
+const isPortListeningOnHost = (host) => new Promise((resolve, reject) => {
+	const socket = net.createConnection({ port, host });
+	let settled = false;
+	const settle = (result) => {
+		if (settled) return;
+		settled = true;
+		socket.destroy();
+		resolve(result);
+	};
+
+	socket.once('connect', () => settle(true));
+	socket.once('error', (error) => {
+		if (['ECONNREFUSED', 'EHOSTUNREACH', 'ENETUNREACH', 'EADDRNOTAVAIL'].includes(error.code)) {
+			settle(false);
+			return;
+		}
+
+		if (!settled) reject(error);
+	});
+	socket.setTimeout(500, () => settle(false));
+});
+
+const isPortFree = async (host = localHost) => {
+	for (const probeHost of ['127.0.0.1', '::1']) {
+		if (await isPortListeningOnHost(probeHost)) {
 			return false;
 		}
 	}
 
-	return true;
+	return isPortFreeOnHost(host);
 };
 
 const sleep = (milliseconds) => new Promise((resolve) => {
@@ -153,12 +190,12 @@ const waitForServer = async () => {
 	throw new Error(`Timed out waiting for ${localUrl}`);
 };
 
-const waitForPidToStopListening = async (pid) => {
+const waitForPortToBeFree = async (host = localHost) => {
 	const startedAt = Date.now();
 	const timeoutMs = 5_000;
 
 	while (Date.now() - startedAt < timeoutMs) {
-		if (!(await getPortPids()).includes(pid)) {
+		if (await isPortFree(host)) {
 			return true;
 		}
 
@@ -168,32 +205,71 @@ const waitForPidToStopListening = async (pid) => {
 	return false;
 };
 
-const killPortPids = async (pids) => {
+const parseWindowsPortPids = (stdout) => [...new Set(
+	stdout
+		.trim()
+		.split(/\r?\n/u)
+		.map((line) => Number.parseInt(line.trim(), 10))
+		.filter(Number.isInteger),
+)];
+
+const getPortPids = async () => {
+	try {
+		if (process.platform === 'win32') {
+			const { stdout } = await execFileAsync('powershell.exe', [
+				'-NoProfile',
+				'-Command',
+				`(Get-NetTCPConnection -LocalPort ${port} -State Listen -ErrorAction SilentlyContinue).OwningProcess`,
+			]);
+			return parseWindowsPortPids(stdout);
+		}
+
+		const { stdout } = await execFileAsync('lsof', [
+			'-nP',
+			`-iTCP:${port}`,
+			'-sTCP:LISTEN',
+			'-t',
+		]);
+		return [...new Set(stdout.trim().split(/\s+/u).map(Number).filter(Number.isInteger))];
+	} catch (error) {
+		if (error.code === 1) return [];
+		if (error.code === 'ENOENT') {
+			const commandName = process.platform === 'win32' ? 'PowerShell' : 'lsof';
+			throw new Error(`Cannot use --kill because ${commandName} is not available. Stop the process on port ${port} manually, then rerun the command.`);
+		}
+
+		throw error;
+	}
+};
+
+const terminatePortProcesses = async (host) => {
+	const pids = await getPortPids();
+	if (pids.length === 0) {
+		throw new Error(`Port ${port} is occupied, but Norna could not identify its listening process. Stop that process manually, then rerun the command.`);
+	}
+
 	for (const pid of pids) {
 		console.log(`Stopping process ${pid} on port ${port}.`);
 		try {
 			process.kill(pid, 'SIGTERM');
 		} catch (error) {
-			if (error.code !== 'ESRCH') {
-				throw error;
-			}
+			if (error.code !== 'ESRCH') throw error;
 		}
 	}
 
-	for (const pid of pids) {
-		if (await waitForPidToStopListening(pid)) {
-			continue;
-		}
+	if (await waitForPortToBeFree(host)) return;
 
+	for (const pid of pids) {
 		console.log(`Process ${pid} did not stop; sending SIGKILL.`);
 		try {
 			process.kill(pid, 'SIGKILL');
 		} catch (error) {
-			if (error.code !== 'ESRCH') {
-				throw error;
-			}
+			if (error.code !== 'ESRCH') throw error;
 		}
-		await waitForPidToStopListening(pid);
+	}
+
+	if (!(await waitForPortToBeFree(host))) {
+		throw new Error(`Port ${port} is still in use after stopping ${pids.join(', ')}.`);
 	}
 };
 
@@ -218,65 +294,49 @@ const openBrowser = async () => {
 
 const stopServer = async ({ quiet = false } = {}) => {
 	const state = await readState();
-
-	await runAstro(['dev', 'stop']).catch(() => {});
-
-	if (!state?.pid) {
-		if (!quiet) {
-			console.log('No dev:local server is tracked.');
-		}
-		return;
-	}
-
-	const listeningPids = await getPortPids();
-
-	if (!listeningPids.includes(state.pid)) {
-		await removeState();
-		if (!quiet) {
-			console.log('No tracked dev:local server is running.');
-		}
-		return;
-	}
-
-	process.kill(state.pid, 'SIGTERM');
-
-	if (!(await waitForPidToStopListening(state.pid))) {
-		process.kill(state.pid, 'SIGKILL');
-		await waitForPidToStopListening(state.pid);
-	}
-
+	const { stdout = '', stderr = '' } = await runAstro(['dev', 'stop']);
+	const stopped = `${stdout}\n${stderr}`.includes('Stopped dev server');
+	if (stopped) await waitForPortToBeFree(state?.host ?? localHost);
 	await removeState();
 
 	if (!quiet) {
-		console.log(`Stopped dev server on ${localUrl}.`);
+		console.log(stopped
+			? `Stopped dev server on ${localUrl}.`
+			: 'No dev server is tracked for this site.');
 	}
 };
 
 const startServer = async ({ host = localHost, open = true, killBlockingPort = false } = {}) => {
 	await stopServer({ quiet: true });
 
-	let existingPids = await getPortPids();
-	if (existingPids.length > 0 || !(await isPortFree())) {
-		if (!killBlockingPort || existingPids.length === 0) {
-			throw new Error(`Port ${port} is already in use. Stop the process using it, then rerun the dev command, or pass --kill.`);
+	if (!(await isPortFree(host))) {
+		if (!killBlockingPort) {
+			throw new Error(`Port ${port} is already in use. Stop the process using it, choose another port with NORNA_DEV_PORT, or rerun the command with --kill.`);
 		}
 
-		await killPortPids(existingPids);
-		await removeState();
-		existingPids = await getPortPids();
-
-		if (existingPids.length > 0 || !(await isPortFree())) {
-			throw new Error(`Port ${port} is still in use after trying to stop ${existingPids.join(', ')}.`);
-		}
+		await terminatePortProcesses(host);
 	}
 
 	await syncSitePublic();
 	await generateImages();
-	await runAstroInherit(['dev', '--background', '--host', host, '--port', String(port)]);
+	const previousLog = await readDevLog();
+	try {
+		await runAstroInherit(['dev', '--background', '--host', host, '--port', String(port)]);
+	} catch (error) {
+		const currentLog = await readDevLog();
+		const newLog = currentLog.startsWith(previousLog)
+			? currentLog.slice(previousLog.length)
+			: currentLog;
+		const excerpt = getLogExcerpt(newLog || currentLog);
+		throw new Error([
+			`Could not start the dev server at ${localUrl}.`,
+			excerpt ? `Astro reported:\n${excerpt}` : 'Astro did not write a detailed startup error.',
+			`Full log: ${logPath}`,
+		].join('\n\n'), { cause: error });
+	}
 	await waitForServer();
 
-	const startedPids = await getPortPids();
-	await writeState(startedPids[0] ?? null, host);
+	await writeState(host);
 	if (open) {
 		await openBrowser();
 	} else {
@@ -295,13 +355,14 @@ const startServer = async ({ host = localHost, open = true, killBlockingPort = f
 
 const showStatus = async () => {
 	const state = await readState();
-	const listeningPids = await getPortPids();
+	const { stdout = '', stderr = '' } = await runAstro(['dev', 'status']);
+	const tracked = `${stdout}\n${stderr}`.includes('Dev server running at');
 	const reachable = await isServerReachable();
 
-	if (state?.pid && listeningPids.includes(state.pid)) {
-		const reachability = reachable ? '' : ' The listener is active, but the URL probe did not respond.';
-		console.log(`dev:${state.mode ?? 'local'} is running at ${localUrl} (pid ${state.pid}).${reachability}`);
-		if (state.host === '0.0.0.0') {
+	if (tracked) {
+		const reachability = reachable ? '' : ' The server is tracked, but the site URL probe did not respond.';
+		console.log(`dev:${state?.mode ?? 'local'} is running at ${localUrl}.${reachability}`);
+		if (state?.host === '0.0.0.0') {
 			const lanUrls = getLanUrls();
 			if (lanUrls.length > 0) console.log(`On this local network: ${lanUrls.join(', ')}`);
 		}
@@ -309,10 +370,7 @@ const showStatus = async () => {
 	}
 
 	if (reachable) {
-		const detail = state?.pid
-			? `the tracked pid ${state.pid} is not listening`
-			: 'no dev:local state file was found';
-		console.log(`A server is responding at ${localUrl}, but ${detail}.`);
+		console.log(`A server is responding at ${localUrl}, but Astro does not track it for this site.`);
 		return;
 	}
 
@@ -325,11 +383,7 @@ const showStatus = async () => {
 
 const showLogs = async () => {
 	if (shouldFollowLogs) {
-		const tail = spawn('tail', ['-n', '80', '-f', logPath], { stdio: 'inherit' });
-		await new Promise((resolve, reject) => {
-			tail.once('exit', resolve);
-			tail.once('error', reject);
-		});
+		await runAstroInherit(['dev', 'logs', '--follow']);
 		return;
 	}
 
@@ -346,23 +400,32 @@ const showLogs = async () => {
 	}
 };
 
-if (command === 'start') {
-	await startServer({ open: !skipOpen, killBlockingPort: shouldKillBlockingPort });
-} else if (command === 'lan') {
-	await startServer({ host: '0.0.0.0', open: !skipOpen, killBlockingPort: shouldKillBlockingPort });
-} else if (command === 'status') {
-	await showStatus();
-} else if (command === 'logs') {
-	await showLogs();
-} else if (command === 'restart') {
-	const state = await readState();
-	await startServer({
-		host: state?.host === '0.0.0.0' ? '0.0.0.0' : localHost,
-		open: false,
-		killBlockingPort: shouldKillBlockingPort,
-	});
-} else if (command === 'stop') {
-	await stopServer();
-} else {
-	throw new Error(`Unknown dev-local command: ${command}`);
+const runCommand = async () => {
+	if (command === 'start') {
+		await startServer({ open: !skipOpen, killBlockingPort: shouldKillBlockingPort });
+	} else if (command === 'lan') {
+		await startServer({ host: '0.0.0.0', open: !skipOpen, killBlockingPort: shouldKillBlockingPort });
+	} else if (command === 'status') {
+		await showStatus();
+	} else if (command === 'logs') {
+		await showLogs();
+	} else if (command === 'restart') {
+		const state = await readState();
+		await startServer({
+			host: state?.host === '0.0.0.0' ? '0.0.0.0' : localHost,
+			open: false,
+			killBlockingPort: shouldKillBlockingPort,
+		});
+	} else if (command === 'stop') {
+		await stopServer();
+	} else {
+		throw new Error(`Unknown dev-local command: ${command}`);
+	}
+};
+
+try {
+	await runCommand();
+} catch (error) {
+	console.error(error instanceof Error ? error.message : String(error));
+	process.exit(1);
 }

package/scripts/generate-search-index.mjs

@@ -0,0 +1,57 @@
+import { cp, mkdir, readdir, rm } from 'node:fs/promises';
+import path from 'node:path';
+import * as pagefind from 'pagefind';
+import projectConfig from './lib/project-config.mjs';
+import {
+	astroDistDir,
+	astroPublicDir,
+} from './lib/site-paths.mjs';
+
+const searchDirectoryName = 'pagefind';
+const distSearchDirectory = path.join(astroDistDir, searchDirectoryName);
+const localSearchDirectory = path.join(astroPublicDir, searchDirectoryName);
+
+if (!projectConfig.search.enabled) {
+	await rm(localSearchDirectory, { force: true, recursive: true });
+	console.log('Static search is disabled.');
+} else {
+	await rm(distSearchDirectory, { force: true, recursive: true });
+
+	try {
+		const { errors: createErrors, index } = await pagefind.createIndex();
+		if (!index || createErrors.length > 0) {
+			throw new Error(createErrors.join('\n') || 'Pagefind did not create an index.');
+		}
+
+		const { errors: indexingErrors, page_count: scannedPageCount } = await index.addDirectory({
+			path: astroDistDir,
+		});
+		if (indexingErrors.length > 0) throw new Error(indexingErrors.join('\n'));
+		if (scannedPageCount === 0) {
+			throw new Error('No rendered pages contained searchable editorial content.');
+		}
+
+		const { errors: writeErrors } = await index.writeFiles({
+			outputPath: distSearchDirectory,
+		});
+		if (writeErrors.length > 0) throw new Error(writeErrors.join('\n'));
+		const fragmentDirectory = path.join(distSearchDirectory, 'fragment');
+		const indexedPageCount = (await readdir(fragmentDirectory))
+			.filter((filename) => filename.endsWith('.pf_fragment'))
+			.length;
+		if (indexedPageCount === 0) {
+			throw new Error('No rendered pages contained searchable editorial content.');
+		}
+
+		await rm(localSearchDirectory, { force: true, recursive: true });
+		await mkdir(astroPublicDir, { recursive: true });
+		await cp(distSearchDirectory, localSearchDirectory, { recursive: true });
+
+		console.log(`Generated static search index for ${indexedPageCount} page${indexedPageCount === 1 ? '' : 's'}.`);
+	} catch (error) {
+		const message = error instanceof Error ? error.message : String(error);
+		throw new Error(`Could not generate the static search index. ${message}`);
+	} finally {
+		await pagefind.close();
+	}
+}

package/scripts/init-site.mjs

@@ -165,6 +165,7 @@ const nornaScripts = {
 	'norna:config:check': cliCommand('config:check'),
 	'norna:content:check': cliCommand('content:check'),
 	'norna:sync': cliCommand('content:sync'),
+	'norna:navigation:review': cliCommand('navigation:review'),
 	'norna:theme:presets': cliCommand('theme:presets'),
 	'norna:theme:export': cliCommand('theme:export'),
 	'norna:typography:profiles': cliCommand('typography profiles'),