@janga/norna 0.7.10 → 0.7.12

package/docs/theme.md

@@ -2,48 +2,90 @@
 
 `site/theme.md` defines the site-wide visual theme for a `norna` site. It uses
 YAML frontmatter and does not need a Markdown body. The root theme file is
-required, but every setting inside it is optional and falls back to an engine
-default.
+required. The normal setup selects one complete theme preset and adds only
+focused overrides when needed.
 
 An optional `theme.md` inside a route directory replaces the root visual theme
-for that route. Route themes do not merge with the root theme: omitted values
-use engine defaults. Shared identity such as brand and logo remains site-wide
-and belongs in `sitewide-content.md`.
+for that route. Shared identity such as brand and logo remains site-wide and
+belongs in `sitewide-content.md`.
 
-## Minimal Theme
+## Theme Presets
+
+Available complete theme presets are:
+
+- `portfolio`: restrained typography and a broad image area for image-led
+  presentation.
+- `documentation`: reading-focused typography, a paper palette, and compact
+  structural rhythm.
+- `project`: compact layout and a light presentation for project and product
+  sites.
+- `statement`: airy spacing and stronger typography for short editorial
+  content.
+
+A normal `theme.md` can be only:
+
+```yaml
+---
+preset: documentation
+---
+```
+
+Each preset supplies coordinated values for:
+
+- layout density, page width, and gutters
+- managed image sizing
+- font family, typography preset, and typography rhythm
+- palette and section-surface behaviour
+
+The nested `typography.preset` setting documented below is a lower-level
+typography choice. A top-level theme `preset` selects the complete visual
+system, including that typography choice.
+
+## Overrides
+
+Values written beside the top-level preset override only that part of the
+preset. Other preset values remain active:
 
 ```yaml
 ---
+preset: documentation
 layout:
-  density: normal
-  pageWidth: 1180px
-  gutter:
-    desktop: clamp(1.25rem, 4vw, 3rem)
-    mobile: 1rem
-gallery:
-  width: 900px
-  maxAvailableWidthPercent:
-    desktop: 100
-    mobile: 100
-  maxAvailableHeightPercent:
-    desktop: 74
-    mobile: 68
-typography:
-  fontFamily: "Arial, 'Helvetica Neue', Helvetica, sans-serif"
-  preset: quiet-gallery
-  rhythm: normal
+  pageWidth: 1320px
 presentation:
-  palette: dark  # Alternatives: light, paper
-  sectionSurfaces:
-    mode: cycle
-    sequence: [base, soft, emphasis]
+  palette: dark
 ---
 ```
 
-Starter sites include a marked comment block such as
-`norna:start theme-help` / `norna:end theme-help`. The block is only
-explorable help text; YAML comments do not affect rendering. The active
-configuration is the uncommented YAML below it.
+Nested objects are merged by key. Arrays such as
+`presentation.sectionSurfaces.sequence` replace the preset array when they are
+specified.
+
+It is still valid to omit the top-level preset and define the visual settings
+explicitly. Omitted explicit settings then use engine defaults. This is useful
+for focused testing, but selecting a complete preset is the simpler normal
+workflow.
+
+## Export A Preset
+
+Export the installed definition of a preset before choosing overrides:
+
+```sh
+norna theme:export documentation
+```
+
+In a generated site, the equivalent npm command is:
+
+```sh
+npm run norna:theme:export -- documentation
+```
+
+The command creates `site/orig-documentation-theme.md`, or the corresponding
+path under the selected site directory. The file contains the preset values,
+comments describing accepted alternatives, and an example of a fine-grained
+typography override.
+
+Norna never loads `orig-*-theme.md`; only `theme.md` is active. The export
+command refuses to overwrite an existing reference file.
 
 Site identity is not part of the visual theme. Define the optional navigation
 brand and logo settings in `site/sitewide-content.md`; see [Sitewide Content](sitewide-content.md).
