@janga/norna 0.7.13 → 0.7.15

package/scripts/test-content-check.mjs

@@ -42,12 +42,9 @@ const makePngHeader = ({ width, height }) => {
 	return buffer;
 };
 
-const defaultTheme = `---
-typography:
-  preset: quiet-gallery
-presentation:
-  palette: dark
----
+const defaultTheme = `typography:
+  profile: restrained
+palette: dark
 `;
 
 const withTempProject = async ({ site, theme = defaultTheme, files, siteDirectory = 'site' }, run) => {
@@ -55,7 +52,7 @@ const withTempProject = async ({ site, theme = defaultTheme, files, siteDirector
 
 	try {
 		await writeFixtureFile(root, `${siteDirectory}/content.md`, site);
-		await writeFixtureFile(root, `${siteDirectory}/theme.md`, theme);
+		await writeFixtureFile(root, `${siteDirectory}/theme.yaml`, theme);
 
 		for (const file of files) {
 			if (typeof file === 'string') {
@@ -370,12 +367,11 @@ This paragraph has {note-ref} two references {note-ref}.
 });
 
 const badWhitespaceSite = `---
-presentation:
-  typography:
-    preset: quiet-gallery
-\u00a0\u00a0\u00a0\u00a0overrides:
-      body:
-        paragraphSpacing: 0.3em
+typography:
+  profile: restrained
+\u00a0\u00a0overrides:
+    body:
+      paragraphSpacing: 0.3em
 sections:
   intro: {}
 
@@ -394,18 +390,17 @@ test('content:check explains invalid frontmatter indentation whitespace', async
 
 		assert.equal(result.status, 1, output);
 		assert.match(output, /^Content check failed\./m);
-		assert.match(output, /Frontmatter line 5 uses tabs, non-breaking spaces, or invalid whitespace for indentation\./);
+		assert.match(output, /Frontmatter line 4 uses tabs, non-breaking spaces, or invalid whitespace for indentation\./);
 		assert.match(output, /Replace the indentation on that line with ordinary spaces\./);
 	});
 });
 
 const badNestedValueSite = `---
-presentation:
-  typography:
-    preset: quiet-gallery
-      overrides:
-        body:
-          paragraphSpacing: 0.3em
+typography:
+  profile: restrained
+    overrides:
+      body:
+        paragraphSpacing: 0.3em
 sections:
   intro: {}
 
@@ -424,17 +419,17 @@ test('content:check explains frontmatter indentation below scalar values', async
 
 		assert.equal(result.status, 1, output);
 		assert.match(output, /^Content check failed\./m);
-		assert.match(output, /Frontmatter line 5 is indented under line 4, but line 4 already has a value\./);
+		assert.match(output, /Frontmatter line 4 is indented under line 3, but line 3 already has a value\./);
 		assert.match(output, /Move the later line to the same indentation level as its sibling/);
 	});
 });
 
-const topLevelGallerySite = `---
+const topLevelImagesSite = `---
 title: Example
 description: Example site.
 sections:
   intro: {}
-gallery:
+images:
       - image: intro.jpg
 
 ---
@@ -444,7 +439,7 @@ Text.
 
 test('content:check explains likely misindented frontmatter keys', async () => {
 	await withTempProject({
-		site: topLevelGallerySite,
+		site: topLevelImagesSite,
 		files: ['site/images/intro/intro.jpg'],
 	}, async (root) => {
 		const result = runContentScript(root, ['--check']);
@@ -452,8 +447,8 @@ test('content:check explains likely misindented frontmatter keys', async () => {
 
 		assert.equal(result.status, 1, output);
 		assert.match(output, /^Content check failed\./m);
-		assert.match(output, /Frontmatter line 6 defines "gallery" at the top level, but it is not a valid top-level content field\./);
-		assert.match(output, /Indent "gallery:" under the object it belongs to, or move image content into Norna Markdown blocks\./);
+		assert.match(output, /Frontmatter line 6 defines "images" at the top level, but it is not a valid top-level content field\./);
+		assert.match(output, /Put local image references in norna-image-stack or norna-image-carousel blocks in the Markdown body\./);
 	});
 });
 

package/scripts/test-content-model-v2.mjs

@@ -51,14 +51,9 @@ const createTempSite = async ({ underRepoCache = false } = {}) => {
 	const root = await mkdtemp(path.join(tempParent, 'norna-content-model-v2-'));
 	const siteDir = path.join(root, 'site');
 	await mkdir(siteDir, { recursive: true });
-	await writeFile(path.join(siteDir, 'config.md'), `---
-url: https://example.com/
----
-`);
-	await writeFile(path.join(siteDir, 'theme.md'), `---
-typography:
-  preset: text-forward
----
+	await writeFile(path.join(siteDir, 'config.yaml'), 'url: https://example.com/\n');
+	await writeFile(path.join(siteDir, 'theme.yaml'), `typography:
+  profile: reading
 `);
 	return { root, siteDir };
 };
