@janga/norna 0.7.14 → 0.7.16

package/examples/complete-sites/dog-shelter-single-page/site/{theme.md → theme.yaml}

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

package/examples/feature-demos/media-and-surfaces/README.md

@@ -16,6 +16,6 @@ Run it from the repository root with:
 node bin/norna.mjs --site-dir examples/feature-demos/media-and-surfaces/site dev:local
 ```
 
-The site has a home page plus routes for media blocks and surfaces. Sitewide
+The site has a home page plus routes for Norna blocks and surfaces. Sitewide
 identity, banners and footers are demonstrated separately in
 `examples/feature-demos/sitewide-content/`.

package/examples/feature-demos/media-and-surfaces/site/{config.md → config.yaml}

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

package/examples/feature-demos/media-and-surfaces/site/content.md

@@ -1,13 +1,13 @@
 ---
 title: Media and Surfaces
-description: A visual test bench for Norna's managed media and presentation surfaces.
+description: A visual test bench for Norna's image and card blocks and presentation surfaces.
 navigation:
   label: Home
 ---
 
 ## Media and surfaces {#intro}
 
-This site is a focused test bench for Norna's managed media blocks, sidenotes,
+This site is a focused test bench for Norna's image and card blocks, sidenotes,
 palettes and section-surface controls.
 
 Use [Media blocks](/media/) to compare image stacks, carousels, card lists and

package/examples/feature-demos/media-and-surfaces/site/routes/020-surfaces/{route-content.md → content.md}

@@ -11,8 +11,7 @@ Norna provides a small set of named palettes. The theme chooses one
 for the whole site:
 
 ```yaml
-presentation:
-  palette: dark
+palette: dark
 ```
 
 The available choices are `dark`, `light` and `paper`. A palette defines the
@@ -25,10 +24,7 @@ The route theme uses a palette and a surface sequence when a visual pause or
 change of rhythm helps the reader. This is not a free-form colour override:
 
 ```yaml