@@ -203,11 +245,39 @@ visual expression:
 site/routes/010-guide/theme.md
 ```
 
-The route theme uses the same visual schema as the root theme. It completely
-replaces the root visual theme for that route, so include every non-default
-visual choice the route needs. It cannot define navigation, brand, logo, or
+The route theme uses the same visual schema and complete presets as the root
+theme. A route can therefore select a different expression without repeating a
+large configuration:
+
+```yaml
+---
+preset: statement
+---
+```
+
+It completely replaces the root visual theme for that route. If the route
+theme selects no top-level preset, omitted values use engine defaults rather
+than values from the root theme. It cannot define navigation, brand, logo, or
 technical configuration.
 
 Section surfaces render as full-width horizontal bands while the section
 content keeps the normal page and image widths. Links keep the palette's global
 accent color.
+
+## Common Questions
+
+### Should every route select its own preset?
+
+No. A route without its own `theme.md` inherits the root theme, which is the
+normal choice when the site should keep one visual expression.
+
+Add a route theme only when the route should intentionally look different. If
+the route should keep the same preset but demonstrate a focused change, repeat
+the root preset in the route theme and override only that setting. This is
+necessary because a route theme replaces the root visual theme rather than
+merging with it.
+
+For example, a route demonstrating section surfaces may keep `preset: project`
+and change only `presentation.sectionSurfaces`. A route demonstrating media or
+content blocks should normally inherit the root preset so that the media or
+content remains the only variable being compared.

package/docs/typography.md

@@ -3,12 +3,20 @@
 `norna` typography is configured in `site/theme.md` through a site-wide font,
 presets, text rhythm, and optional overrides.
 
-The normal place to choose a site-wide typography preset and rhythm is the
-top-level `typography` block in `site/theme.md`.
-Page and section files may override the theme when a focused exception is
-needed, but the normal workflow is to keep typography in `theme.md`.
+The normal workflow is to select a complete top-level theme preset. It already
+chooses a coordinated font, typography preset, and rhythm:
 
-## Presets
+```yaml
+---
+preset: documentation
+---
+```
+
+Use the nested `typography` block only when those typographic choices need to
+differ from the selected theme preset. Typography is configured at root-theme
+or route-theme level, not in page or section content.
+
+## Typography Presets
 
 Available presets:
 
@@ -21,7 +29,9 @@ Available presets:
 - `statement`: tighter, more declarative line-height for short programmatic
   statements. Use it sparingly, usually as a page or section exception.
 
-If theme typography is omitted, `quiet-gallery` is used.
+If a complete top-level theme preset is selected, that preset supplies the
+typography choice. If both the top-level preset and nested typography are
+omitted, the engine default is `quiet-gallery`.
 
 Presets define alignment, size, weight, and line height for `headings.h1`
 through `headings.h4`, `body`, and `caption`. They also choose a readable body
@@ -142,30 +152,35 @@ Supported override fields:
 
 ## Route Themes
 
-Theme typography is the site-wide base:
+The simplest route-specific typography change is to select a complete theme
+preset:
 
 ```yaml
-# site/theme.md
-typography:
-  fontFamily: "Arial, 'Helvetica Neue', Helvetica, sans-serif"
-  preset: quiet-gallery
-  rhythm: normal
+# site/routes/010-introduction/theme.md
+---
+preset: statement
+---
 ```
 
-A route-local `theme.md` can give that route a different typographic character.
-The route theme replaces the root visual theme rather than inheriting from it,
-so repeat any non-default `fontFamily`, `rhythm`, or `overrides` that the route
-still needs.
+A route-local `theme.md` replaces the root visual theme rather than inheriting
+from it. The complete preset supplies a coherent route theme without repeating
+the root values.
 
-Example route theme:
+Use a nested typography choice when only the typographic character needs to be
+specified explicitly:
 
 ```yaml
 # site/routes/010-introduction/theme.md
+---
 typography:
   preset: statement
   rhythm: normal
+---
 ```
 
+Without a top-level theme preset, other omitted route-theme values use engine
+defaults rather than values from the root theme.
+
 The `body.width` value controls the prose column independently of the page and
 image widths. Captions are normally centered, but `text-forward` uses
 left-aligned captions to support longer explanatory text.

package/examples/README.md

@@ -0,0 +1,43 @@
+# Norna Examples
+
+These examples are source projects, visual demonstrations, and integration
+checks. Every example is built by `npm run test:examples` and published by the
+documentation workflow.
+
+| Example | Purpose | Live demo | Source |
+| --- | --- | --- | --- |
+| Dog shelter, single page | A coherent homepage made from sections | [Open site](https://janga.github.io/norna/examples/complete-sites/dog-shelter-single-page/) | [View files](complete-sites/dog-shelter-single-page/) |
+| Dog shelter, multi-page | A coherent site with ordered routes and route-local images | [Open site](https://janga.github.io/norna/examples/complete-sites/dog-shelter-multi-page/) | [View files](complete-sites/dog-shelter-multi-page/) |
+| Theme presets | All complete presets without overrides | [Open site](https://janga.github.io/norna/examples/feature-demos/theme-presets/) | [View files](feature-demos/theme-presets/) |
+| Media and surfaces | Image blocks, cards, notes, palettes, and section surfaces | [Open site](https://janga.github.io/norna/examples/feature-demos/media-and-surfaces/) | [View files](feature-demos/media-and-surfaces/) |
+| Sitewide content | Shared identity, navigation, banners, and footer content | [Open site](https://janga.github.io/norna/examples/feature-demos/sitewide-content/) | [View files](feature-demos/sitewide-content/) |
+
+## Directory Structure
+
+```text
+examples/
+|-- complete-sites/
+|   |-- dog-shelter-single-page/
+|   `-- dog-shelter-multi-page/
+`-- feature-demos/
+    |-- theme-presets/
+    |-- media-and-surfaces/
+    `-- sitewide-content/
+```
+
+`complete-sites/` contains small sites that can be read as coherent Norna
+projects. `feature-demos/` contains focused visual test benches. Feature demos
+are useful for documentation and integration checks, but are not starter
+templates.
+
+## Run An Example Locally
+
+From the Norna repository root, pass the example's `site/` directory:
+
+```sh
+node bin/norna.mjs --site-dir examples/feature-demos/media-and-surfaces/site dev:local
+```
+
+Use another path from the table to run a different example. The repository's
+GitHub Pages workflow publishes the same source projects under
+`https://janga.github.io/norna/examples/`.

package/examples/{typography-presets → complete-sites/dog-shelter-multi-page}/.astro/collections/sitewide.schema.json

