@janga/norna 0.7.17 → 0.7.18

package/starters/basic/site/theme.yaml

@@ -1,105 +1 @@
-# 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:
-# layout:
-#   density: compact | normal | airy
-#   pageWidth: CSS length, e.g. 1180px
-#   gutter:
-#     desktop: CSS length or clamp(), e.g. clamp(1.25rem, 4vw, 3rem)
-#     mobile: CSS length, e.g. 1rem
-#   spacing:
-#     firstSectionTop:
-#       desktop: CSS length or clamp(), e.g. clamp(1.875rem, 3vw, 2.75rem)
-#       mobile: CSS length, e.g. 1.375rem
-#     sectionGap:
-#       desktop: CSS length or clamp(), e.g. clamp(1.4rem, 3vw, 2.75rem)
-#       mobile: CSS length, e.g. 1.5rem
-#     finalSectionBottom:
-#       desktop: CSS length or clamp(), e.g. clamp(1.4rem, 3vw, 2.75rem)
-#       mobile: CSS length, e.g. 1.5rem
-#     headingToBlock:
-#       desktop: CSS length, e.g. 0.75em
-#       mobile: CSS length, e.g. 0.7em
-#     blockGap:
-#       desktop: CSS length, e.g. 1.5em
-#       mobile: CSS length, e.g. 1.25em
-#     imageGap:
-#       desktop: CSS length or clamp(), e.g. clamp(1.25rem, 2.8vw, 2rem)
-#       mobile: CSS length, e.g. 1.5rem
-# images:
-#   width: CSS length, e.g. 900px
-#   maxAvailableWidthPercent:
-#     desktop: number from 1 through 100
-#     mobile: number from 1 through 100
-#   maxAvailableHeightPercent:
-#     desktop: number from 1 through 100
-#     mobile: number from 1 through 100
-# typography:
-#   fontFamily: CSS font-family stack
-#   profile: restrained | dense | reading | statement
-#   rhythm: compact | normal | airy
-#   overrides:
-#     headings:
-#       h2:
-#         align:
-#           desktop: left | center | right
-#           mobile: left | center | right
-#         size: small | medium | large | xlarge
-#         lineHeight: number from 1 through 3
-#         spacingBefore: CSS length, e.g. 0
-#         spacingAfter: CSS length, e.g. 0.55em
-#       h3:
-#         align:
-#           desktop: left | center | right
-#           mobile: left | center | right
-#         size: small | medium | large | xlarge
-#         lineHeight: number from 1 through 3
-#         spacingBefore: CSS length, e.g. 1.5em
-#         spacingAfter: CSS length, e.g. 0.5em
-#       h4:
-#         align:
-#           desktop: left | center | right
-#           mobile: left | center | right
-#         size: small | medium | large | xlarge
-#         lineHeight: number from 1 through 3
-#         spacingBefore: CSS length, e.g. 1.1em
-#         spacingAfter: CSS length, e.g. 0.4em
-#     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
-#       spacingBefore: CSS length, e.g. 0.5em
-# palette: dark  # Alternatives: light, paper
-# sectionSurfaces: [base, soft, emphasis]
-# norna:end theme-help
-layout:
-  density: normal
-  pageWidth: 1180px
-  gutter:
-    desktop: clamp(1.25rem, 4vw, 3rem)
-    mobile: 1rem
-images:
-  width: 900px
-  maxAvailableWidthPercent:
-    desktop: 100
-    mobile: 100
-  maxAvailableHeightPercent:
-    desktop: 74
-    mobile: 68
-typography:
-  fontFamily: "Arial, 'Helvetica Neue', Helvetica, sans-serif"
-  profile: restrained
-  rhythm: normal
-palette: dark  # Alternatives: light, paper
-sectionSurfaces: [base, soft, emphasis]
+preset: project

package/starters/project/README.md

@@ -20,9 +20,9 @@ npm run norna:dev -- --kill
 
 - `site/config.yaml`: public URL and optional language and smooth scrolling.
 - `site/sitewide-content.yaml`: shared logo display settings, banners, and footer.
-- `site/theme.yaml`: site-wide visual settings such as layout density, typography
-  rhythm, palettes, section surfaces, and typography.
-- `site/content.md`: homepage title, sections, placeholders, project summary,
+- `site/theme.yaml`: the site-wide visual preset and any focused overrides.
+- `site/pages/000-home/content.md`: homepage title, sections, placeholders,
+  project summary,
   links, install command, example usage, benefits, next steps, Norna blocks,
   and license.
 - `site/pages/010-guide/content.md`: short secondary page with realistic
@@ -36,15 +36,15 @@ GitHub Pages workflow uses `npm ci`.
 ## Adapt The Starter
 
 1. Replace the project name, tagline, links, install command, example usage,
