@janga/norna 0.7.0 → 0.7.2

package/examples/dog-gallery/site/.norna/generated-images.json

@@ -0,0 +1,226 @@
+{
+  "black-puppy-meadow.png": {
+    "outputVersion": 2,
+    "sourceHash": "7255e3d9148c1ded01ae6ae6809b9a8261b553a1516d3f8f4de0554bc321f652",
+    "width": 1536,
+    "height": 1024,
+    "variants": [
+      {
+        "src": "/images/generated/black-dogs/black-puppy-meadow-7255e3d9-480.webp",
+        "width": 480
+      },
+      {
+        "src": "/images/generated/black-dogs/black-puppy-meadow-7255e3d9-768.webp",
+        "width": 768
+      },
+      {
+        "src": "/images/generated/black-dogs/black-puppy-meadow-7255e3d9-1080.webp",
+        "width": 1080
+      },
+      {
+        "src": "/images/generated/black-dogs/black-puppy-meadow-7255e3d9-1440.webp",
+        "width": 1440
+      },
+      {
+        "src": "/images/generated/black-dogs/black-puppy-meadow-7255e3d9-1536.webp",
+        "width": 1536
+      }
+    ]
+  },
+  "photo-of-a-black-dog.jpg": {
+    "outputVersion": 2,
+    "sourceHash": "5cf614d2863ca8f86b6162c7b477fd2690adbc101816206c9e675bf36d9962d0",
+    "width": 960,
+    "height": 1600,
+    "variants": [
+      {
+        "src": "/images/generated/black-dogs/photo-of-a-black-dog-5cf614d2-480.webp",
+        "width": 480
+      },
+      {
+        "src": "/images/generated/black-dogs/photo-of-a-black-dog-5cf614d2-768.webp",
+        "width": 768
+      },
+      {
+        "src": "/images/generated/black-dogs/photo-of-a-black-dog-5cf614d2-960.webp",
+        "width": 960
+      }
+    ]
+  },
+  "brown-dog.jpg": {
+    "outputVersion": 2,
+    "sourceHash": "50ef114e49ae48491c015157b4a25f4f1fd69140170fe6d4202c551858c3e03d",
+    "width": 3939,
+    "height": 2626,
+    "variants": [
+      {
+        "src": "/images/generated/brown-dogs/brown-dog-50ef114e-480.webp",
+        "width": 480
+      },
+      {
+        "src": "/images/generated/brown-dogs/brown-dog-50ef114e-768.webp",
+        "width": 768
+      },
+      {
+        "src": "/images/generated/brown-dogs/brown-dog-50ef114e-1080.webp",
+        "width": 1080
+      },
+      {
+        "src": "/images/generated/brown-dogs/brown-dog-50ef114e-1440.webp",
+        "width": 1440
+      },
+      {
+        "src": "/images/generated/brown-dogs/brown-dog-50ef114e-1920.webp",
+        "width": 1920
+      },
+      {
+        "src": "/images/generated/brown-dogs/brown-dog-50ef114e-3939.webp",
+        "width": 3939
+      }
+    ]
+  },
+  "dog-accompanies-master.jpg": {
+    "outputVersion": 2,
+    "sourceHash": "7ef804d5ebe27724409f4ffa94389c7b1102c2c8bb9c1dae29ecbd4c56e61af9",
+    "width": 2400,
+    "height": 1800,
+    "variants": [
+      {
+        "src": "/images/generated/brown-dogs/dog-accompanies-master-7ef804d5-480.webp",
+        "width": 480
+      },
+      {
+        "src": "/images/generated/brown-dogs/dog-accompanies-master-7ef804d5-768.webp",
+        "width": 768
+      },
+      {
+        "src": "/images/generated/brown-dogs/dog-accompanies-master-7ef804d5-1080.webp",
+        "width": 1080
+      },
+      {
+        "src": "/images/generated/brown-dogs/dog-accompanies-master-7ef804d5-1440.webp",
+        "width": 1440
+      },
+      {
+        "src": "/images/generated/brown-dogs/dog-accompanies-master-7ef804d5-1920.webp",
+        "width": 1920
+      },
+      {
+        "src": "/images/generated/brown-dogs/dog-accompanies-master-7ef804d5-2400.webp",
+        "width": 2400
+      }
+    ]
+  },
+  "golden-retriever.jpg": {
+    "outputVersion": 2,
+    "sourceHash": "f797fd880d6c3b112ceb3408f468fbeaf442efc792f935fd6c9954b812fdc838",
+    "width": 1600,
+    "height": 1200,
+    "variants": [
+      {
+        "src": "/images/generated/golden-dogs/golden-retriever-f797fd88-480.webp",
+        "width": 480
+      },
+      {
+        "src": "/images/generated/golden-dogs/golden-retriever-f797fd88-768.webp",
+        "width": 768
+      },
+      {
+        "src": "/images/generated/golden-dogs/golden-retriever-f797fd88-1080.webp",
+        "width": 1080
+      },
+      {
+        "src": "/images/generated/golden-dogs/golden-retriever-f797fd88-1440.webp",
+        "width": 1440
+      },
+      {
+        "src": "/images/generated/golden-dogs/golden-retriever-f797fd88-1600.webp",
+        "width": 1600
+      }
+    ]
+  },
+  "toller-puppy.jpg": {
+    "outputVersion": 2,
+    "sourceHash": "a2a8fbc0d599deb019d45f7b11de98bcbcb4f1fd609e931073161dcb88cbf63f",
+    "width": 2576,
+    "height": 1932,
+    "variants": [
+      {
+        "src": "/images/generated/golden-dogs/toller-puppy-a2a8fbc0-480.webp",
+        "width": 480
+      },
+      {
+        "src": "/images/generated/golden-dogs/toller-puppy-a2a8fbc0-768.webp",
+        "width": 768
+      },
+      {
+        "src": "/images/generated/golden-dogs/toller-puppy-a2a8fbc0-1080.webp",
+        "width": 1080
+      },
+      {
+        "src": "/images/generated/golden-dogs/toller-puppy-a2a8fbc0-1440.webp",
+        "width": 1440
+      },
+      {
+        "src": "/images/generated/golden-dogs/toller-puppy-a2a8fbc0-1920.webp",
+        "width": 1920
+      },
+      {
+        "src": "/images/generated/golden-dogs/toller-puppy-a2a8fbc0-2576.webp",
+        "width": 2576
+      }
+    ]
+  },
+  "white-cute-dog.jpg": {
+    "outputVersion": 2,
+    "sourceHash": "077a06891d97eafb4593cfcaa5c9b04fdb1e3a6206d56acd4ebd3eadb83356bf",
+    "width": 1277,
+    "height": 1060,
+    "variants": [
+      {
+        "src": "/images/generated/white-dogs/white-cute-dog-077a0689-480.webp",
+        "width": 480
+      },
+      {
+        "src": "/images/generated/white-dogs/white-cute-dog-077a0689-768.webp",
+        "width": 768
+      },
+      {
+        "src": "/images/generated/white-dogs/white-cute-dog-077a0689-1080.webp",
+        "width": 1080
+      },
+      {
+        "src": "/images/generated/white-dogs/white-cute-dog-077a0689-1277.webp",
+        "width": 1277
+      }
+    ]
+  },
+  "white-puppy-garden.png": {
+    "outputVersion": 2,
+    "sourceHash": "d3ab2ca04fb37dfbf010e7f9f3adf2ba8401553bd1946e3b388cb662eac58ee9",
+    "width": 1536,
+    "height": 1024,
+    "variants": [
+      {
+        "src": "/images/generated/white-dogs/white-puppy-garden-d3ab2ca0-480.webp",
+        "width": 480
+      },
+      {
+        "src": "/images/generated/white-dogs/white-puppy-garden-d3ab2ca0-768.webp",
+        "width": 768
+      },
+      {
+        "src": "/images/generated/white-dogs/white-puppy-garden-d3ab2ca0-1080.webp",
+        "width": 1080
+      },
+      {
+        "src": "/images/generated/white-dogs/white-puppy-garden-d3ab2ca0-1440.webp",
+        "width": 1440
+      },
+      {
+        "src": "/images/generated/white-dogs/white-puppy-garden-d3ab2ca0-1536.webp",
+        "width": 1536
+      }
+    ]
+  }
+}