-presentation:
-  sectionSurfaces:
-    mode: cycle
-    sequence: [base, soft, emphasis]
+sectionSurfaces: [base, soft, emphasis]
 ```
 
 The theme can cycle through the selected surfaces automatically. Individual
@@ -40,5 +36,5 @@ Use the site palette for the overall tone. Use soft and emphasis surfaces for a
 small number of meaningful transitions, not to make every section look
 unrelated.
 
-Typography presets and media blocks can vary the content inside that system;
+Typography profiles and Norna blocks can vary the content inside that system;
 surfaces provide the route-level rhythm around it.

package/examples/feature-demos/media-and-surfaces/site/routes/020-surfaces/theme.yaml

@@ -0,0 +1,3 @@
+preset: project
+palette: light
+sectionSurfaces: [base, soft, emphasis]

package/examples/feature-demos/media-and-surfaces/site/{sitewide-content.md → sitewide-content.yaml}

@@ -1,6 +1,4 @@
----
 navigation:
-  brand: Media and Surfaces
+  label: Media and Surfaces
 footer:
   copyrightMessage: Norna media and surfaces example.
----

package/examples/feature-demos/media-and-surfaces/site/{theme.md → theme.yaml}

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

package/examples/feature-demos/sitewide-content/README.md

@@ -16,3 +16,11 @@ node bin/norna.mjs --site-dir examples/feature-demos/sitewide-content/site dev:l
 
 Move between the routes to verify that the same sitewide elements remain in
 place. Banner dismissals are stored locally in the browser.
+
+<!-- norna-image-provenance:
+image: site/public/logo.svg
+source: AI-assisted, hand-authored SVG
+prompt: Create a compact horizontal logo named Shared Frame. Use a simple
+overlapping-frame symbol, dark text, one muted red accent, a transparent
+background and no external assets.
+-->

package/examples/feature-demos/sitewide-content/site/{config.md → config.yaml}

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

package/examples/feature-demos/sitewide-content/site/routes/010-identity/{route-content.md → content.md}

@@ -8,11 +8,11 @@ navigation:
 ## One identity across routes {#identity}
 
 The logo in the navigation is discovered from `public/logo.svg`. Its alt text
-and display height belong to `sitewide-content.md`, because the identity is
+and display height belong to `sitewide-content.yaml`, because the identity is
 shared by every route.
 
-If a site has no logo file, Norna can use a text brand instead. A route cannot
-replace the site identity with its own logo or brand.
+If a site has no logo file, Norna shows the navigation label as text instead. A
+route cannot replace the shared navigation identity.
 
 ## Navigation context {#navigation}
 

package/examples/feature-demos/sitewide-content/site/routes/020-notices/{route-content.md → content.md}

@@ -7,7 +7,7 @@ navigation:
 
 ## Banner stack {#banner-stack}
 
-The two notices above the page content are defined in `sitewide-content.md`.
+The two notices above the page content are defined in `sitewide-content.yaml`.
 List order controls their order, and each notice keeps its own identity.
 
 ## Dismissal {#dismissal}

package/examples/feature-demos/sitewide-content/site/routes/030-footer/{route-content.md → content.md}

@@ -7,7 +7,7 @@ navigation:
 
 ## Persistent footer content {#footer-content}
 
-The footer below this page is defined once in `sitewide-content.md`. Its
+The footer below this page is defined once in `sitewide-content.yaml`. Its
 copyright message remains the same across routes.
 
 ## Build information {#build-information}

package/examples/feature-demos/sitewide-content/site/{sitewide-content.md → sitewide-content.yaml}

@@ -1,7 +1,6 @@
----
 navigation:
+  label: Shared Frame
   logo:
-    alt: Shared Frame
     height: 2.8rem
 banners:
   - id: preview-environment
@@ -22,12 +21,3 @@ footer:
       timeZone: UTC
       dateStyle: medium
       timeStyle: short
----
-
-<!-- norna-image-provenance:
-image: logo.svg
-source: AI-assisted, hand-authored SVG
-prompt: Create a compact horizontal logo named Shared Frame. Use a simple
-overlapping-frame symbol, dark text, one muted red accent, a transparent
-background and no external assets.
--->

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

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

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

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

package/examples/feature-demos/theme-presets/site/routes/010-portfolio/{theme.md → theme.yaml}

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

package/examples/feature-demos/theme-presets/site/routes/020-documentation/{theme.md → theme.yaml}

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

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

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

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

@@ -1,6 +1,6 @@
 ---
 title: Statement
-description: A stronger typography preset for short declarative content.
+description: A stronger typography profile for short declarative content.
 navigation:
   label: Statement
 ---

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

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

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

@@ -1,6 +1,5 @@
----
 navigation:
-  brand: Theme Presets
+  label: Theme Presets
 footer:
   copyrightMessage: Dog photos by Bicanski, CC0, via Pixnio.
   buildInfo:
@@ -11,4 +10,3 @@ footer:
       timeZone: UTC
       dateStyle: short
       timeStyle: short
----

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

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

package/fixtures/basic/site/{config.md → config.yaml}

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

package/fixtures/basic/site/content.md

@@ -1,6 +1,6 @@
 ---
 title: Fixture Site
-description: Minimal cli-gallery fixture site.
+description: Minimal Norna fixture site.
 sections:
   intro: {}
   work: {}
@@ -8,8 +8,8 @@ sections:
 ---
 ## Intro {#intro}
 
-This fixture validates the cli-gallery engine against a stable empty gallery.
+This fixture validates the Norna engine against a stable page without managed images.
 
 ## Work {#work}
 
-Fixture section with no gallery images.
+Fixture section with no managed images.

package/fixtures/basic/site/{sitewide-content.md → sitewide-content.yaml}

@@ -1,4 +1,3 @@
----
 footer:
   copyrightMessage: (c) Fixture Artist.
   buildInfo:
@@ -9,4 +8,3 @@ footer:
       timeZone: UTC
       dateStyle: short
       timeStyle: short
----

package/fixtures/basic/site/{theme.md → theme.yaml}

@@ -1,11 +1,8 @@
----
 layout:
   pageWidth: 1180px
-gallery:
+images:
   width: 900px
 typography:
   fontFamily: "Arial, 'Helvetica Neue', Helvetica, sans-serif"
-  preset: quiet-gallery
-presentation:
-  palette: dark
----
+  profile: restrained
+palette: dark

package/fixtures/content-model-v2/site/{config.md → config.yaml}

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

package/fixtures/content-model-v2/site/theme.yaml

@@ -0,0 +1,4 @@
+typography:
+  profile: reading
+  rhythm: normal
+palette: dark

package/package.json

@@ -2,7 +2,7 @@
   "name": "@janga/norna",
   "description": "An opinionated CLI for building responsive websites from Markdown, images, and theme presets.",
   "type": "module",
-  "version": "0.7.14",
+  "version": "0.7.16",
   "license": "GPL-3.0-only",
   "repository": {
     "type": "git",
@@ -30,6 +30,7 @@
     "examples/",
     "fixtures/",
     "scripts/",
+    "schemas/",
     "src/",
     "starters/",
     "!**/.norna/public/",
@@ -53,10 +54,13 @@
     "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:presets": "node bin/norna.mjs theme:presets",
     "theme:export": "node bin/norna.mjs theme:export",
-    "typography:presets": "node bin/norna.mjs typography presets",
+    "typography:profiles": "node bin/norna.mjs typography profiles",
     "typography:show": "node bin/norna.mjs typography show",
     "site:public": "node bin/norna.mjs site:public",
+    "schemas:generate": "node scripts/generate-schemas.mjs",
+    "schemas:check": "node scripts/generate-schemas.mjs --check",
     "images": "node bin/norna.mjs images",
     "build": "node bin/norna.mjs build",
     "build:pages": "node scripts/build-pages.mjs",
@@ -66,10 +70,11 @@
     "deploy:watch": "node bin/norna.mjs deploy:watch",
     "doctor": "node bin/norna.mjs doctor",
     "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": "npm run schemas:check && npm run test:schemas && npm run test:route-model && npm run test:project-config && npm run test:editor-language && 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:schemas": "node scripts/test-schemas.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",
@@ -77,6 +82,7 @@
     "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:editor-language": "node scripts/test-editor-language-service.mjs && npm --prefix editors/vscode run check",
     "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",
@@ -95,6 +101,7 @@
   "dependencies": {
     "astro": "^7.1.3",
     "embla-carousel": "^8.6.0",
+    "js-yaml": "^4.3.1",
     "satteri": "^0.9.1"
   },
   "devDependencies": {

package/schemas/config.schema.json

@@ -0,0 +1,77 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "properties": {
+    "url": {
+      "type": "string",
+      "format": "uri",
+      "description": "Absolute public URL for the built site.",
+      "markdownDescription": "```yaml\nurl: https://example.com/\n```\n\nThe absolute public URL. Its path also determines the base path for generated links and assets.\n\n[Public URL reference](https://github.com/janga/norna/blob/v0.7.16/docs/configuration.md#url)",
+      "examples": [
+        "https://example.com/",
+        "https://owner.github.io/repository-name/"
+      ]
+    },
+    "language": {
+      "description": "Site language tag using Norna's English or Swedish interface text; the default is en.",
+      "type": "string",
+      "pattern": "^(?:en|sv)(?:-[a-zA-Z0-9]+)*$",
+      "default": "en",
+      "examples": [
+        "en",
+        "sv",
+        "en-GB",
+        "sv-SE"
+      ],
+      "oneOf": [
+        {
+          "const": "en",
+          "title": "English",
+          "description": "Use Norna's built-in English interface text."
+        },
+        {
+          "const": "sv",
+          "title": "Swedish",
+          "description": "Use Norna's built-in Swedish interface text."
+        },
+        {
+          "type": "string",
+          "pattern": "^(?:en|sv)-[a-zA-Z0-9]+(?:-[a-zA-Z0-9]+)*$",
+          "title": "Regional language tag",
+          "description": "Use an English or Swedish regional language tag such as en-GB or sv-SE."
+        }
+      ],
+      "markdownDescription": "```yaml\nlanguage: en-GB\n```\n\nSets the page language and selects Norna's built-in English or Swedish interface text. The default is `en`.\n\n[Language reference](https://github.com/janga/norna/blob/v0.7.16/docs/configuration.md#language)"
+    },
+    "scrollBehavior": {
+      "default": "instant",
+      "description": "Use instant anchors by default or the browser's native smooth scrolling.",
+      "type": "string",
+      "oneOf": [
+        {
+          "const": "instant",
+          "title": "Instant",
+          "description": "Jump directly to anchors without animated scrolling. This is the default."
+        },
+        {
+          "const": "smooth",
+          "title": "Browser smooth",
+          "description": "Use the browser's native smooth scrolling for anchor navigation."
+        }
+      ],
+      "markdownDescription": "```yaml\nscrollBehavior: smooth\n```\n\nControls same-page anchor movement. `instant` is the default; `smooth` uses the browser's native smooth scrolling.\n\n[Scroll behavior reference](https://github.com/janga/norna/blob/v0.7.16/docs/configuration.md#scrollbehavior)",
+      "examples": [
+        "instant",
+        "smooth"
+      ]
+    }
+  },
+  "required": [
+    "url"
+  ],
+  "additionalProperties": false,
+  "description": "Technical settings for one Norna site. Routes cannot provide technical configuration.",
+  "$id": "https://janga.github.io/norna/schemas/config.schema.json",
+  "title": "Norna site configuration",
+  "markdownDescription": "```yaml\nurl: https://example.com/\n```\n\n`config.yaml` contains the few technical settings shared by the complete site.\n\n[Configuration reference](https://github.com/janga/norna/blob/v0.7.16/docs/configuration.md)"
+}