-   benefits, use cases, and license in `site/content.md`.
+   benefits, use cases, and license in `site/pages/000-home/content.md`.
 2. Replace the guide examples in `site/pages/010-guide/content.md`, or
    delete the page if the homepage is enough.
 3. Edit `site/sitewide-content.yaml` for logo display settings,
    banners, and footer.
-4. Edit `site/theme.yaml` for layout density, typography rhythm, palette, section
-   surfaces, and typography.
-5. Put managed homepage source images directly in `site/images/`. Images for
-   an additional page belong directly in that page's `images/` directory.
+4. Select a preset in `site/theme.yaml`. Add focused overrides only when the
+   project needs them.
+5. Put managed homepage source images in `site/pages/000-home/images/`. Images
+   for another page belong directly in that page's `images/` directory.
 6. Edit `site/config.yaml` for the public URL and, when needed, language or smooth
    scrolling. Deploy commands discover the GitHub repository and default branch.
 7. Update `package.json` with the site's package name and keep

package/starters/project/site/theme.yaml

@@ -1,31 +1 @@
-# Site-wide visual defaults. Remove a value to use the engine default.
-layout:
-  density: compact
-  pageWidth: 1120px
-  gutter:
-    desktop: clamp(1.25rem, 4vw, 3rem)
-    mobile: 1rem
-  spacing:
-    firstSectionTop:
-      desktop: clamp(0.9rem, 1.6vw, 1.5rem)
-      mobile: 0.9rem
-    sectionGap:
-      desktop: clamp(0.8rem, 1.6vw, 1.5rem)
-      mobile: 1rem
-    finalSectionBottom:
-      desktop: clamp(1rem, 2vw, 1.75rem)
-      mobile: 1rem
-images:
-  width: 840px
-  maxAvailableWidthPercent:
-    desktop: 100
-    mobile: 100
-  maxAvailableHeightPercent:
-    desktop: 70
-    mobile: 62
-typography:
-  fontFamily: "Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif"
-  profile: reading
-  rhythm: compact
-palette: dark  # Alternatives: light, paper
-sectionSurfaces: [base, soft]
+preset: project

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