package/examples/dog-gallery/site/config.mjs

@@ -0,0 +1,97 @@
+const siteUrl = 'http://localhost:4321/';
+
+export default {
+	site: {
+		// Public canonical URL for this site.
+		url: siteUrl,
+
+		// URL path prefix. Use "/" for root sites and "/repository-name/" for
+		// GitHub Pages project sites without a custom domain.
+		basePath: '/',
+	},
+	layout: {
+		// Maximum width of the page content area.
+		pageWidth: '2048px',
+
+		// Side margin on desktop and mobile before available gallery width is calculated.
+		gutter: {
+			desktop: 'clamp(1.25rem, 4vw, 3rem)',
+			mobile: '16px',
+		},
+	},
+	gallery: {
+		// Hard maximum rendered gallery width for images and aligned text.
+		width: '55vw',
+
+		// Maximum share of the available width after gutters.
+		maxAvailableWidthPercent: {
+			desktop: 100,
+			mobile: 100,
+		},
+
+		// Maximum share of viewport height used by gallery images.
+		maxAvailableHeightPercent: {
+			desktop: 74,
+			mobile: 68,
+		},
+	},
+	typography: {
+		// CSS font-family stack used by the whole site, including sticky navigation.
+		fontFamily: "Arial, 'Helvetica Neue', Helvetica, sans-serif",
+	},
+		navigation: {
+			smoothScroll: {
+			// Set to false to make section links jump directly to the target anchor.
+			enabled: true,
+
+			// Minimum and maximum animation time for controlled anchor navigation.
+			minimumDurationMs: 2_000,
+			maximumDurationMs: 4_000,
+
+			// Additional duration per pixel of scroll distance, before min/max clamping.
+			durationPerPixelMs: 0.22,
+			},
+		},
+		locale: {
+			lang: 'en',
+			labels: {
+				skipToContent: 'Skip to content',
+				sectionNavigation: 'Sections',
+				gallery: 'Gallery',
+			},
+		},
+		footer: {
+		// Omit this value to hide the copyright sentence.
+		copyrightMessage: 'Dog images from Wikimedia Commons; see image captions for license details.',
+
+		// Set enabled to false to hide the build timestamp while keeping its config.
+		buildInfo: {
+			enabled: true,
+
+			// Text shown before the formatted build timestamp.
+			text: 'Built',
+
+			// Standard Intl.DateTimeFormat options for the build timestamp.
+			dateTimeFormat: {
+				locale: 'en-GB',
+				timeZone: 'UTC',
+				dateStyle: 'short',
+				timeStyle: 'short',
+			},
+		},
+	},
+	github: {
+		// Example repository and workflow details used by deploy scripts.
+		repo: 'owner/example-gallery',
+		branch: 'main',
+		pagesWorkflow: 'Deploy to GitHub Pages',
+	},
+	deploy: {
+		watch: {
+			// Defaults for npm run deploy:watch.
+			intervalMs: 10_000,
+			timeoutMs: 15 * 60_000,
+			runLimit: 10,
+		},
+	},
+};