@@ -2,6 +2,30 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "type": "object",
   "properties": {
+    "navigation": {
+      "type": "object",
+      "properties": {
+        "brand": {
+          "type": "string",
+          "minLength": 1
+        },
+        "logo": {
+          "type": "object",
+          "properties": {
+            "alt": {
+              "type": "string",
+              "minLength": 1
+            },
+            "height": {
+              "type": "string",
+              "pattern": "^(?:0|(?:\\d+(?:\\.\\d+)?|\\.\\d+)(?:px|rem|em|vw|vh|vmin|vmax|ch|%)|clamp\\(\\s*(?:\\d+(?:\\.\\d+)?|\\.\\d+)(?:px|rem|em|vw|vh|vmin|vmax|ch|%)\\s*,\\s*(?:\\d+(?:\\.\\d+)?|\\.\\d+)(?:px|rem|em|vw|vh|vmin|vmax|ch|%)\\s*,\\s*(?:\\d+(?:\\.\\d+)?|\\.\\d+)(?:px|rem|em|vw|vh|vmin|vmax|ch|%)\\s*\\))$"
+            }
+          },
+          "additionalProperties": false
+        }
+      },
+      "additionalProperties": false
+    },
     "banners": {
       "default": [],
       "type": "array",

package/examples/{typography-presets → complete-sites/dog-shelter-multi-page}/.astro/collections/theme.schema.json

@@ -2,6 +2,15 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "type": "object",
   "properties": {
+    "preset": {
+      "type": "string",
+      "enum": [
+        "portfolio",
+        "documentation",
+        "project",
+        "statement"
+      ]
+    },
     "layout": {
       "type": "object",
       "properties": {
@@ -738,30 +747,6 @@
       },
       "additionalProperties": false
     },
-    "navigation": {
-      "type": "object",
-      "properties": {
-        "brand": {
-          "type": "string",
-          "minLength": 1
-        },
-        "logo": {
-          "type": "object",
-          "properties": {
-            "alt": {
-              "type": "string",
-              "minLength": 1
-            },
-            "height": {
-              "type": "string",
-              "pattern": "^(?:0|(?:\\d+(?:\\.\\d+)?|\\.\\d+)(?:px|rem|em|vw|vh|vmin|vmax|ch|%)|clamp\\(\\s*(?:\\d+(?:\\.\\d+)?|\\.\\d+)(?:px|rem|em|vw|vh|vmin|vmax|ch|%)\\s*,\\s*(?:\\d+(?:\\.\\d+)?|\\.\\d+)(?:px|rem|em|vw|vh|vmin|vmax|ch|%)\\s*,\\s*(?:\\d+(?:\\.\\d+)?|\\.\\d+)(?:px|rem|em|vw|vh|vmin|vmax|ch|%)\\s*\\))$"
-            }
-          },
-          "additionalProperties": false
-        }
-      },
-      "additionalProperties": false
-    },
     "$schema": {
       "type": "string"
     }

package/examples/{dog-gallery → complete-sites/dog-shelter-multi-page}/.astro/content.d.ts

@@ -132,6 +132,14 @@ declare module 'astro:content' {
   rendered?: RenderedContent;
   filePath?: string;
 }>;
+"sitewide": Record<string, {
+  id: string;
+  body?: string;
+  collection: "sitewide";
+  data: InferEntrySchema<"sitewide">;
+  rendered?: RenderedContent;
+  filePath?: string;
+}>;
 "theme": Record<string, {
   id: string;
   body?: string;
@@ -170,6 +178,6 @@ declare module 'astro:content' {
 		LiveContentConfig['collections'][C]['loader']
 	>;
 
-	export type ContentConfig = typeof import("../../../src/content.config.js");
+	export type ContentConfig = typeof import("../../../../src/content.config.js");
 	export type LiveContentConfig = never;
 }

package/examples/complete-sites/dog-shelter-multi-page/.astro/data-store.json

@@ -0,0 +1 @@
+[["Map",1,2,9,10,72,73,98,99],"meta::meta",["Map",3,4,5,6,7,8],"astro-config-digest","{\"root\":{},\"srcDir\":{},\"publicDir\":{},\"outDir\":{},\"cacheDir\":{},\"compressHTML\":\"jsx\",\"base\":\"/\",\"trailingSlash\":\"ignore\",\"output\":\"static\",\"scopedStyleStrategy\":\"attribute\",\"build\":{\"format\":\"directory\",\"client\":{},\"server\":{},\"assets\":\"_astro\",\"serverEntry\":\"entry.mjs\",\"redirects\":true,\"inlineStylesheets\":\"auto\",\"concurrency\":1},\"server\":{\"open\":false,\"host\":\"127.0.0.1\",\"port\":4412,\"allowedHosts\":[\"127.0.0.1\",\"127.0.0.1\",\"127.0.0.1\",\"127.0.0.1\"]},\"redirects\":{},\"image\":{\"endpoint\":{\"route\":\"/_image\"},\"service\":{\"entrypoint\":\"astro/assets/services/sharp\",\"config\":{}},\"dangerouslyProcessSVG\":false,\"domains\":[],\"remotePatterns\":[],\"responsiveStyles\":false},\"devToolbar\":{\"enabled\":true},\"markdown\":{\"syntaxHighlight\":{\"type\":\"shiki\",\"excludeLangs\":[\"math\"]},\"shikiConfig\":{\"langs\":[],\"langAlias\":{},\"theme\":\"github-dark\",\"themes\":{},\"wrap\":false,\"transformers\":[]},\"remarkPlugins\":[],\"rehypePlugins\":[],\"remarkRehype\":{},\"processor\":{\"name\":\"satteri\",\"options\":{\"mdastPlugins\":[],\"hastPlugins\":[],\"features\":{}}}},\"security\":{\"checkOrigin\":true,\"allowedDomains\":[],\"csp\":false,\"actionBodySizeLimit\":1048576,\"serverIslandBodySizeLimit\":1048576},\"env\":{\"schema\":{},\"validateSecrets\":false},\"prerenderConflictBehavior\":\"warn\",\"fetchFile\":\"fetch\",\"logger\":{\"entrypoint\":\"astro/logger/json\"},\"experimental\":{\"clientPrerender\":false,\"contentIntellisense\":false,\"chromeDevtoolsWorkspace\":false,\"collectionStorage\":\"single-file\"},\"legacy\":{\"collectionsBackwardsCompat\":false}}","astro-version","7.1.3","content-config-digest","ef24ddbc7d731e37","site",["Map",11,12,32,33,52,53],"site-content",{"id":11,"data":13,"body":17,"filePath":18,"digest":19,"rendered":20},{"title":14,"description":15,"sections":16},"Home","A multi-page dog shelter website built with Norna.",{},"## Dog Shelter {#intro}\n\nWe rescue dogs, help them recover and introduce them to families ready to give\nthem a permanent home.\n\nVisit **Dogs** to meet two current residents, or **Adopt** to learn how the\nadoption process works.\n\n```norna-card-list\nlayout: image-right\nflow: stack\nsize: s\nwidth: narrow\n\n- title: Rescue, recovery and new homes\n  text: Meet the dogs currently in our care and learn what kind of home each one needs.\n  image: shelter-dog.jpg\n  link: /dogs/\n```","site/content.md","8e6311f7aa2b670d",{"html":21,"metadata":22},"\u003Ch2 id=\"dog-shelter-intro\">Dog Shelter {#intro}\u003C/h2>\n\u003Cp>We rescue dogs, help them recover and introduce them to families ready to give\nthem a permanent home.\u003C/p>\n\u003Cp>Visit \u003Cstrong>Dogs\u003C/strong> to meet two current residents, or \u003Cstrong>Adopt\u003C/strong> to learn how the\nadoption process works.\u003C/p>\n\u003Cpre class=\"astro-code github-dark\" style=\"background-color:#24292e;color:#e1e4e8; overflow-x: auto;\" tabindex=\"0\" data-language=\"plaintext\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan>layout: image-right\u003C/span>\u003C/span>\n\u003Cspan class=\"line\">\u003Cspan>flow: stack\u003C/span>\u003C/span>\n\u003Cspan class=\"line\">\u003Cspan>size: s\u003C/span>\u003C/span>\n\u003Cspan class=\"line\">\u003Cspan>width: narrow\u003C/span>\u003C/span>\n\u003Cspan class=\"line\">\u003Cspan>\u003C/span>\u003C/span>\n\u003Cspan class=\"line\">\u003Cspan>- title: Rescue, recovery and new homes\u003C/span>\u003C/span>\n\u003Cspan class=\"line\">\u003Cspan>  text: Meet the dogs currently in our care and learn what kind of home each one needs.\u003C/span>\u003C/span>\n\u003Cspan class=\"line\">\u003Cspan>  image: shelter-dog.jpg\u003C/span>\u003C/span>\n\u003Cspan class=\"line\">\u003Cspan>  link: /dogs/\u003C/span>\u003C/span>\u003C/code>\u003C/pre>\n",{"headings":23,"localImagePaths":28,"remoteImagePaths":29,"frontmatter":30,"imagePaths":31},[24],{"depth":25,"slug":26,"text":27},2,"dog-shelter-intro","Dog Shelter {#intro}",[],[],{"title":14,"description":15},[],"site-route-010-dogs",{"id":32,"data":34,"body":38,"filePath":39,"digest":40,"rendered":41},{"title":35,"description":36,"sections":37},"Dogs","Meet dogs currently waiting for adoption.",{},"## Dogs {#dogs}\n\nMeet Rover and Rex.\n\n```norna-card-list\nlayout: image-top\nflow: grid\nsize: s\nwidth: narrow\n\n- title: Rover\n  text: Curious and active. Rover needs daily walks and room to explore.\n  image: rover.jpg\n- title: Rex\n  text: Gentle and observant. Rex needs a patient home with quiet routines.\n  image: rex.jpg\n```","site/routes/010-dogs/route-content.md","7b650f7fd791e689",{"html":42,"metadata":43},"\u003Ch2 id=\"dogs-dogs\">Dogs {#dogs}\u003C/h2>\n\u003Cp>Meet Rover and Rex.\u003C/p>\n\u003Cpre class=\"astro-code github-dark\" style=\"background-color:#24292e;color:#e1e4e8; overflow-x: auto;\" tabindex=\"0\" data-language=\"plaintext\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan>layout: image-top\u003C/span>\u003C/span>\n\u003Cspan class=\"line\">\u003Cspan>flow: grid\u003C/span>\u003C/span>\n\u003Cspan class=\"line\">\u003Cspan>size: s\u003C/span>\u003C/span>\n\u003Cspan class=\"line\">\u003Cspan>width: narrow\u003C/span>\u003C/span>\n\u003Cspan class=\"line\">\u003Cspan>\u003C/span>\u003C/span>\n\u003Cspan class=\"line\">\u003Cspan>- title: Rover\u003C/span>\u003C/span>\n\u003Cspan class=\"line\">\u003Cspan>  text: Curious and active. Rover needs daily walks and room to explore.\u003C/span>\u003C/span>\n\u003Cspan class=\"line\">\u003Cspan>  image: rover.jpg\u003C/span>\u003C/span>\n\u003Cspan class=\"line\">\u003Cspan>- title: Rex\u003C/span>\u003C/span>\n\u003Cspan class=\"line\">\u003Cspan>  text: Gentle and observant. Rex needs a patient home with quiet routines.\u003C/span>\u003C/span>\n\u003Cspan class=\"line\">\u003Cspan>  image: rex.jpg\u003C/span>\u003C/span>\u003C/code>\u003C/pre>\n",{"headings":44,"localImagePaths":48,"remoteImagePaths":49,"frontmatter":50,"imagePaths":51},[45],{"depth":25,"slug":46,"text":47},"dogs-dogs","Dogs {#dogs}",[],[],{"title":35,"description":36},[],"site-route-020-adopt",{"id":52,"data":54,"body":58,"filePath":59,"digest":60,"rendered":61},{"title":55,"description":56,"sections":57},"Adopt","Learn how to adopt from Dog Shelter.",{},"## Adopt {#adopt}\n\nAdoption begins with a conversation about your home, routines and experience\nwith dogs. We then arrange a meeting with dogs whose needs appear to match.\n\nThe goal is not the quickest placement. It is a stable home where both the dog\nand the family have the support they need.\n\n```norna-card-list\nlayout: image-left\nflow: stack\nsize: s\nwidth: narrow\n\n- title: Start with a conversation\n  text: Tell us about your home and routines, then meet dogs whose needs may be a good match.\n  image: adoption-dog.jpg\n```","site/routes/020-adopt/route-content.md","9c0eba10f95aae72",{"html":62,"metadata":63},"\u003Ch2 id=\"adopt-adopt\">Adopt {#adopt}\u003C/h2>\n\u003Cp>Adoption begins with a conversation about your home, routines and experience\nwith dogs. We then arrange a meeting with dogs whose needs appear to match.\u003C/p>\n\u003Cp>The goal is not the quickest placement. It is a stable home where both the dog\nand the family have the support they need.\u003C/p>\n\u003Cpre class=\"astro-code github-dark\" style=\"background-color:#24292e;color:#e1e4e8; overflow-x: auto;\" tabindex=\"0\" data-language=\"plaintext\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan>layout: image-left\u003C/span>\u003C/span>\n\u003Cspan class=\"line\">\u003Cspan>flow: stack\u003C/span>\u003C/span>\n\u003Cspan class=\"line\">\u003Cspan>size: s\u003C/span>\u003C/span>\n\u003Cspan class=\"line\">\u003Cspan>width: narrow\u003C/span>\u003C/span>\n\u003Cspan class=\"line\">\u003Cspan>\u003C/span>\u003C/span>\n\u003Cspan class=\"line\">\u003Cspan>- title: Start with a conversation\u003C/span>\u003C/span>\n\u003Cspan class=\"line\">\u003Cspan>  text: Tell us about your home and routines, then meet dogs whose needs may be a good match.\u003C/span>\u003C/span>\n\u003Cspan class=\"line\">\u003Cspan>  image: adoption-dog.jpg\u003C/span>\u003C/span>\u003C/code>\u003C/pre>\n",{"headings":64,"localImagePaths":68,"remoteImagePaths":69,"frontmatter":70,"imagePaths":71},[65],{"depth":25,"slug":66,"text":67},"adopt-adopt","Adopt {#adopt}",[],[],{"title":55,"description":56},[],"sitewide",["Map",74,75],"site-sitewide",{"id":74,"data":76,"body":84,"filePath":85,"digest":86,"rendered":87},{"navigation":77,"banners":81,"footer":82},{"logo":78},{"alt":79,"height":80},"Dog Shelter","3rem",[],{"copyrightMessage":83},"Dog Shelter example site. Dog photos by Bicanski, CC0, via Pixnio.","\u003C!-- norna-image-provenance:\nimage: logo.svg\nsource: AI-assisted, hand-authored SVG\nprompt: Create a compact horizontal dog shelter logo with a simple dog face in\na house-shaped mark and the words Dog Shelter. Use flat vector shapes, a warm\nred accent, dark text, transparent background and no external assets.\n-->","site/sitewide-content.md","68de962e675a456b",{"html":88,"metadata":89},"\u003C!-- norna-image-provenance:\nimage: logo.svg\nsource: AI-assisted, hand-authored SVG\nprompt: Create a compact horizontal dog shelter logo with a simple dog face in\na house-shaped mark and the words Dog Shelter. Use flat vector shapes, a warm\nred accent, dark text, transparent background and no external assets.\n-->\n",{"headings":90,"localImagePaths":91,"remoteImagePaths":92,"frontmatter":93,"imagePaths":97},[],[],[],{"navigation":94,"footer":96},{"logo":95},{"alt":79,"height":80},{"copyrightMessage":83},[],"theme",["Map",100,101],"theme.md",{"id":100,"data":102,"filePath":104,"digest":105,"rendered":106},{"preset":103},"project","site/theme.md","d19ab283a10fb060",{"html":107,"metadata":108},"",{"headings":109,"localImagePaths":110,"remoteImagePaths":111,"frontmatter":112,"imagePaths":113},[],[],[],{"preset":103},[]]

package/examples/{typography-presets → complete-sites/dog-shelter-multi-page}/.astro/dev-local.json

@@ -1,8 +1,8 @@
 {
-  "pid": 6298,
+  "pid": 47121,
   "port": 4321,
   "host": "0.0.0.0",
   "mode": "lan",
   "url": "http://127.0.0.1:4321/",
-  "startedAt": "2026-08-19T19:41:41.296Z"
+  "startedAt": "2026-08-21T03:52:43.086Z"
 }

package/examples/complete-sites/dog-shelter-multi-page/.astro/dev.json

@@ -0,0 +1,13 @@
+{
+	"pid": 58179,
+	"port": 4412,
+	"url": "http://127.0.0.1:4412",
+	"urls": {
+		"local": [
+			"http://127.0.0.1:4412/"
+		],
+		"network": []
+	},
+	"background": true,
+	"startedAt": "2026-08-21T04:55:53.950Z"
+}

package/examples/complete-sites/dog-shelter-multi-page/.astro/dev.log

@@ -0,0 +1,26 @@
+{"message":"connected.","label":"vite","level":"info"}
+{"message":"Generated 0ms","label":"types","level":"info"}
+{"message":"connected.","label":"vite","level":"info"}
+{"message":"Syncing content","label":"content","level":"info"}
+{"message":"Astro config changed","label":"content","level":"info"}
+{"message":"Clearing content store","label":"content","level":"info"}
+[Shiki] The language "norna-card-list" doesn't exist, falling back to "plaintext".
+[Shiki] The language "norna-card-list" doesn't exist, falling back to "plaintext".
+[Shiki] The language "norna-card-list" doesn't exist, falling back to "plaintext".
+{"message":"Synced content","label":"content","level":"info"}
+{"message":"Re-optimizing dependencies because vite config has changed","label":"vite","level":"info"}
+{"message":" astro  v7.1.3 ready in 1134 ms\n┃ Local    http://127.0.0.1:4412/","label":"SKIP_FORMAT","level":"info"}
+{"message":"watching for file changes...","label":null,"level":"info"}
+{"message":"[200] / 52ms","label":null,"level":"info"}
+{"message":"[200] / 7ms","label":null,"level":"info"}
+{"message":"[200] /dogs/ 18ms","label":null,"level":"info"}
+{"message":"[200] /adopt/ 8ms","label":null,"level":"info"}
+{"message":"[200] / 8ms","label":null,"level":"info"}
+{"message":"[200] /dogs/ 8ms","label":null,"level":"info"}
+{"message":"[200] /adopt/ 8ms","label":null,"level":"info"}
+{"message":"[200] /dogs/ 8ms","label":null,"level":"info"}
+{"message":"[200] / 9ms","label":null,"level":"info"}
+{"message":"[200] / 8ms","label":null,"level":"info"}
+{"message":"[200] / 6ms","label":null,"level":"info"}
+{"message":"[200] /dogs/ 13ms","label":null,"level":"info"}
+{"message":"[200] /dogs/ 7ms","label":null,"level":"info"}

package/examples/complete-sites/dog-shelter-multi-page/.astro/settings.json

@@ -0,0 +1,5 @@
+{
+	"_variables": {
+		"lastUpdateCheck": 1787284362911
+	}
+}

package/examples/complete-sites/dog-shelter-multi-page/README.md

@@ -0,0 +1,16 @@
+# Dog Shelter multi-page example
+
+A small Norna site with a homepage and ordered routes for dogs and adoption.
+
+[Live demo](https://janga.github.io/norna/examples/complete-sites/dog-shelter-multi-page/)
+|
+[View source](https://github.com/janga/norna/tree/main/examples/complete-sites/dog-shelter-multi-page)
+
+The dog photos are CC0 images by Bicanski, sourced from Pixnio. Attribution is
+included in the site footer even though the licence does not require it.
+
+Run it from the Norna repository root:
+
+```sh
+node bin/norna.mjs --site-dir examples/complete-sites/dog-shelter-multi-page/site dev:local
+```

package/examples/complete-sites/dog-shelter-multi-page/node_modules/.vite/deps/_metadata.json

@@ -0,0 +1,74 @@
+{
+  "hash": "5cf74c44",
+  "configHash": "468b2565",
+  "lockfileHash": "808f2e8e",
+  "browserHash": "24b56f2c",
+  "optimized": {
+    "astro > aria-query": {
+      "src": "../../../../../../node_modules/aria-query/lib/index.js",
+      "file": "astro_n_aria-query.js",
+      "fileHash": "22765b52",
+      "needsInterop": true
+    },
+    "astro > axobject-query": {
+      "src": "../../../../../../node_modules/axobject-query/lib/index.js",
+      "file": "astro_n_axobject-query.js",
+      "fileHash": "c0c497a1",
+      "needsInterop": true
+    },
+    "astro > html-escaper": {
+      "src": "../../../../../../node_modules/html-escaper/esm/index.js",
+      "file": "astro_n_html-escaper.js",
+      "fileHash": "3d5b47f7",
+      "needsInterop": false
+    },
+    "astro/runtime/client/dev-toolbar/entrypoint.js": {
+      "src": "../../../../../../node_modules/astro/dist/runtime/client/dev-toolbar/entrypoint.js",
+      "file": "astro_runtime_client_dev-toolbar_entrypoint__js.js",
+      "fileHash": "89643eed",
+      "needsInterop": false
+    }
+  },
+  "chunks": {
+    "astro-B3JHJyiv": {
+      "file": "astro-B3JHJyiv.js",
+      "isDynamicEntry": true
+    },
+    "audit-C3SVr7dT": {
+      "file": "audit-C3SVr7dT.js",
+      "isDynamicEntry": true
+    },
+    "highlight-BLtvqtzO": {
+      "file": "highlight-BLtvqtzO.js",
+      "isDynamicEntry": false
+    },
+    "icons-C92i61-2": {
+      "file": "icons-C92i61-2.js",
+      "isDynamicEntry": false
+    },
+    "rolldown-runtime-BvCyGRYZ": {
+      "file": "rolldown-runtime-BvCyGRYZ.js",
+      "isDynamicEntry": false
+    },
+    "settings-v5GgKks_": {
+      "file": "settings-v5GgKks_.js",
+      "isDynamicEntry": true
+    },
+    "toolbar-BFvJVp26": {
+      "file": "toolbar-BFvJVp26.js",
+      "isDynamicEntry": true
+    },
+    "ui-library-Cd35oAvo": {
+      "file": "ui-library-Cd35oAvo.js",
+      "isDynamicEntry": true
+    },
+    "window-vo3A6TMn": {
+      "file": "window-vo3A6TMn.js",
+      "isDynamicEntry": false
+    },
+    "xray-DwhzGckb": {
+      "file": "xray-DwhzGckb.js",
+      "isDynamicEntry": true
+    }
+  }
+}

package/examples/{typography-presets/node_modules/.vite/deps/astro-D_GIpJIE.js → complete-sites/dog-shelter-multi-page/node_modules/.vite/deps/astro-B3JHJyiv.js}

@@ -1,6 +1,6 @@
-import { n as isDefinedIcon } from "./icons-RyebKi45.js";
-import { n as createWindowElement, r as synchronizePlacementOnUpdate, t as closeOnOutsideClick } from "./window-jPkpKVcy.js";
-//#region ../../node_modules/astro/dist/runtime/client/dev-toolbar/apps/utils/icons.js
+import { n as isDefinedIcon } from "./icons-C92i61-2.js";
+import { n as createWindowElement, r as synchronizePlacementOnUpdate, t as closeOnOutsideClick } from "./window-vo3A6TMn.js";
+//#region ../../../node_modules/astro/dist/runtime/client/dev-toolbar/apps/utils/icons.js
 function randomFromArray(list) {
 	return list[Math.floor(Math.random() * list.length)];
 }
@@ -58,7 +58,7 @@ function colorForIntegration() {
 	return randomFromArray(iconColors);
 }
 //#endregion
-//#region ../../node_modules/astro/dist/runtime/client/dev-toolbar/apps/astro.js
+//#region ../../../node_modules/astro/dist/runtime/client/dev-toolbar/apps/astro.js
 var astroLogo = "<svg xmlns=\"http://www.w3.org/2000/svg\" fill=\"none\" viewBox=\"0 0 99 26\" width=\"100\"><path fill=\"#fff\" d=\"M6.70402 22.1453c-1.17459-1.0737-1.51748-3.3297-1.02811-4.9641.84853 1.0304 2.02424 1.3569 3.24204 1.5411 1.88005.2844 3.72635.178 5.47285-.6813.1998-.0984.3844-.2292.6027-.3617.1639.4755.2065.9554.1493 1.4439-.1392 1.1898-.7313 2.1088-1.673 2.8054-.3765.2787-.775.5278-1.1639.7905-1.1948.8075-1.518 1.7544-1.0691 3.1318.0107.0336.0202.0671.0444.149-.6101-.273-1.0557-.6705-1.39518-1.1931-.3586-.5517-.52921-1.1619-.53819-1.8221-.00449-.3213-.00449-.6455-.0477-.9623-.10551-.7722-.46804-1.118-1.15102-1.1379-.70094-.0205-1.2554.4129-1.40244 1.0953-.01122.0523-.02749.1041-.04377.1649l.00112.0006Z\"/><path fill=\"url(#paint0_linear_386_2739)\" d=\"M6.70402 22.1453c-1.17459-1.0737-1.51748-3.3297-1.02811-4.9641.84853 1.0304 2.02424 1.3569 3.24204 1.5411 1.88005.2844 3.72635.178 5.47285-.6813.1998-.0984.3844-.2292.6027-.3617.1639.4755.2065.9554.1493 1.4439-.1392 1.1898-.7313 2.1088-1.673 2.8054-.3765.2787-.775.5278-1.1639.7905-1.1948.8075-1.518 1.7544-1.0691 3.1318.0107.0336.0202.0671.0444.149-.6101-.273-1.0557-.6705-1.39518-1.1931-.3586-.5517-.52921-1.1619-.53819-1.8221-.00449-.3213-.00449-.6455-.0477-.9623-.10551-.7722-.46804-1.118-1.15102-1.1379-.70094-.0205-1.2554.4129-1.40244 1.0953-.01122.0523-.02749.1041-.04377.1649l.00112.0006Z\"/><path fill=\"#fff\" d=\"M0 16.909s3.47815-1.6944 6.96603-1.6944l2.62973-8.13858c.09846-.39359.38592-.66106.71044-.66106.3246 0 .612.26747.7105.66106l2.6297 8.13858c4.1309 0 6.966 1.6944 6.966 1.6944S14.7045.814589 14.693.782298C14.5234.306461 14.2371 0 13.8512 0H6.76183c-.38593 0-.66063.306461-.84174.782298C5.90733.81398 0 16.909 0 16.909ZM36.671 11.7318c0 1.4262-1.7739 2.2779-4.2302 2.2779-1.5985 0-2.1638-.3962-2.1638-1.2281 0-.8715.7018-1.2875 2.3003-1.2875 1.4426 0 2.6707.0198 4.0937.1981v.0396Zm.0195-1.7629c-.8772-.19808-2.2028-.31693-3.7818-.31693-4.6006 0-6.7644 1.08943-6.7644 3.62483 0 2.6344 1.4815 3.6446 4.9125 3.6446 2.9046 0 4.8735-.7328 5.5947-2.5354h.117c-.0195.4358-.039.8716-.039 1.2083 0 .931.156 1.0102.9162 1.0102h3.5869c-.1949-.5546-.3119-2.1194-.3119-3.4663 0-1.446.0585-2.5355.0585-4.00123 0-2.99098-1.7934-4.89253-7.4077-4.89253-2.4173 0-5.1074.41596-7.1543 1.03.1949.81213.4679 2.45617.6043 3.5258 1.774-.83193 4.2887-1.18847 6.2381-1.18847 2.6902 0 3.4309.61404 3.4309 1.86193v.4952ZM46.5325 12.5637c-.4874.0594-1.1502.0594-1.8325.0594-.7213 0-1.3841-.0198-1.8324-.0792 0 .1585-.0195.3367-.0195.4952 0 2.476 1.618 3.922 7.3102 3.922 5.3609 0 7.0958-1.4262 7.0958-3.9418 0-2.3769-1.1501-3.5456-6.238-3.8031-3.9573-.17827-4.3082-.61404-4.3082-1.10924 0-.57442.5068-.87154 3.158-.87154 2.7487 0 3.4894.37635 3.4894 1.16866v.17827c.3899-.01981 1.0917-.03961 1.813-.03961.6823 0 1.423.0198 1.8519.05942 0-.17827.0195-.33674.0195-.47539 0-2.91175-2.4172-3.86252-7.0958-3.86252-5.2634 0-7.0373 1.2875-7.0373 3.8031 0 2.25805 1.423 3.66445 6.472 3.88235 3.7233.1188 4.1327.5348 4.1327 1.1092 0 .6141-.6043.8914-3.2165.8914-3.0021 0-3.7623-.416-3.7623-1.2677v-.1189ZM63.6883 2.125c-1.423 1.32712-3.9768 2.65425-5.3998 3.01079.0195.73289.0195 2.07982.0195 2.81271l1.3061.01981c-.0195 1.40635-.039 3.10979-.039 4.23889 0 2.6344 1.3841 4.6152 5.6922 4.6152 1.813 0 3.0216-.1981 4.5226-.515-.1559-.9706-.3314-2.4562-.3898-3.5852-.8968.2971-2.0274.4556-3.275.4556-1.735 0-2.4368-.4754-2.4368-1.8422 0-1.1884 0-2.29767.0195-3.32768 2.2223.01981 4.4446.05943 5.7507.09904-.0195-1.03.0195-2.51559.078-3.50598-1.8909.03961-4.0157.05942-5.7702.05942.0195-.87154.039-1.70347.0585-2.5354h-.1365ZM75.3313 7.35427c.0195-1.03001.039-1.90156.0585-2.75329h-3.9183c.0585 1.70347.0585 3.44656.0585 6.00172 0 2.5553-.0195 4.3182-.0585 6.0018h4.4836c-.078-1.1885-.0975-3.189-.0975-4.8925 0-2.69388 1.0917-3.46638 3.5674-3.46638 1.1502 0 1.9689.13865 2.6902.39615.0195-1.01019.2144-2.97117.3314-3.84271-.7408-.21789-1.5595-.35655-2.5537-.35655-2.1249-.0198-3.6844.85174-4.4056 2.93156l-.156-.0198ZM94.8501 10.5235c0 2.1591-1.5595 3.1693-4.0157 3.1693-2.4368 0-3.9963-.9508-3.9963-3.1693 0-2.21846 1.579-3.05039 3.9963-3.05039 2.4367 0 4.0157.89135 4.0157 3.05039Zm4.0743-.099c0-4.29832-3.353-6.21968-8.09-6.21968-4.7566 0-7.9926 1.92136-7.9926 6.21968 0 4.2785 3.0216 6.5762 7.9731 6.5762 4.9904 0 8.1095-2.2977 8.1095-6.5762Z\"/><defs><linearGradient id=\"paint0_linear_386_2739\" x1=\"5.46011\" x2=\"16.8017\" y1=\"25.9999\" y2=\"20.6412\" gradientUnits=\"userSpaceOnUse\"><stop stop-color=\"#D83333\"/><stop offset=\"1\" stop-color=\"#F041FF\"/></linearGradient></defs></svg>";
 var integrationData;
 var astro_default = {