@@ -1,18 +0,0 @@
-# Themes
-
-This feature demo compares Norna's complete built-in theme presets. Every page
-uses one preset without overrides, so differences in layout, typography,
-palette, surfaces and image presentation come from the preset itself.
-
-[Live demo](https://janga.github.io/norna/examples/feature-demos/theme-presets/)
-|
-[View source](https://github.com/janga/norna/tree/main/examples/feature-demos/theme-presets)
-
-Run it from the repository root:
-
-```sh
-node bin/norna.mjs --site-dir examples/feature-demos/theme-presets/site dev:local
-```
-
-The dog photos are CC0 images by Bicanski, sourced from Pixnio. Attribution is
-included in the image captions even though the licence does not require it.

package/examples/feature-demos/theme-presets/site/.norna/generated-images.json

@@ -1,290 +0,0 @@
-{
-  "pages/010-portfolio/images/puppy-portrait.jpg": {
-    "outputVersion": 2,
-    "sourceHash": "0cb5126b86660785da62903393e43df7b6e361d3bd1a0492cc6f371159c5afb8",
-    "width": 1200,
-    "height": 800,
-    "variants": [
-      {
-        "src": "/images/generated/pages/010-portfolio/images/puppy-portrait-0cb5126b-480.webp",
-        "width": 480
-      },
-      {
-        "src": "/images/generated/pages/010-portfolio/images/puppy-portrait-0cb5126b-768.webp",
-        "width": 768
-      },
-      {
-        "src": "/images/generated/pages/010-portfolio/images/puppy-portrait-0cb5126b-1080.webp",
-        "width": 1080
-      },
-      {
-        "src": "/images/generated/pages/010-portfolio/images/puppy-portrait-0cb5126b-1200.webp",
-        "width": 1200
-      }
-    ]
-  },
-  "pages/010-portfolio/images/shepherd-portrait.jpg": {
-    "outputVersion": 2,
-    "sourceHash": "604099036852fa40c2fecf8620a138405c8edcb0b92f120bb603742f9ee91154",
-    "width": 1200,
-    "height": 800,
-    "variants": [
-      {
-        "src": "/images/generated/pages/010-portfolio/images/shepherd-portrait-60409903-480.webp",
-        "width": 480
-      },
-      {
-        "src": "/images/generated/pages/010-portfolio/images/shepherd-portrait-60409903-768.webp",
-        "width": 768
-      },
-      {
-        "src": "/images/generated/pages/010-portfolio/images/shepherd-portrait-60409903-1080.webp",
-        "width": 1080
-      },
-      {
-        "src": "/images/generated/pages/010-portfolio/images/shepherd-portrait-60409903-1200.webp",
-        "width": 1200
-      }
-    ]
-  },
-  "pages/010-portfolio/images/white-puppy.jpg": {
-    "outputVersion": 2,
-    "sourceHash": "bcb834d00bb9b520dac475c32906f8578a03bd922c1639c7d86252ae1f1c433a",
-    "width": 1200,
-    "height": 800,
-    "variants": [
-      {
-        "src": "/images/generated/pages/010-portfolio/images/white-puppy-bcb834d0-480.webp",
-        "width": 480
-      },
-      {
-        "src": "/images/generated/pages/010-portfolio/images/white-puppy-bcb834d0-768.webp",
-        "width": 768
-      },
-      {
-        "src": "/images/generated/pages/010-portfolio/images/white-puppy-bcb834d0-1080.webp",
-        "width": 1080
-      },
-      {
-        "src": "/images/generated/pages/010-portfolio/images/white-puppy-bcb834d0-1200.webp",
-        "width": 1200
-      }
-    ]
-  },
-  "pages/020-documentation/images/black-schnauzer.jpg": {
-    "outputVersion": 2,
-    "sourceHash": "569922b4aa71096cc8e3a245f0ddccf74f941881b823084723854580078b50b0",
-    "width": 1200,
-    "height": 800,
-    "variants": [
-      {
-        "src": "/images/generated/pages/020-documentation/images/black-schnauzer-569922b4-480.webp",
-        "width": 480
-      },
-      {
-        "src": "/images/generated/pages/020-documentation/images/black-schnauzer-569922b4-768.webp",
-        "width": 768
-      },
-      {
-        "src": "/images/generated/pages/020-documentation/images/black-schnauzer-569922b4-1080.webp",
-        "width": 1080
-      },
-      {
-        "src": "/images/generated/pages/020-documentation/images/black-schnauzer-569922b4-1200.webp",
-        "width": 1200
-      }
-    ]
-  },
-  "pages/020-documentation/images/retriever-portrait.jpg": {
-    "outputVersion": 2,
-    "sourceHash": "c441ca2935debeb008a43e2a7fd510bfd6776682f84160151fd5c8605bfb8cae",
-    "width": 1200,
-    "height": 800,
-    "variants": [
-      {
-        "src": "/images/generated/pages/020-documentation/images/retriever-portrait-c441ca29-480.webp",
-        "width": 480
-      },
-      {
-        "src": "/images/generated/pages/020-documentation/images/retriever-portrait-c441ca29-768.webp",
-        "width": 768
-      },
-      {
-        "src": "/images/generated/pages/020-documentation/images/retriever-portrait-c441ca29-1080.webp",
-        "width": 1080
-      },
-      {
-        "src": "/images/generated/pages/020-documentation/images/retriever-portrait-c441ca29-1200.webp",
-        "width": 1200
-      }
-    ]
-  },
-  "pages/020-documentation/images/schnauzer-portrait.jpg": {
-    "outputVersion": 2,
-    "sourceHash": "545b0427b8e15846fe73656758da6eb3b8612dabf2b2879c31197986f8deb9b5",
-    "width": 1200,
-    "height": 900,
-    "variants": [
-      {
-        "src": "/images/generated/pages/020-documentation/images/schnauzer-portrait-545b0427-480.webp",
-        "width": 480
-      },
-      {
-        "src": "/images/generated/pages/020-documentation/images/schnauzer-portrait-545b0427-768.webp",
-        "width": 768
-      },
-      {
-        "src": "/images/generated/pages/020-documentation/images/schnauzer-portrait-545b0427-1080.webp",
-        "width": 1080
-      },
-      {
-        "src": "/images/generated/pages/020-documentation/images/schnauzer-portrait-545b0427-1200.webp",
-        "width": 1200
-      }
-    ]
-  },
-  "pages/030-project/images/boxer-portrait.jpg": {
-    "outputVersion": 2,
-    "sourceHash": "da764a5b71f2bfa610ae4978cad4660cd6ecfdcd5b7fcbd788b92c3f9ada42b1",
-    "width": 1200,
-    "height": 800,
-    "variants": [
-      {
-        "src": "/images/generated/pages/030-project/images/boxer-portrait-da764a5b-480.webp",
-        "width": 480
-      },
-      {
-        "src": "/images/generated/pages/030-project/images/boxer-portrait-da764a5b-768.webp",
-        "width": 768
-      },
-      {
-        "src": "/images/generated/pages/030-project/images/boxer-portrait-da764a5b-1080.webp",
-        "width": 1080
-      },
-      {
-        "src": "/images/generated/pages/030-project/images/boxer-portrait-da764a5b-1200.webp",
-        "width": 1200
-      }
-    ]
-  },
-  "pages/030-project/images/grass-puppy.jpg": {
-    "outputVersion": 2,
-    "sourceHash": "519d663971223bdb1948db9087c637f1ed8b4d21d81c08e1fc10d5e2d904f230",
-    "width": 1200,
-    "height": 800,
-    "variants": [
-      {
-        "src": "/images/generated/pages/030-project/images/grass-puppy-519d6639-480.webp",
-        "width": 480
-      },
-      {
-        "src": "/images/generated/pages/030-project/images/grass-puppy-519d6639-768.webp",
-        "width": 768
-      },
-      {
-        "src": "/images/generated/pages/030-project/images/grass-puppy-519d6639-1080.webp",
-        "width": 1080
-      },
-      {
-        "src": "/images/generated/pages/030-project/images/grass-puppy-519d6639-1200.webp",
-        "width": 1200
-      }
-    ]
-  },
-  "pages/030-project/images/grey-street-dog.jpg": {
-    "outputVersion": 2,
-    "sourceHash": "08cab93ba9a2d1c3a72c471dd8724efa7d820f43dad447221b445c32ebe9ab28",
-    "width": 1200,
-    "height": 800,
-    "variants": [
-      {
-        "src": "/images/generated/pages/030-project/images/grey-street-dog-08cab93b-480.webp",
-        "width": 480
-      },
-      {
-        "src": "/images/generated/pages/030-project/images/grey-street-dog-08cab93b-768.webp",
-        "width": 768
-      },
-      {
-        "src": "/images/generated/pages/030-project/images/grey-street-dog-08cab93b-1080.webp",
-        "width": 1080
-      },
-      {
-        "src": "/images/generated/pages/030-project/images/grey-street-dog-08cab93b-1200.webp",
-        "width": 1200
-      }
-    ]
-  },
-  "pages/040-statement/images/black-pedigree.jpg": {
-    "outputVersion": 2,
-    "sourceHash": "7d5e0be21d7889cb440b9dd6bab74d8f656e4f5159fdcd6cbe937fc7b9d4bd44",
-    "width": 1200,
-    "height": 800,
-    "variants": [
-      {
-        "src": "/images/generated/pages/040-statement/images/black-pedigree-7d5e0be2-480.webp",
-        "width": 480
-      },
-      {
-        "src": "/images/generated/pages/040-statement/images/black-pedigree-7d5e0be2-768.webp",
-        "width": 768
-      },
-      {
-        "src": "/images/generated/pages/040-statement/images/black-pedigree-7d5e0be2-1080.webp",
-        "width": 1080
-      },
-      {
-        "src": "/images/generated/pages/040-statement/images/black-pedigree-7d5e0be2-1200.webp",
-        "width": 1200
-      }
-    ]
-  },
-  "pages/040-statement/images/sheepdog-grass.jpg": {
-    "outputVersion": 2,
-    "sourceHash": "b9396e00227dac3b290d6e29cc82758a4cf98f08bc9154c24c8fbf598563b69a",
-    "width": 1200,
-    "height": 800,
-    "variants": [
-      {
-        "src": "/images/generated/pages/040-statement/images/sheepdog-grass-b9396e00-480.webp",
-        "width": 480
-      },
-      {
-        "src": "/images/generated/pages/040-statement/images/sheepdog-grass-b9396e00-768.webp",
-        "width": 768
-      },
-      {
-        "src": "/images/generated/pages/040-statement/images/sheepdog-grass-b9396e00-1080.webp",
-        "width": 1080
-      },
-      {
-        "src": "/images/generated/pages/040-statement/images/sheepdog-grass-b9396e00-1200.webp",
-        "width": 1200
-      }
-    ]
-  },
-  "pages/040-statement/images/sheepdog-wide.jpg": {
-    "outputVersion": 2,
-    "sourceHash": "5c8a6878d3d38549d41f8161b92ffb555f3bf5c2d3defbade15932c4d11b6dea",
-    "width": 1200,
-    "height": 667,
-    "variants": [
-      {
-        "src": "/images/generated/pages/040-statement/images/sheepdog-wide-5c8a6878-480.webp",
-        "width": 480
-      },
-      {
-        "src": "/images/generated/pages/040-statement/images/sheepdog-wide-5c8a6878-768.webp",
-        "width": 768
-      },
-      {
-        "src": "/images/generated/pages/040-statement/images/sheepdog-wide-5c8a6878-1080.webp",
-        "width": 1080
-      },
-      {
-        "src": "/images/generated/pages/040-statement/images/sheepdog-wide-5c8a6878-1200.webp",
-        "width": 1200
-      }
-    ]
-  }
-}

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

@@ -1,14 +0,0 @@
----
-page:
-  description: Compare Norna's complete built-in theme presets without overrides.
----
-
-# Theme Presets
-Each page 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/feature-demos/theme-presets/site/theme.yaml

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