@janga/norna 0.7.10 → 0.7.12

package/examples/{typography-presets → feature-demos/theme-presets}/site/.norna/generated-images.json

@@ -1,216 +1,216 @@
 {
-  "routes/010-quiet-gallery/images/quiet-gallery/puppy-portrait.jpg": {
+  "routes/010-portfolio/images/portfolio/puppy-portrait.jpg": {
     "outputVersion": 2,
     "sourceHash": "0cb5126b86660785da62903393e43df7b6e361d3bd1a0492cc6f371159c5afb8",
     "width": 1200,
     "height": 800,
     "variants": [
       {
-        "src": "/images/generated/routes/010-quiet-gallery/images/quiet-gallery/puppy-portrait-0cb5126b-480.webp",
+        "src": "/images/generated/routes/010-portfolio/images/portfolio/puppy-portrait-0cb5126b-480.webp",
         "width": 480
       },
       {
-        "src": "/images/generated/routes/010-quiet-gallery/images/quiet-gallery/puppy-portrait-0cb5126b-768.webp",
+        "src": "/images/generated/routes/010-portfolio/images/portfolio/puppy-portrait-0cb5126b-768.webp",
         "width": 768
       },
       {
-        "src": "/images/generated/routes/010-quiet-gallery/images/quiet-gallery/puppy-portrait-0cb5126b-1080.webp",
+        "src": "/images/generated/routes/010-portfolio/images/portfolio/puppy-portrait-0cb5126b-1080.webp",
         "width": 1080
       },
       {
-        "src": "/images/generated/routes/010-quiet-gallery/images/quiet-gallery/puppy-portrait-0cb5126b-1200.webp",
+        "src": "/images/generated/routes/010-portfolio/images/portfolio/puppy-portrait-0cb5126b-1200.webp",
         "width": 1200
       }
     ]
   },
-  "routes/010-quiet-gallery/images/quiet-gallery/shepherd-portrait.jpg": {
+  "routes/010-portfolio/images/portfolio/shepherd-portrait.jpg": {
     "outputVersion": 2,
     "sourceHash": "604099036852fa40c2fecf8620a138405c8edcb0b92f120bb603742f9ee91154",
     "width": 1200,
     "height": 800,
     "variants": [
       {
-        "src": "/images/generated/routes/010-quiet-gallery/images/quiet-gallery/shepherd-portrait-60409903-480.webp",
+        "src": "/images/generated/routes/010-portfolio/images/portfolio/shepherd-portrait-60409903-480.webp",
         "width": 480
       },
       {
-        "src": "/images/generated/routes/010-quiet-gallery/images/quiet-gallery/shepherd-portrait-60409903-768.webp",
+        "src": "/images/generated/routes/010-portfolio/images/portfolio/shepherd-portrait-60409903-768.webp",
         "width": 768
       },
       {
-        "src": "/images/generated/routes/010-quiet-gallery/images/quiet-gallery/shepherd-portrait-60409903-1080.webp",
+        "src": "/images/generated/routes/010-portfolio/images/portfolio/shepherd-portrait-60409903-1080.webp",
         "width": 1080
       },
       {
-        "src": "/images/generated/routes/010-quiet-gallery/images/quiet-gallery/shepherd-portrait-60409903-1200.webp",
+        "src": "/images/generated/routes/010-portfolio/images/portfolio/shepherd-portrait-60409903-1200.webp",
         "width": 1200
       }
     ]
   },
-  "routes/010-quiet-gallery/images/quiet-gallery/white-puppy.jpg": {
+  "routes/010-portfolio/images/portfolio/white-puppy.jpg": {
     "outputVersion": 2,
     "sourceHash": "bcb834d00bb9b520dac475c32906f8578a03bd922c1639c7d86252ae1f1c433a",
     "width": 1200,
     "height": 800,
     "variants": [
       {
-        "src": "/images/generated/routes/010-quiet-gallery/images/quiet-gallery/white-puppy-bcb834d0-480.webp",
+        "src": "/images/generated/routes/010-portfolio/images/portfolio/white-puppy-bcb834d0-480.webp",
         "width": 480
       },
       {
-        "src": "/images/generated/routes/010-quiet-gallery/images/quiet-gallery/white-puppy-bcb834d0-768.webp",
+        "src": "/images/generated/routes/010-portfolio/images/portfolio/white-puppy-bcb834d0-768.webp",
         "width": 768
       },
       {
-        "src": "/images/generated/routes/010-quiet-gallery/images/quiet-gallery/white-puppy-bcb834d0-1080.webp",
+        "src": "/images/generated/routes/010-portfolio/images/portfolio/white-puppy-bcb834d0-1080.webp",
         "width": 1080
       },
       {
-        "src": "/images/generated/routes/010-quiet-gallery/images/quiet-gallery/white-puppy-bcb834d0-1200.webp",
+        "src": "/images/generated/routes/010-portfolio/images/portfolio/white-puppy-bcb834d0-1200.webp",
         "width": 1200
       }
     ]
   },
-  "routes/020-compact-gallery/images/compact-gallery/black-schnauzer.jpg": {
+  "routes/020-documentation/images/documentation/black-schnauzer.jpg": {
     "outputVersion": 2,
     "sourceHash": "569922b4aa71096cc8e3a245f0ddccf74f941881b823084723854580078b50b0",
     "width": 1200,
     "height": 800,
     "variants": [
       {
-        "src": "/images/generated/routes/020-compact-gallery/images/compact-gallery/black-schnauzer-569922b4-480.webp",
+        "src": "/images/generated/routes/020-documentation/images/documentation/black-schnauzer-569922b4-480.webp",
         "width": 480
       },
       {
-        "src": "/images/generated/routes/020-compact-gallery/images/compact-gallery/black-schnauzer-569922b4-768.webp",
+        "src": "/images/generated/routes/020-documentation/images/documentation/black-schnauzer-569922b4-768.webp",
         "width": 768
       },
       {
-        "src": "/images/generated/routes/020-compact-gallery/images/compact-gallery/black-schnauzer-569922b4-1080.webp",
+        "src": "/images/generated/routes/020-documentation/images/documentation/black-schnauzer-569922b4-1080.webp",
         "width": 1080
       },
       {
-        "src": "/images/generated/routes/020-compact-gallery/images/compact-gallery/black-schnauzer-569922b4-1200.webp",
+        "src": "/images/generated/routes/020-documentation/images/documentation/black-schnauzer-569922b4-1200.webp",
         "width": 1200
       }
     ]
   },
-  "routes/020-compact-gallery/images/compact-gallery/retriever-portrait.jpg": {
+  "routes/020-documentation/images/documentation/retriever-portrait.jpg": {
     "outputVersion": 2,
     "sourceHash": "c441ca2935debeb008a43e2a7fd510bfd6776682f84160151fd5c8605bfb8cae",
     "width": 1200,
     "height": 800,
     "variants": [
       {
-        "src": "/images/generated/routes/020-compact-gallery/images/compact-gallery/retriever-portrait-c441ca29-480.webp",
+        "src": "/images/generated/routes/020-documentation/images/documentation/retriever-portrait-c441ca29-480.webp",
         "width": 480
       },
       {
-        "src": "/images/generated/routes/020-compact-gallery/images/compact-gallery/retriever-portrait-c441ca29-768.webp",
+        "src": "/images/generated/routes/020-documentation/images/documentation/retriever-portrait-c441ca29-768.webp",
         "width": 768
       },
       {
-        "src": "/images/generated/routes/020-compact-gallery/images/compact-gallery/retriever-portrait-c441ca29-1080.webp",
+        "src": "/images/generated/routes/020-documentation/images/documentation/retriever-portrait-c441ca29-1080.webp",
         "width": 1080
       },
       {
-        "src": "/images/generated/routes/020-compact-gallery/images/compact-gallery/retriever-portrait-c441ca29-1200.webp",
+        "src": "/images/generated/routes/020-documentation/images/documentation/retriever-portrait-c441ca29-1200.webp",
         "width": 1200
       }
     ]
   },
-  "routes/020-compact-gallery/images/compact-gallery/schnauzer-portrait.jpg": {
+  "routes/020-documentation/images/documentation/schnauzer-portrait.jpg": {
     "outputVersion": 2,
     "sourceHash": "545b0427b8e15846fe73656758da6eb3b8612dabf2b2879c31197986f8deb9b5",
     "width": 1200,
     "height": 900,
     "variants": [
       {
-        "src": "/images/generated/routes/020-compact-gallery/images/compact-gallery/schnauzer-portrait-545b0427-480.webp",
+        "src": "/images/generated/routes/020-documentation/images/documentation/schnauzer-portrait-545b0427-480.webp",
         "width": 480
       },
       {
-        "src": "/images/generated/routes/020-compact-gallery/images/compact-gallery/schnauzer-portrait-545b0427-768.webp",
+        "src": "/images/generated/routes/020-documentation/images/documentation/schnauzer-portrait-545b0427-768.webp",
         "width": 768
       },
       {
-        "src": "/images/generated/routes/020-compact-gallery/images/compact-gallery/schnauzer-portrait-545b0427-1080.webp",
+        "src": "/images/generated/routes/020-documentation/images/documentation/schnauzer-portrait-545b0427-1080.webp",
         "width": 1080
       },
       {
-        "src": "/images/generated/routes/020-compact-gallery/images/compact-gallery/schnauzer-portrait-545b0427-1200.webp",
+        "src": "/images/generated/routes/020-documentation/images/documentation/schnauzer-portrait-545b0427-1200.webp",
         "width": 1200
       }
     ]
   },
-  "routes/030-text-forward/images/text-forward/boxer-portrait.jpg": {
+  "routes/030-project/images/project/boxer-portrait.jpg": {
     "outputVersion": 2,
     "sourceHash": "da764a5b71f2bfa610ae4978cad4660cd6ecfdcd5b7fcbd788b92c3f9ada42b1",
     "width": 1200,
     "height": 800,
     "variants": [
       {
-        "src": "/images/generated/routes/030-text-forward/images/text-forward/boxer-portrait-da764a5b-480.webp",
+        "src": "/images/generated/routes/030-project/images/project/boxer-portrait-da764a5b-480.webp",
         "width": 480
       },
       {
-        "src": "/images/generated/routes/030-text-forward/images/text-forward/boxer-portrait-da764a5b-768.webp",
+        "src": "/images/generated/routes/030-project/images/project/boxer-portrait-da764a5b-768.webp",
         "width": 768
       },
       {
-        "src": "/images/generated/routes/030-text-forward/images/text-forward/boxer-portrait-da764a5b-1080.webp",
+        "src": "/images/generated/routes/030-project/images/project/boxer-portrait-da764a5b-1080.webp",
         "width": 1080
       },
       {
-        "src": "/images/generated/routes/030-text-forward/images/text-forward/boxer-portrait-da764a5b-1200.webp",
+        "src": "/images/generated/routes/030-project/images/project/boxer-portrait-da764a5b-1200.webp",
         "width": 1200
       }
     ]
   },
-  "routes/030-text-forward/images/text-forward/grass-puppy.jpg": {
+  "routes/030-project/images/project/grass-puppy.jpg": {
     "outputVersion": 2,
     "sourceHash": "519d663971223bdb1948db9087c637f1ed8b4d21d81c08e1fc10d5e2d904f230",
     "width": 1200,
     "height": 800,
     "variants": [
       {
-        "src": "/images/generated/routes/030-text-forward/images/text-forward/grass-puppy-519d6639-480.webp",
+        "src": "/images/generated/routes/030-project/images/project/grass-puppy-519d6639-480.webp",
         "width": 480
       },
       {
-        "src": "/images/generated/routes/030-text-forward/images/text-forward/grass-puppy-519d6639-768.webp",
+        "src": "/images/generated/routes/030-project/images/project/grass-puppy-519d6639-768.webp",
         "width": 768
       },
       {
-        "src": "/images/generated/routes/030-text-forward/images/text-forward/grass-puppy-519d6639-1080.webp",
+        "src": "/images/generated/routes/030-project/images/project/grass-puppy-519d6639-1080.webp",
         "width": 1080
       },
       {
-        "src": "/images/generated/routes/030-text-forward/images/text-forward/grass-puppy-519d6639-1200.webp",
+        "src": "/images/generated/routes/030-project/images/project/grass-puppy-519d6639-1200.webp",
         "width": 1200
       }
     ]
   },
-  "routes/030-text-forward/images/text-forward/grey-street-dog.jpg": {
+  "routes/030-project/images/project/grey-street-dog.jpg": {
     "outputVersion": 2,
     "sourceHash": "08cab93ba9a2d1c3a72c471dd8724efa7d820f43dad447221b445c32ebe9ab28",
     "width": 1200,
     "height": 800,
     "variants": [
       {
-        "src": "/images/generated/routes/030-text-forward/images/text-forward/grey-street-dog-08cab93b-480.webp",
+        "src": "/images/generated/routes/030-project/images/project/grey-street-dog-08cab93b-480.webp",
         "width": 480
       },
       {
-        "src": "/images/generated/routes/030-text-forward/images/text-forward/grey-street-dog-08cab93b-768.webp",
+        "src": "/images/generated/routes/030-project/images/project/grey-street-dog-08cab93b-768.webp",
         "width": 768
       },
       {
-        "src": "/images/generated/routes/030-text-forward/images/text-forward/grey-street-dog-08cab93b-1080.webp",
+        "src": "/images/generated/routes/030-project/images/project/grey-street-dog-08cab93b-1080.webp",
         "width": 1080
       },
       {
-        "src": "/images/generated/routes/030-text-forward/images/text-forward/grey-street-dog-08cab93b-1200.webp",
+        "src": "/images/generated/routes/030-project/images/project/grey-street-dog-08cab93b-1200.webp",
         "width": 1200
       }
     ]

package/examples/feature-demos/theme-presets/site/config.md

@@ -0,0 +1,3 @@
+---
+url: http://localhost:4321/
+---

package/examples/feature-demos/theme-presets/site/content.md

@@ -0,0 +1,17 @@
+---
+title: Theme Presets
+description: Compare Norna's complete built-in theme presets without overrides.
+navigation:
+  label: Presets
+---
+
+## Theme presets {#theme-presets}
+
+Each route selects one complete theme preset without overrides. The comparison
+therefore includes layout, typography, palette, section surfaces and managed
+image presentation:
+
+* [Portfolio](/portfolio/)
+* [Documentation](/documentation/)
+* [Project](/project/)
+* [Statement](/statement/)

package/examples/{typography-presets/site/routes/010-quiet-gallery → feature-demos/theme-presets/site/routes/010-portfolio}/route-content.md

@@ -1,21 +1,21 @@
 ---
-title: Quiet Gallery
-description: A restrained typography preset for image-led pages.
+title: Portfolio
+description: A complete theme preset for image-led portfolios and presentations.
 navigation:
-  label: Quiet Gallery
+  label: Portfolio
 ---
 
-## Quiet Gallery {#quiet-gallery}
+## Portfolio {#portfolio}
 
-This route uses the `quiet-gallery` preset. Its purpose is to keep text
-restrained so images can carry much of the page without the typography
-competing for attention.
+This route uses the complete `portfolio` preset without overrides. It gives
+images a broad stage, keeps typography restrained and uses a dark palette for
+an image-led presentation.
 
 Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a
 ante venenatis dapibus posuere velit aliquet. Maecenas faucibus mollis
 interdum. Donec ullamcorper nulla non metus auctor fringilla.
 
-### Reading rhythm
+### Image-led rhythm
 
 Curabitur blandit tempus porttitor. Praesent commodo cursus magna, vel
 scelerisque nisl consectetur et. Vestibulum id ligula porta felis euismod

package/examples/feature-demos/theme-presets/site/routes/010-portfolio/theme.md

@@ -0,0 +1,3 @@
+---
+preset: portfolio
+---

package/examples/{typography-presets/site/routes/020-compact-gallery → feature-demos/theme-presets/site/routes/020-documentation}/route-content.md

@@ -1,20 +1,20 @@
 ---
-title: Compact Gallery
-description: A compact typography preset for dense image-led pages.
+title: Documentation
+description: A complete theme preset for guides and explanatory writing.
 navigation:
-  label: Compact Gallery
+  label: Documentation
 ---
 
-## Compact Gallery {#compact-gallery}
+## Documentation {#documentation}
 
-This route uses the `compact-gallery` preset. Its purpose is to make denser
-image-led pages easier to scan when a site contains many sections, many images
-or short information blocks.
+This route uses the complete `documentation` preset without overrides. It
+favours readable explanatory text, compact vertical rhythm and restrained
+surface changes for longer guides.
 
 Lorem ipsum dolor sit amet, consectetur adipiscing elit. Aenean lacinia
 bibendum nulla sed consectetur. Etiam porta sem malesuada magna mollis euismod.
 
-### Dense sections
+### Reading rhythm
 
 Nullam id dolor id nibh ultricies vehicula ut id elit. Fusce dapibus, tellus ac
 cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit

package/examples/feature-demos/theme-presets/site/routes/020-documentation/theme.md

@@ -0,0 +1,3 @@
+---
+preset: documentation
+---

package/examples/{typography-presets/site/routes/030-text-forward → feature-demos/theme-presets/site/routes/030-project}/route-content.md

@@ -1,21 +1,21 @@
 ---
-title: Text Forward
-description: A typography preset for explanatory writing.
+title: Project
+description: A complete theme preset for project and product websites.
 navigation:
-  label: Text Forward
+  label: Project
 ---
 
-## Text Forward {#text-forward}
+## Project {#project}
 
-This route uses the `text-forward` preset. Its purpose is to give longer
-explanatory text more presence while still supporting image captions and
-image-led sections.
+This route uses the complete `project` preset without overrides. It provides a
+compact, neutral presentation for project overviews, feature descriptions and
+practical documentation.
 
 Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed posuere
 consectetur est at lobortis. Cras mattis consectetur purus sit amet fermentum.
 Vivamus sagittis lacus vel augue laoreet rutrum faucibus dolor auctor.
 
-### Longer explanations
+### Practical explanations
 
 Morbi leo risus, porta ac consectetur ac, vestibulum at eros. Donec sed odio
 dui. Duis mollis, est non commodo luctus, nisi erat porttitor ligula, eget

package/examples/feature-demos/theme-presets/site/routes/030-project/theme.md

@@ -0,0 +1,3 @@
+---
+preset: project
+---

package/examples/{typography-presets → feature-demos/theme-presets}/site/routes/040-statement/route-content.md

@@ -7,9 +7,9 @@ navigation:
 
 ## Statement {#statement}
 
-This route uses the `statement` preset. Its purpose is to make short,
-declarative sections feel more direct and programmatic. It is intentionally
-stronger than the other presets and should usually be used sparingly.
+This route uses the complete `statement` preset without overrides. Its airy
+layout, stronger typography and alternating surfaces suit short, declarative
+content with a more editorial voice.
 
 Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec id elit non mi
 porta gravida at eget metus. Integer posuere erat a ante venenatis dapibus

package/examples/feature-demos/theme-presets/site/routes/040-statement/theme.md

@@ -0,0 +1,3 @@
+---
+preset: statement
+---

package/examples/{typography-presets → feature-demos/theme-presets}/site/sitewide-content.md

@@ -1,6 +1,6 @@
 ---
 navigation:
-  brand: Typography Presets
+  brand: Theme Presets
 footer:
   copyrightMessage: Dog photos by Bicanski, CC0, via Pixnio.
   buildInfo:

package/examples/feature-demos/theme-presets/site/theme.md

@@ -0,0 +1,3 @@
+---
+preset: project
+---

package/fixtures/basic/site/config.md

@@ -0,0 +1,3 @@
+---
+url: https://example.com/
+---

package/fixtures/content-model-v2/site/config.md

@@ -0,0 +1,3 @@
+---
+url: https://example.com/
+---

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@janga/norna",
-  "description": "A command-line publishing workflow for simple static sites.",
+  "description": "An opinionated CLI for building responsive websites from Markdown, images, and theme presets.",
   "type": "module",
-  "version": "0.7.10",
+  "version": "0.7.12",
   "license": "GPL-3.0-only",
   "repository": {
     "type": "git",
@@ -11,11 +11,13 @@
   "bugs": {
     "url": "https://github.com/janga/norna/issues"
   },
-  "homepage": "https://github.com/janga/norna#readme",
+  "homepage": "https://janga.github.io/norna/",
   "keywords": [
-    "astro",
-    "gallery",
-    "static-site",
+    "static-site-generator",
+    "website-builder",
+    "markdown",
+    "responsive-images",
+    "github-pages",
     "cli"
   ],
   "bin": {
@@ -51,27 +53,34 @@
     "config:check": "node bin/norna.mjs config:check",
     "content:check": "node bin/norna.mjs content:check",
     "content:sync": "node bin/norna.mjs content:sync",
+    "theme:export": "node bin/norna.mjs theme:export",
     "typography:presets": "node bin/norna.mjs typography presets",
     "typography:show": "node bin/norna.mjs typography show",
     "site:public": "node bin/norna.mjs site:public",
     "images": "node bin/norna.mjs images",
     "build": "node bin/norna.mjs build",
+    "build:pages": "node scripts/build-pages.mjs",
     "build:local": "node bin/norna.mjs build:local",
     "deploy": "node bin/norna.mjs deploy",
     "deploy:commit": "node bin/norna.mjs deploy:commit",
     "deploy:watch": "node bin/norna.mjs deploy:watch",
     "doctor": "node bin/norna.mjs doctor",
-    "demo:build": "node bin/norna.mjs --site-dir examples/dog-gallery/site build",
-    "test": "npm run test:route-model && npm run test:content-check && npm run test:content-model-v2 && npm run test:site-public && npm run test:cli-discovery && npm run test:engine-commands && npm run test:ci-lockfile && npm run test:temporary-visibility && npm run test:fixture:build && npm run package:check",
+    "demo:build": "node bin/norna.mjs --site-dir examples/feature-demos/media-and-surfaces/site build",
+    "test": "npm run test:route-model && npm run test:project-config && npm run test:content-check && npm run test:content-model-v2 && npm run test:theme-presets && npm run test:site-public && npm run test:cli-discovery && npm run test:engine-commands && npm run test:documentation && npm run test:ci-lockfile && npm run test:temporary-visibility && npm run test:client-javascript && npm run test:fixture:build && npm run test:examples && npm run package:check",
     "test:fixture:build": "node bin/norna.mjs --site-dir fixtures/basic/site build",
+    "test:examples": "node scripts/test-examples.mjs",
     "test:route-model": "node scripts/test-route-model.mjs",
+    "test:project-config": "node scripts/test-project-config.mjs",
     "test:content-check": "node scripts/test-content-check.mjs",
     "test:content-model-v2": "node scripts/test-content-model-v2.mjs",
+    "test:theme-presets": "node scripts/test-theme-presets.mjs",
     "test:site-public": "node scripts/test-site-public.mjs",
     "test:cli-discovery": "node scripts/test-cli-discovery.mjs",
     "test:engine-commands": "node scripts/test-engine-commands.mjs",
+    "test:documentation": "node scripts/test-documentation.mjs",
     "test:ci-lockfile": "node scripts/test-ci-lockfile.mjs",
     "test:temporary-visibility": "node scripts/test-temporary-visibility.mjs",
+    "test:client-javascript": "node scripts/test-client-javascript.mjs",
     "test:navigation": "node scripts/test-navigation.mjs",
     "test:navigation:stress": "node scripts/test-navigation.mjs tests/navigation-stress.spec.ts",
     "test:navigation:preview": "node scripts/test-navigation-preview.mjs",

package/scripts/build-pages.mjs

@@ -0,0 +1,69 @@
+import { cp, mkdir, mkdtemp, readFile, rm } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { getExampleSites } from './lib/example-sites.mjs';
+import projectConfig from './lib/project-config.mjs';
+import { runInherit } from './lib/run-command.mjs';
+
+const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
+const cliPath = path.join(root, 'bin', 'norna.mjs');
+const distDirectory = path.join(root, 'dist');
+const temporaryDirectory = await mkdtemp(path.join(tmpdir(), 'norna-pages-'));
+const artifactDirectory = path.join(temporaryDirectory, 'artifact');
+const documentationUrl = new URL(projectConfig.site.url);
+const documentationBasePath = projectConfig.site.basePath;
+const examples = await getExampleSites(root);
+let artifactStarted = false;
+
+const buildSite = (siteLabel, env = process.env) => runInherit(
+	process.execPath,
+	[cliPath, ...(siteLabel ? ['--site-dir', siteLabel] : []), 'build'],
+	{ cwd: root, env },
+);
+
+try {
+	console.log('Building documentation site');
+	await buildSite();
+	await cp(distDirectory, artifactDirectory, { recursive: true });
+	artifactStarted = true;
+
+	for (const example of examples) {
+		const relativePublicPath = `examples/${example.category}/${example.name}/`;
+		const siteUrl = new URL(relativePublicPath, documentationUrl).href;
+
+		console.log(`\nBuilding ${example.siteLabel} for ${siteUrl}`);
+		await buildSite(example.siteLabel, {
+			...process.env,
+			NORNA_SITE_URL: siteUrl,
+		});
+
+		const destination = path.join(artifactDirectory, relativePublicPath);
+		await mkdir(path.dirname(destination), { recursive: true });
+		await cp(distDirectory, destination, { recursive: true });
+	}
+} finally {
+	if (artifactStarted) {
+		await rm(distDirectory, { recursive: true, force: true });
+		await cp(artifactDirectory, distDirectory, { recursive: true });
+	}
+	await rm(temporaryDirectory, { recursive: true, force: true });
+}
+
+const documentationExamplesHtml = await readFile(path.join(distDirectory, 'examples', 'index.html'), 'utf8');
+
+for (const example of examples) {
+	const relativePublicPath = `examples/${example.category}/${example.name}/`;
+	const basePath = `${documentationBasePath.replace(/\/$/, '')}/${relativePublicPath}`;
+	const siteUrl = new URL(relativePublicPath, documentationUrl).href;
+	const exampleHtml = await readFile(path.join(distDirectory, relativePublicPath, 'index.html'), 'utf8');
+
+	if (!documentationExamplesHtml.includes(`href="${siteUrl}"`)) {
+		throw new Error(`Documentation is missing the rendered example link ${siteUrl}.`);
+	}
+	if (!exampleHtml.includes(`href="${basePath}`) && !exampleHtml.includes(`src="${basePath}`)) {
+		throw new Error(`Rendered example ${relativePublicPath} does not use its deployment base path ${basePath}.`);
+	}
+}
+
+console.log(`\nok - assembled documentation and ${examples.length} rendered examples in dist/`);

package/scripts/check-config.mjs

@@ -4,13 +4,6 @@ import { readSitewideConfig } from './lib/sitewide-config.mjs';
 import { readThemeConfig, validateRouteThemeFiles } from './lib/theme-config.mjs';
 
 const formatErrorMessage = (error) => {
-	if (error instanceof SyntaxError) {
-		return [
-			`${siteConfigLabel} contains invalid JavaScript syntax.`,
-			error.message,
-		].join('\n');
-	}
-
 	if (error instanceof Error) {
 		return error.message;
 	}
@@ -20,7 +13,7 @@ const formatErrorMessage = (error) => {
 
 try {
 	const { projectConfig } = await import('./lib/project-config.mjs');
-	await readThemeConfig();
+	const themeConfig = await readThemeConfig();
 	const sitewideConfig = await readSitewideConfig();
 	await validateRouteThemeFiles();
 	const logoAssets = getLogoAssets();
@@ -42,6 +35,7 @@ try {
 	console.log('Config check passed.');
 	console.log(`Site URL: ${projectConfig.site.url}`);
 	console.log(`Base path: ${projectConfig.site.basePath}`);
+	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(`Layout density: ${projectConfig.layout.density}`);
@@ -50,9 +44,7 @@ try {
 	console.log(`Image max available height: desktop ${projectConfig.gallery.maxAvailableHeightPercent.desktop}%, mobile ${projectConfig.gallery.maxAvailableHeightPercent.mobile}%`);
 	console.log(`Font family: ${projectConfig.typography.fontFamily}`);
 	console.log(`Language: ${projectConfig.locale.lang}`);
-	console.log(`GitHub repo: ${projectConfig.github.repo}`);
-	console.log(`Deploy branch: ${projectConfig.github.branch}`);
-	console.log(`Pages workflow: ${projectConfig.github.pagesWorkflow}`);
+	console.log(`Scroll behavior: ${projectConfig.navigation.scrollBehavior}`);
 } catch (error) {
 	console.error('Config check failed.');
 	console.error(formatErrorMessage(error));