@@ -124,15 +119,11 @@ test('content model v2 fixture checks and builds', async () => {
 test('route theme replaces visual theme while site identity stays at the root', async () => {
 	const { root, siteDir } = await createTempSite({ underRepoCache: true });
 	try {
-		await writeFile(path.join(siteDir, 'theme.md'), `---
-typography:
-  preset: text-forward
----
+		await writeFile(path.join(siteDir, 'theme.yaml'), `typography:
+  profile: reading
 `);
-		await writeFile(path.join(siteDir, 'sitewide-content.md'), `---
-navigation:
-  brand: Root Brand
----
+		await writeFile(path.join(siteDir, 'sitewide-content.yaml'), `navigation:
+  label: Root Brand
 `);
 		await mkdir(path.join(siteDir, 'routes', '010-guide'), { recursive: true });
 		await writeFile(path.join(siteDir, 'content.md'), `---
@@ -144,7 +135,7 @@ description: Root page
 
 Root content.
 `);
-		await writeFile(path.join(siteDir, 'routes', '010-guide', 'route-content.md'), `---
+		await writeFile(path.join(siteDir, 'routes', '010-guide', 'content.md'), `---
 title: Guide
 description: Guide page
 navigation:
@@ -155,12 +146,9 @@ navigation:
 
 Route content.
 `);
-		await writeFile(path.join(siteDir, 'routes', '010-guide', 'theme.md'), `---
-typography:
-  preset: statement
-presentation:
-  palette: light
----
+		await writeFile(path.join(siteDir, 'routes', '010-guide', 'theme.yaml'), `typography:
+  profile: statement
+palette: light
 `);
 
 		await runNorna(['--site-dir', siteDir, 'build']);
@@ -187,7 +175,7 @@ description: Root page
 
 Root content.
 `);
-		await writeFile(path.join(siteDir, 'routes', '010-guide', 'route-content.md'), `---
+		await writeFile(path.join(siteDir, 'routes', '010-guide', 'content.md'), `---
 title: Guide
 description: Guide page
 ---
@@ -196,16 +184,60 @@ description: Guide page
 
 Route content.
 `);
-		await writeFile(path.join(siteDir, 'routes', '010-guide', 'theme.md'), `---
-navigation:
-  brand: Route Brand
----
+		await writeFile(path.join(siteDir, 'routes', '010-guide', 'theme.yaml'), `navigation:
+  label: Route Brand
+`);
+
+		await assert.rejects(
+			runNorna(['--site-dir', siteDir, 'config:check']),
+			(error) => {
+				assert.match(error.output, /may not define navigation\. The site label and logo settings belong in site\/sitewide-content\.yaml/);
+				return true;
+			},
+		);
+	} finally {
+		await rm(root, { recursive: true, force: true });
+	}
+});
+
+test('navigation logo settings require one conventional logo file', async () => {
+	const { root, siteDir } = await createTempSite();
+	try {
+		await writeFile(path.join(siteDir, 'sitewide-content.yaml'), `navigation:
+  label: Missing logo
+  logo:
+    height: 2rem
+`);
+
+		await assert.rejects(
+			runNorna(['--site-dir', siteDir, 'config:check']),
+			(error) => {
+				assert.match(error.output, /navigation\.logo is configured, but no logo file was found/);
+				assert.match(error.output, /site\/public\/logo\.svg/);
+				return true;
+			},
+		);
+	} finally {
+		await rm(root, { recursive: true, force: true });
+	}
+});
+
+test('multiple conventional navigation logo files stop config validation', async () => {
+	const { root, siteDir } = await createTempSite();
+	try {
+		await writeFile(path.join(siteDir, 'sitewide-content.yaml'), `navigation:
+  label: Conflicting logos
 `);
+		await mkdir(path.join(siteDir, 'public'), { recursive: true });
+		await writeFile(path.join(siteDir, 'public', 'logo.svg'), '<svg/>');
+		await writeFile(path.join(siteDir, 'public', 'logo.png'), 'png');
 
 		await assert.rejects(
 			runNorna(['--site-dir', siteDir, 'config:check']),
 			(error) => {
-				assert.match(error.output, /may not define navigation\. Brand and logo belong in site\/sitewide-content\.md/);
+				assert.match(error.output, /Found multiple logo files/);
+				assert.match(error.output, /site\/public\/logo\.svg/);
+				assert.match(error.output, /site\/public\/logo\.png/);
 				return true;
 			},
 		);
@@ -286,7 +318,7 @@ description: Fixture
 
 The first paragraph points to an explanation.{note-ref}
 
-{note: This explanation names \`sitewide-content.md\` and stays beside the
+{note: This explanation names \`sitewide-content.yaml\` and stays beside the
 paragraph on wide screens.}
 
 The second paragraph has its own explanation.{note-ref}
@@ -302,7 +334,7 @@ The second paragraph has its own explanation.{note-ref}
 		assert.match(html, /<sup class="section-note-ref"><a id="note-ref-home-intro-1" href="#note-home-intro-1" aria-label="Note 1" aria-describedby="note-home-intro-1" data-note-id="note-home-intro-1">1<\/a><\/sup>/);
 		assert.match(html, /<aside class="section-note section-note-margin" id="note-home-intro-1" aria-label="Note 1" role="note" data-note-id="note-home-intro-1" style="grid-row: 1;">/);
 		assert.match(html, /<a class="section-note-number" href="#note-ref-home-intro-1" aria-label="Note 1">\s*1\s*<\/a>/);
-		assert.match(html, /This explanation names <code>sitewide-content\.md<\/code> and stays beside the paragraph on wide screens\./);
+		assert.match(html, /This explanation names <code>sitewide-content\.yaml<\/code> and stays beside the paragraph on wide screens\./);
 		assert.match(html, /<sup class="section-note-ref"><a id="note-ref-home-intro-2" href="#note-home-intro-2" aria-label="Note 2" aria-describedby="note-home-intro-2" data-note-id="note-home-intro-2">2<\/a><\/sup>/);
 		assert.match(html, /<aside class="section-note section-note-margin" id="note-home-intro-2" aria-label="Note 2" role="note" data-note-id="note-home-intro-2" style="grid-row: 2;">/);
 		assert.match(html, /This is the second explanation\./);
@@ -652,7 +684,7 @@ description: Fixture
 
 Text.
 `);
-		await writeFile(path.join(sourceRouteDir, 'route-content.md'), `---
+		await writeFile(path.join(sourceRouteDir, 'content.md'), `---
 title: Source
 description: Fixture
 ---
@@ -661,7 +693,7 @@ description: Fixture
 
 Text.
 `);
-		await writeFile(path.join(targetRouteDir, 'route-content.md'), `---
+		await writeFile(path.join(targetRouteDir, 'content.md'), `---
 title: Target
 description: Fixture
 ---
@@ -700,7 +732,7 @@ description: Fixture
 
 Text.
 `);
-		await writeFile(path.join(sourceRouteDir, 'route-content.md'), `---
+		await writeFile(path.join(sourceRouteDir, 'content.md'), `---
 title: Source
 description: Fixture
 ---
@@ -709,7 +741,7 @@ description: Fixture
 
 Text.
 `);
-		await writeFile(path.join(targetRouteDir, 'route-content.md'), `---
+		await writeFile(path.join(targetRouteDir, 'content.md'), `---
 title: Target
 description: Fixture
 ---
@@ -756,7 +788,7 @@ description: Fixture
 
 Text.
 `);
-		await writeFile(path.join(sourceRouteDir, 'route-content.md'), `---
+		await writeFile(path.join(sourceRouteDir, 'content.md'), `---
 title: Source
 description: Fixture
 ---
@@ -765,7 +797,7 @@ description: Fixture
 
 Text.
 `);
-		await writeFile(path.join(targetRouteDir, 'route-content.md'), `---
+		await writeFile(path.join(targetRouteDir, 'content.md'), `---
 title: Target
 description: Fixture
 ---
@@ -809,7 +841,7 @@ description: Fixture
 
 Text.
 `);
-		await writeFile(path.join(sourceRouteDir, 'route-content.md'), `---
+		await writeFile(path.join(sourceRouteDir, 'content.md'), `---
 title: Source
 description: Fixture
 ---
@@ -820,7 +852,7 @@ description: Fixture
 - image: shared.jpg
 \`\`\`
 `);
-		await writeFile(path.join(targetRouteDir, 'route-content.md'), `---
+		await writeFile(path.join(targetRouteDir, 'content.md'), `---
 title: Target
 description: Fixture
 ---
@@ -836,7 +868,7 @@ description: Fixture
 		await assert.rejects(
 			() => runContentScript(siteDir, ['--write', '--yes']),
 			(error) => {
-				assert.match(error.output, /Cannot relocate "shared\.jpg" from .*site\/routes\/010-source\/images\/old\/shared\.jpg because it is still referenced from .*site\/routes\/010-source\/route-content\.md \[old\]\./);
+				assert.match(error.output, /Cannot relocate "shared\.jpg" from .*site\/routes\/010-source\/images\/old\/shared\.jpg because it is still referenced from .*site\/routes\/010-source\/content\.md \[old\]\./);
 				return true;
 			},
 		);

package/scripts/test-documentation.mjs

@@ -8,6 +8,20 @@ const repoRoot = path.resolve(import.meta.dirname, '..');
 const cliPath = path.join(repoRoot, 'bin', 'norna.mjs');
 const tutorialPath = path.join(repoRoot, 'docs', 'getting-started.md');
 const scratchRoot = path.join(repoRoot, 'todos');
+const obsoleteSourceReferences = [
+	'site/config.md',
+	'site/theme.md',
+	'site/sitewide-content.md',
+	'route-content.md',
+	'docs/site-structure.md',
+];
+const obsoleteSiteFilenames = new Set([
+	'config.md',
+	'theme.md',
+	'sitewide-content.md',
+	'route-content.md',
+]);
+const ignoredSiteDirectories = new Set(['.astro', '.norna', 'dist', 'node_modules']);
 await mkdir(scratchRoot, { recursive: true });
 const tempRoot = await mkdtemp(path.join(scratchRoot, 'norna-documentation-'));
 const tutorialSiteRoot = path.join(tempRoot, 'my-site');
@@ -42,6 +56,20 @@ const collectMarkdownFiles = async (directory) => {
 	return files;
 };
 
+const collectFiles = async (directory) => {
+	const files = [];
+	for (const entry of await readdir(directory, { withFileTypes: true })) {
+		const entryPath = path.join(directory, entry.name);
+		if (entry.isDirectory()) {
+			if (ignoredSiteDirectories.has(entry.name)) continue;
+			files.push(...await collectFiles(entryPath));
+		} else {
+			files.push(entryPath);
+		}
+	}
+	return files;
+};
+
 const checkLocalMarkdownLinks = async () => {
 	const markdownFiles = [
 		path.join(repoRoot, 'README.md'),
@@ -71,6 +99,42 @@ const checkLocalMarkdownLinks = async () => {
 	assert.deepEqual(missing, [], `Broken local Markdown links:\n${missing.join('\n')}`);
 };
 
+const checkObsoleteDocumentationReferences = async () => {
+	const markdownFiles = [
+		path.join(repoRoot, 'README.md'),
+		...await collectMarkdownFiles(path.join(repoRoot, 'docs')),
+		...await collectMarkdownFiles(path.join(repoRoot, 'examples')),
+		...await collectMarkdownFiles(path.join(repoRoot, 'starters')),
+	];
+	const obsolete = [];
+
+	for (const markdownPath of markdownFiles) {
+		const source = await readFile(markdownPath, 'utf8');
+		for (const reference of obsoleteSourceReferences) {
+			if (source.includes(reference)) {
+				obsolete.push(`${path.relative(repoRoot, markdownPath)} -> ${reference}`);
+			}
+		}
+	}
+
+	assert.deepEqual(obsolete, [], `Obsolete Norna source references:\n${obsolete.join('\n')}`);
+};
+
+const checkObsoleteSiteFiles = async () => {
+	const siteRoots = [
+		path.join(repoRoot, 'site'),
+		path.join(repoRoot, 'starters'),
+		path.join(repoRoot, 'examples'),
+		path.join(repoRoot, 'fixtures'),
+	];
+	const files = (await Promise.all(siteRoots.map(collectFiles))).flat();
+	const obsolete = files
+		.filter((filePath) => obsoleteSiteFilenames.has(path.basename(filePath)))
+		.map((filePath) => path.relative(repoRoot, filePath));
+
+	assert.deepEqual(obsolete, [], `Obsolete Norna site files:\n${obsolete.join('\n')}`);
+};
+
 try {
 	const tutorial = await readFile(tutorialPath, 'utf8');
 	const initResult = runCli(['init', tutorialSiteRoot]);
@@ -84,12 +148,12 @@ try {
 			extractTutorialFile(tutorial, 'Replace `site/content.md` with:', 'md'),
 		),
 		writeFile(
-			path.join(tutorialSiteRoot, 'site', 'sitewide-content.md'),
-			extractTutorialFile(tutorial, 'Replace `site/sitewide-content.md` with:', 'yaml'),
+			path.join(tutorialSiteRoot, 'site', 'sitewide-content.yaml'),
+			extractTutorialFile(tutorial, 'Replace `site/sitewide-content.yaml` with:', 'yaml'),
 		),
 		writeFile(
-			path.join(tutorialSiteRoot, 'site', 'theme.md'),
-			extractTutorialFile(tutorial, 'Replace `site/theme.md` with:', 'yaml'),
+			path.join(tutorialSiteRoot, 'site', 'theme.yaml'),
+			extractTutorialFile(tutorial, 'Replace `site/theme.yaml` with:', 'yaml'),
 		),
 	]);
 
@@ -104,6 +168,8 @@ try {
 	assert.match(html, /Next/);
 
 	await checkLocalMarkdownLinks();
+	await checkObsoleteDocumentationReferences();
+	await checkObsoleteSiteFiles();
 
 	const llms = await readFile(path.join(repoRoot, 'site', 'public', 'llms.txt'), 'utf8');
 	for (const match of llms.matchAll(/https:\/\/raw\.githubusercontent\.com\/janga\/norna\/main\/([^\s)]+)/g)) {

package/scripts/test-editor-language-service.mjs

@@ -0,0 +1,158 @@
+import assert from 'node:assert/strict';
+import { mkdtemp, mkdir, rm, writeFile } from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+import { documentationRef } from './lib/documentation-links.mjs';
+import {
+	findNornaSiteRoot,
+	getImageDefinitionContext,
+	getImageCompletionContext,
+	getMarkdownDiagnostics,
+	getNornaBlockCompletionContext,
+	getNornaBlockFieldContext,
+	getSitePublicAssetStatus,
+	nornaBlockDefinitions,
+} from './lib/editor-language-service.mjs';
+
+const root = await mkdtemp(path.join(os.tmpdir(), 'norna-editor-language-'));
+const siteRoot = path.join(root, 'site');
+const homeContentPath = path.join(siteRoot, 'content.md');
+const routeContentPath = path.join(siteRoot, 'routes', '010-about', 'content.md');
+
+const homeSource = `---
+title: Editor fixture
+description: Exercises project-local image discovery.
+---
+
+## Intro {#intro}
+
+Text with a missing note {note-ref}.
+
+\`\`\`norna-image-stack
+- image: local.jpg
+- image: portrait.jpg
+\`\`\`
+`;
+const routeSource = `---
+title: About
+description: About this fixture.
+---
+
+## Team {#team}
+
+Route content.
+`;
+
+try {
+	await mkdir(path.join(siteRoot, 'images', 'intro'), { recursive: true });
+	await mkdir(path.join(siteRoot, 'routes', '010-about', 'images', 'team'), { recursive: true });
+	await mkdir(path.join(siteRoot, 'public'), { recursive: true });
+	await writeFile(path.join(siteRoot, 'config.yaml'), 'url: https://example.com/\n');
+	await writeFile(path.join(siteRoot, 'sitewide-content.yaml'), `navigation:
+  label: Editor fixture
+  logo:
+    height: 2rem
+`);
+	await writeFile(path.join(siteRoot, 'images', 'intro', 'local.jpg'), 'local');
+	await writeFile(path.join(siteRoot, 'routes', '010-about', 'images', 'team', 'portrait.jpg'), 'portrait');
+	await writeFile(path.join(siteRoot, 'public', 'logo.svg'), '<svg/>');
+	await writeFile(path.join(siteRoot, 'public', 'logo.png'), 'logo');
+	await writeFile(path.join(siteRoot, 'public', 'favicon.svg'), '<svg/>');
+	await writeFile(path.join(siteRoot, 'public', 'Logo.JPG'), 'wrong case');
+	await writeFile(path.join(siteRoot, 'public', 'favion.ico'), 'typo');
+	await writeFile(path.join(siteRoot, 'public', 'favicon-32x32.png'), 'unrecognized');
+	await writeFile(homeContentPath, homeSource);
+	await writeFile(routeContentPath, routeSource);
+
+	assert.equal(await findNornaSiteRoot(homeContentPath), siteRoot);
+	const publicAssetStatus = await getSitePublicAssetStatus(homeContentPath);
+	assert.deepEqual(publicAssetStatus.logos, ['logo.png', 'logo.svg']);
+	assert.deepEqual(publicAssetStatus.browserIcons, ['favicon.svg']);
+	assert.equal(publicAssetStatus.issues.filter(({ code }) => code === 'multiple-logo-files').length, 2);
+	assert.ok(publicAssetStatus.issues.some(({ code }) => code === 'possible-favicon-typo'));
+	assert.ok(publicAssetStatus.issues.some(({ code }) => code === 'unrecognized-favicon-file'));
+	assert.ok(publicAssetStatus.issues.some(({ code, filename }) => code === 'public-asset-case' && filename === 'Logo.JPG'));
+	await rm(path.join(siteRoot, 'public', 'logo.svg'), { force: true });
+	await rm(path.join(siteRoot, 'public', 'logo.png'), { force: true });
+	const missingLogoStatus = await getSitePublicAssetStatus(homeContentPath);
+	assert.ok(missingLogoStatus.issues.some(({ code, line }) => code === 'missing-logo-file' && line === 3));
+	assert.equal(nornaBlockDefinitions['norna-image-stack'].description.includes('vertical stack'), true);
+	assert.match(
+		nornaBlockDefinitions['norna-image-stack'].documentation,
+		new RegExp(`/blob/${documentationRef.replaceAll('.', '\\.')}\/docs/content\\.md#norna-blocks`),
+	);
+	assert.equal(nornaBlockDefinitions['norna-card-list'].options.layout.default, 'image-top');
+
+	const stackFieldSource = homeSource.replace('- image: portrait.jpg', '- image: portrait.jpg\n  ');
+	const stackFieldLine = stackFieldSource.split('\n').findIndex((line) => line === '  ');
+	const stackFieldCompletion = getNornaBlockCompletionContext({ source: stackFieldSource, line: stackFieldLine });
+	assert.deepEqual(stackFieldCompletion.candidates.map(({ key }) => key), ['alt', 'caption']);
+
+	const cardValueSource = `${homeSource}\n\`\`\`norna-card-list\nlayout: \n\`\`\`\n`;
+	const cardValueLine = cardValueSource.split('\n').findIndex((line) => line === 'layout: ');
+	const cardValueCompletion = getNornaBlockCompletionContext({ source: cardValueSource, line: cardValueLine });
+	assert.equal(cardValueCompletion.mode, 'value');
+	assert.deepEqual(cardValueCompletion.candidates.map(({ label }) => label), ['image-top', 'image-left', 'image-right']);
+	assert.equal(
+		getNornaBlockFieldContext({ source: cardValueSource, line: cardValueLine }).field.default,
+		'image-top',
+	);
+
+	const completionSource = homeSource.replace('- image: portrait.jpg', '- image: ');
+	const completionLine = completionSource.split('\n').findIndex((line) => line === '- image: ');
+	const completion = await getImageCompletionContext({
+		documentPath: homeContentPath,
+		line: completionLine,
+		source: completionSource,
+	});
+	assert.ok(completion);
+	assert.deepEqual(
+		completion.candidates.map(({ filename, isExpected }) => [filename, isExpected]),
+		[['local.jpg', true], ['portrait.jpg', false]],
+	);
+	const localDefinitionLine = homeSource.split('\n').findIndex((line) => line === '- image: local.jpg');
+	const localDefinition = await getImageDefinitionContext({
+		documentPath: homeContentPath,
+		line: localDefinitionLine,
+		source: homeSource,
+	});
+	assert.deepEqual(localDefinition.files, [path.join(siteRoot, 'images', 'intro', 'local.jpg')]);
+
+	const diagnostics = await getMarkdownDiagnostics({ documentPath: homeContentPath, source: homeSource });
+	assert.ok(diagnostics.some(({ code, message }) => code === 'image-needs-sync' && message.includes('Run "norna content:sync"')));
+	assert.ok(diagnostics.some(({ message }) => message.includes('has no following "{note: ...}"')));
+	const missingIdDiagnostics = await getMarkdownDiagnostics({
+		documentPath: homeContentPath,
+		source: homeSource.replace('## Intro {#intro}', '## Intro'),
+	});
+	assert.ok(missingIdDiagnostics.some(({ code }) => code === 'missing-section-id'));
+	const unclosedBlockDiagnostics = await getMarkdownDiagnostics({
+		documentPath: homeContentPath,
+		source: homeSource.replace(/\n```\n$/, '\n'),
+	});
+	assert.ok(unclosedBlockDiagnostics.some(({ code }) => code === 'unclosed-norna-block'));
+	const markdownImageDiagnostics = await getMarkdownDiagnostics({
+		documentPath: homeContentPath,
+		source: homeSource.replace('Text with a missing note {note-ref}.', '![Portrait](portrait.jpg)'),
+	});
+	assert.ok(markdownImageDiagnostics.some(({ code }) => code === 'local-markdown-image'));
+
+	await writeFile(routeContentPath, routeSource.replace('Route content.', `\`\`\`norna-image-stack
+- image: portrait.jpg
+\`\`\``));
+	const sharedDiagnostics = await getMarkdownDiagnostics({ documentPath: homeContentPath, source: homeSource });
+	assert.ok(sharedDiagnostics.some(({ message }) => message.includes('is still referenced by')));
+
+	await mkdir(path.join(siteRoot, 'routes', '020-contact', 'images', 'people'), { recursive: true });
+	await writeFile(path.join(siteRoot, 'routes', '020-contact', 'images', 'people', 'portrait.jpg'), 'duplicate');
+	const ambiguousDiagnostics = await getMarkdownDiagnostics({ documentPath: homeContentPath, source: homeSource });
+	assert.ok(ambiguousDiagnostics.some(({ message }) => message.includes('is ambiguous')));
+
+	const missingSource = homeSource.replace('portrait.jpg', 'missing.jpg');
+	const missingDiagnostics = await getMarkdownDiagnostics({ documentPath: homeContentPath, source: missingSource });
+	assert.ok(missingDiagnostics.some(({ message }) => message.includes('was not found')));
+
+	console.log('Editor language service tests passed.');
+} finally {
+	await rm(root, { recursive: true, force: true });
+}