package/schemas/content-frontmatter.schema.json

@@ -0,0 +1,81 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "properties": {
+    "title": {
+      "type": "string",
+      "description": "Page title used in metadata and route navigation.",
+      "markdownDescription": "```yaml\ntitle: About\n```\n\nThe page title used in metadata and, by default, route navigation.\n\n[Page frontmatter reference](https://github.com/janga/norna/blob/v0.7.16/docs/content.md#page-frontmatter)",
+      "examples": [
+        "About"
+      ]
+    },
+    "description": {
+      "type": "string",
+      "description": "Page description used in metadata.",
+      "markdownDescription": "```yaml\ndescription: About this project.\n```\n\nA concise page description used in metadata.\n\n[Page frontmatter reference](https://github.com/janga/norna/blob/v0.7.16/docs/content.md#page-frontmatter)",
+      "examples": [
+        "About this project."
+      ]
+    },
+    "navigation": {
+      "description": "Optional navigation metadata for this page.",
+      "type": "object",
+      "properties": {
+        "include": {
+          "description": "Include this page in site navigation. Pages are included when omitted.",
+          "type": "boolean"
+        },
+        "label": {
+          "description": "Navigation label when it should differ from the page title.",
+          "type": "string"
+        }
+      },
+      "additionalProperties": false,
+      "markdownDescription": "```yaml\nnavigation:\n  include: true\n  label: About us\n```\n\nControls whether a route appears in site navigation and optionally replaces its visible title there. Homepage navigation is section-based.\n\n[Route navigation reference](https://github.com/janga/norna/blob/v0.7.16/docs/routes.md#navigation)"
+    },
+    "sections": {
+      "default": {},
+      "description": "Optional metadata keyed by Markdown section id. Do not duplicate section order here.",
+      "type": "object",
+      "propertyNames": {
+        "type": "string",
+        "pattern": "^[a-z0-9-]+$"
+      },
+      "additionalProperties": {
+        "type": "object",
+        "properties": {
+          "visible": {
+            "description": "Optional date window for this section.",
+            "type": "object",
+            "properties": {
+              "from": {
+                "description": "First date on which the content is visible.",
+                "type": "string",
+                "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
+              },
+              "until": {
+                "description": "First date on which the content is no longer visible.",
+                "type": "string",
+                "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
+              }
+            },
+            "additionalProperties": false
+          }
+        },
+        "additionalProperties": false,
+        "description": "Metadata keyed by the explicit Markdown section id. Markdown order remains authoritative."
+      },
+      "markdownDescription": "```yaml\nsections:\n  announcement:\n    visible:\n      until: \"2026-12-01\"\n```\n\nAdds optional metadata keyed by explicit Markdown section id. Markdown headings remain the source of section content and order.\n\n[Section metadata reference](https://github.com/janga/norna/blob/v0.7.16/docs/content.md#section-metadata)"
+    }
+  },
+  "required": [
+    "title",
+    "description"
+  ],
+  "additionalProperties": false,
+  "description": "Frontmatter for a homepage or route content.md file.",
+  "$id": "https://janga.github.io/norna/schemas/content-frontmatter.schema.json",
+  "title": "Norna page frontmatter",
+  "markdownDescription": "```yaml\n---\ntitle: About\ndescription: About this project.\n---\n```\n\nEvery homepage and route `content.md` starts with page metadata, followed by Markdown sections.\n\n[Page frontmatter reference](https://github.com/janga/norna/blob/v0.7.16/docs/content.md#page-frontmatter)"
+}

package/schemas/manifest.json

@@ -0,0 +1,9 @@
+{
+  "schemaVersion": 1,
+  "files": {
+    "config": "config.schema.json",
+    "contentFrontmatter": "content-frontmatter.schema.json",
+    "sitewideContent": "sitewide-content.schema.json",
+    "theme": "theme.schema.json"
+  }
+}