package/examples/dog-gallery/site/content.md

@@ -0,0 +1,146 @@
+---
+title: Local Dog Gallery
+description: A small norna example with free dog images.
+navigation:
+  label: Dog site!
+  order: 10
+sections:
+  - id: black-dogs
+    presentation:
+      typography:
+        preset: statement
+    gallery:
+      - image: photo-of-a-black-dog.jpg
+        alt: "A black dog sitting outdoors and looking at the camera."
+        caption:
+          "Photo of a dog. ContaDeletada2906, CC0 1.0, via Wikimedia Commons."
+      - image: black-puppy-meadow.png
+        alt:
+          "A black puppy standing in a grassy meadow and looking at the camera."
+        caption: "AI-generated image."
+  - id: summer-dogs
+    visible:
+      from: "2026-08-01"
+      until: "2026-09-01"
+    presentation:
+      backgroundColor: "#181818"
+      typography:
+        preset: compact-gallery
+    gallery: []
+  - id: brown-dogs
+    presentation:
+      typography:
+        preset: text-forward
+    gallery:
+      - image: brown-dog.jpg
+        alt: "A brown dog looking directly at the camera."
+        caption: "DogBrown. Frank-3, CC0 1.0, via Wikimedia Commons."
+      - image: dog-accompanies-master.jpg
+        alt: "A man walks outdoors with a dog at his side."
+        caption:
+          "Dog accompanies his master. Steve Hillebrand, U.S. Fish and Wildlife
+          Service, public domain."
+  - id: golden-dogs
+    presentation:
+      typography:
+        overrides:
+          body:
+            lineHeight: 1.58
+            paragraphSpacing: 1em
+    gallery:
+      - image: golden-retriever.jpg
+        alt: "A golden retriever standing outdoors."
+        caption: "Golden Retriever. Ribo, public domain, via Wikimedia Commons."
+      - image: toller-puppy.jpg
+        alt:
+          "A young Nova Scotia Duck Tolling Retriever puppy sitting on grass."
+        caption:
+          "Nova Scotia Duck Tolling Retriever puppy. RM, public domain, via
+          Wikimedia Commons."
+  - id: white-dogs
+    presentation:
+      typography:
+        overrides:
+          caption:
+            spacing: 0.35em
+    gallery:
+      - carousel:
+          - image: white-cute-dog.jpg
+            alt: "A white dog looking toward the camera."
+            caption:
+              "White cute dog. Neal Ziring, public domain, via Wikimedia
+              Commons."
+          - image: white-puppy-garden.png
+            alt: "A fluffy white puppy standing on grass in a garden."
+            caption: "AI-generated image."
+  - id: sources
+---
+
+## Black Dogs {#black-dogs}
+
+Black-coated dogs from the local norna development collection. This
+sentence contains [yellow highlighted text]{.highlight} for inline style
+inspection.
+
+Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a
+ante venenatis dapibus posuere velit aliquet.
+
+Curabitur blandit tempus porttitor. Donec id elit non mi porta gravida at eget
+metus. Praesent commodo cursus magna, vel scelerisque nisl consectetur et.
+
+## Summer Dogs {#summer-dogs}
+
+This temporary section is visible during August 2026. It is here to demonstrate
+date-controlled sections and [warm alert text]{.alert} in the local dog gallery.
+
+Lorem ipsum dolor sit amet.
+
+Vestibulum id ligula porta felis euismod semper. Maecenas faucibus mollis
+interdum. Nullam quis risus eget urna mollis ornare vel eu leo.
+
+## Brown Dogs {#brown-dogs}
+
+Brown dogs provide a second gallery section for local navigation checks.
+
+Donec ullamcorper nulla non metus auctor fringilla. Fusce dapibus, tellus ac
+cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit
+amet risus.
+
+Maecenas sed diam eget risus varius blandit sit amet non magna. Morbi leo risus,
+porta ac consectetur ac, vestibulum at eros. Sed posuere consectetur est at
+lobortis.
+
+## Golden Dogs {#golden-dogs}
+
+Golden-coated retrievers add a third gallery section and more scrolling depth.
+
+Cras justo odio, dapibus ac facilisis in, egestas eget quam.
+
+Nulla vitae elit libero, a pharetra augue. Integer posuere erat a ante venenatis
+dapibus posuere velit aliquet. Aenean eu leo quam. Pellentesque ornare sem
+lacinia quam venenatis vestibulum.
+
+## White Dogs {#white-dogs}
+
+A white dog completes the colour-based gallery sequence.
+
+Etiam porta sem malesuada magna mollis euismod. Donec id elit non mi porta
+gravida at eget metus.
+
+Praesent commodo cursus magna, vel scelerisque nisl consectetur et. Lorem ipsum
+dolor sit amet, consectetur adipiscing elit. Donec sed odio dui. Vestibulum id
+ligula porta felis euismod semper.
+
+## Sources {#sources}
+
+Most images are sourced from Wikimedia Commons pages that list CC0 or
+public-domain licensing:
+
+- [Photo of a dog](https://commons.wikimedia.org/wiki/File:Photo_of_a_dog.jpg)
+- [DogBrown](https://commons.wikimedia.org/wiki/File:DogBrown.jpg)
+- [Dog accompanies his master](https://commons.wikimedia.org/wiki/File:Dog_accompanies_his_master.jpg)
+- [Golden Retriever](https://commons.wikimedia.org/wiki/File:Golden_Retriever.jpg)
+- [Toller pup7wks2](https://commons.wikimedia.org/wiki/File:Toller_pup7wks2.JPG)
+- [White cute dog](https://commons.wikimedia.org/wiki/File:White_cute_dog.jpg)
+
+The black and white puppy images are AI-generated.

package/examples/dog-gallery/site/public/favicon.svg

@@ -0,0 +1,7 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 128 128">
+	<rect width="128" height="128" rx="24" fill="#111111" />
+	<circle cx="40" cy="43" r="13" fill="#ffffff" />
+	<circle cx="64" cy="34" r="13" fill="#ffffff" />
+	<circle cx="88" cy="43" r="13" fill="#ffffff" />
+	<path fill="#ffffff" d="M31 83c0-18 15-31 33-31s33 13 33 31c0 12-9 18-20 14-7-3-19-3-26 0-11 4-20-2-20-14Z" />
+</svg>

package/examples/dog-gallery/site/public/robots.txt

@@ -0,0 +1,2 @@
+User-agent: *
+Allow: /

package/examples/dog-gallery/site/routes/dog-care/route-content.md

@@ -0,0 +1,35 @@
+---
+title: Dog care
+description: A small route for testing multi-page norna navigation.
+navigation:
+  label: Dog care
+  order: 20
+sections:
+  - id: daily-rhythm
+  - id: calm-training
+  - id: gallery-notes
+---
+
+## Daily rhythm {#daily-rhythm}
+
+Dogs often settle into a home when the day has a clear rhythm. Meals, walks,
+rest and play do not need to be dramatic events, but they become easier to
+understand when they happen in a predictable order.
+
+Short routines also make a gallery page easier to scan. This route exists mainly
+to test how page navigation and site navigation behave together.
+
+## Calm training {#calm-training}
+
+Good training can be quiet. A short session with one clear task is often more
+useful than a long session with many competing signals.
+
+The same principle applies to navigation. The page should show where the visitor
+is in the site first, and then offer a simple way to jump within the current
+page.
+
+## Gallery notes {#gallery-notes}
+
+This section is intentionally text-only. Image routes can be added later, but a
+first navigation test should make it easy to judge menus, active states and
+anchor positions without layout noise from new media.

package/examples/dog-gallery/site/theme.md

@@ -0,0 +1,55 @@
+---
+# norna:start theme-help
+# Site-wide visual defaults. Remove a value to use the engine default.
+# Active values below are ordinary YAML; this marked comment block is only help text.
+#
+# Available structure:
+# presentation:
+#   backgroundColor: quoted hex color, e.g. "#000000"
+#   textColor: quoted hex color, e.g. "#f7f4ee"
+#   inlineStyles:
+#     style-name:
+#       color: quoted hex color
+#   typography:
+#     preset: quiet-gallery | compact-gallery | text-forward | statement
+#     overrides:
+#       heading:
+#         align:
+#           desktop: left | center | right
+#           mobile: left | center | right
+#         size: small | medium | large | xlarge
+#         lineHeight: number from 1 through 3
+#         spacing: CSS length, e.g. 0.65em
+#       body:
+#         align:
+#           desktop: left | center | right
+#           mobile: left | center | right
+#         size: small | medium | large | xlarge
+#         lineHeight: number from 1 through 3
+#         paragraphSpacing: CSS length, e.g. 0.85em
+#       caption:
+#         align:
+#           desktop: left | center | right
+#           mobile: left | center | right
+#         size: small | medium | large | xlarge
+#         lineHeight: number from 1 through 3
+#         spacing: CSS length, e.g. 0.5em
+# frame:
+#   colors: presentation | theme
+#   colors:
+#     backgroundColor: quoted hex color
+#     textColor: quoted hex color
+# norna:end theme-help
+presentation:
+  backgroundColor: "#550000"
+  textColor: "#ffffff"
+  inlineStyles:
+    highlight:
+      color: "#ffd84d"
+    alert:
+      color: "#ff9a3d"
+  typography:
+    preset: quiet-gallery
+frame:
+  colors: presentation
+---

package/fixtures/basic/site/config.mjs

@@ -1,6 +1,7 @@
 export default {
 	site: {
 		url: 'https://example.com/',
+		basePath: '/',
 	},
 	layout: {
 		pageWidth: '1180px',

package/package.json

@@ -2,7 +2,7 @@
   "name": "@janga/norna",
   "description": "A command-line publishing workflow for simple static sites.",
   "type": "module",
-  "version": "0.7.0",
+  "version": "0.7.2",
   "license": "GPL-3.0-only",
   "repository": {
     "type": "git",
@@ -25,6 +25,7 @@
     "astro.config.mjs",
     "bin/",
     "docs/",
+    "examples/",
     "fixtures/",
     "scripts/",
     "src/",
@@ -40,8 +41,8 @@
     "node": ">=22.12.0"
   },
   "scripts": {
-    "dev": "npm run dev:local",
-    "dev:local": "npm run demo:dev",
+    "dev": "npm run dev:local --",
+    "dev:local": "node bin/norna.mjs dev:local",
     "dev:lan": "node bin/norna.mjs dev:lan",
     "dev:restart": "node bin/norna.mjs dev:restart",
     "dev:status": "node bin/norna.mjs dev:status",
@@ -54,18 +55,18 @@
     "typography:show": "node bin/norna.mjs typography:show",
     "site:public": "node bin/norna.mjs site:public",
     "images": "node bin/norna.mjs images",
-    "build": "npm run demo:build",
+    "build": "node bin/norna.mjs build",
     "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:dev": "node bin/norna.mjs dev:local",
-    "demo:build": "node bin/norna.mjs build",
-    "test": "npm run test:content-check && npm run test:site-public && npm run test:engine-commands && npm run test:ci-lockfile && npm run test:temporary-visibility && npm run test:fixture:build && npm run demo:build && npm run package:check",
+    "demo:build": "node bin/norna.mjs --site-dir examples/dog-gallery/site build",
+    "test": "npm run test:content-check && 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",
     "test:fixture:build": "node bin/norna.mjs --site-dir fixtures/basic/site build",
     "test:content-check": "node scripts/test-content-check.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:ci-lockfile": "node scripts/test-ci-lockfile.mjs",
     "test:temporary-visibility": "node scripts/test-temporary-visibility.mjs",

package/scripts/check-config.mjs

@@ -20,6 +20,7 @@ try {
 
 	console.log('Config check passed.');
 	console.log(`Site URL: ${projectConfig.site.url}`);
+	console.log(`Base path: ${projectConfig.site.basePath}`);
 	console.log(`Page width: ${projectConfig.layout.pageWidth}`);
 	console.log(`Gutter: desktop ${projectConfig.layout.gutter.desktop}, mobile ${projectConfig.layout.gutter.mobile}`);
 	console.log(`Gallery width: ${projectConfig.gallery.width}`);