@janga/norna 0.7.16 → 0.7.18

package/schemas/config.schema.json

@@ -6,7 +6,7 @@
       "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)",
+      "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.18/docs/configuration.md#url)",
       "examples": [
         "https://example.com/",
         "https://owner.github.io/repository-name/"
@@ -41,7 +41,48 @@
           "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)"
+      "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.18/docs/configuration.md#language)"
+    },
+    "navigation": {
+      "type": "object",
+      "properties": {
+        "mode": {
+          "description": "Navigation model. Omit this to let Norna choose from the site structure.",
+          "type": "string",
+          "oneOf": [
+            {
+              "const": "automatic",
+              "title": "Automatic",
+              "description": "Choose sections for one page, top navigation for a shallow multi-page site, and tree navigation for deeper content."
+            },
+            {
+              "const": "sections",
+              "title": "Sections",
+              "description": "Navigate the sections of the current page."
+            },
+            {
+              "const": "top",
+              "title": "Top",
+              "description": "Use pages in the top navigation and sections below them."
+            },
+            {
+              "const": "tree",
+              "title": "Tree",
+              "description": "Use a hierarchical site-wide navigation tree."
+            }
+          ],
+          "markdownDescription": "```yaml\nnavigation:\n  mode: automatic\n```\n\nNavigation model. Omit this to let Norna choose from the site structure.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/pages.md#navigation)",
+          "examples": [
+            "automatic",
+            "sections",
+            "top",
+            "tree"
+          ]
+        }
+      },
+      "additionalProperties": false,
+      "description": "Site-wide navigation behavior.",
+      "markdownDescription": "```yaml\nnavigation:\n  mode: automatic\n```\n\nSets one navigation model for the complete site. `automatic` selects from the page hierarchy.\n\n[Navigation reference](https://github.com/janga/norna/blob/v0.7.18/docs/pages.md#navigation)"
     },
     "scrollBehavior": {
       "default": "instant",
@@ -59,7 +100,7 @@
           "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)",
+      "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.18/docs/configuration.md#scrollbehavior)",
       "examples": [
         "instant",
         "smooth"
@@ -70,8 +111,8 @@
     "url"
   ],
   "additionalProperties": false,
-  "description": "Technical settings for one Norna site. Routes cannot provide technical configuration.",
+  "description": "Technical settings for one Norna site. Additional pages 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)"
+  "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.18/docs/configuration.md)"
 }

package/schemas/content-frontmatter.schema.json

@@ -2,80 +2,45 @@
   "$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.",
+    "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"
+        "description": {
+          "description": "Optional page-specific meta description.",
+          "type": "string",
+          "minLength": 1,
+          "markdownDescription": "```yaml\npage:\n  description: About this project.\n```\n\nAn optional page-specific description rendered as `<meta name=\"description\">`. It is not visible in page content.\n\n[Page title and frontmatter reference](https://github.com/janga/norna/blob/v0.7.18/docs/content.md#page-title-and-frontmatter)",
+          "examples": [
+            "About this project."
+          ]
         }
       },
       "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)"
+      "description": "Optional metadata for this homepage or additional page. The Markdown H1 supplies the page title.",
+      "markdownDescription": "```yaml\npage:\n  description: About this project.\n```\n\nContains optional metadata for the current homepage or additional page. The Markdown H1 supplies its title.\n\n[Page title and frontmatter reference](https://github.com/janga/norna/blob/v0.7.18/docs/content.md#page-title-and-frontmatter)"
     },
-    "sections": {
-      "default": {},
-      "description": "Optional metadata keyed by Markdown section id. Do not duplicate section order here.",
+    "navigation": {
+      "description": "Optional navigation metadata for this page.",
       "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."
+      "properties": {
+        "listed": {
+          "default": true,
+          "description": "List this page in site navigation. The page remains public when false.",
+          "type": "boolean",
+          "markdownDescription": "```yaml\nnavigation:\n  listed: false\n```\n\nList this page in site navigation. The page remains public when false.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/pages.md#navigation)",
+          "examples": [
+            true,
+            false
+          ]
+        }
       },
-      "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)"
+      "additionalProperties": false,
+      "markdownDescription": "```yaml\nnavigation:\n  listed: false\n```\n\nOptionally excludes an additional page from site navigation without removing its public URL.\n\n[Site navigation reference](https://github.com/janga/norna/blob/v0.7.18/docs/pages.md#navigation)"
     }
   },
-  "required": [
-    "title",
-    "description"
-  ],
   "additionalProperties": false,
-  "description": "Frontmatter for a homepage or route content.md file.",
+  "description": "Frontmatter for a homepage or additional page 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)"
+  "markdownDescription": "```yaml\n---\npage:\n  description: About this project.\n---\n```\n\nContent frontmatter is optional. Write the page title as the single Markdown H1; use frontmatter only for optional metadata or navigation settings.\n\n[Page title and frontmatter reference](https://github.com/janga/norna/blob/v0.7.18/docs/content.md#page-title-and-frontmatter)"
 }

package/schemas/manifest.json

@@ -1,9 +1,11 @@
 {
-  "schemaVersion": 1,
+  "editorApiVersion": 1,
+  "schemaVersion": 2,
   "files": {
     "config": "config.schema.json",
     "contentFrontmatter": "content-frontmatter.schema.json",
     "sitewideContent": "sitewide-content.schema.json",
-    "theme": "theme.schema.json"
+    "theme": "theme.schema.json",
+    "pageTheme": "page-theme.schema.json"
   }
 }

package/schemas/page-theme.schema.json

@@ -0,0 +1,192 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "properties": {
+    "layout": {
+      "type": "object",
+      "properties": {
+        "contentSpacing": {
+          "description": "Page content spacing. Descendant pages inherit this value.",
+          "type": "string",
+          "oneOf": [
+            {
+              "const": "compact",
+              "title": "Compact",
+              "description": "Use restrained spacing between sections and structured blocks."
+            },
+            {
+              "const": "normal",
+              "title": "Normal",
+              "description": "Use balanced content spacing."
+            },
+            {
+              "const": "spacious",
+              "title": "Spacious",
+              "description": "Use more expansive spacing between sections and structured blocks."
+            }
+          ],
+          "markdownDescription": "```yaml\nlayout:\n  contentSpacing: compact\n```\n\nPage content spacing. Descendant pages inherit this value.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/theme.md#page-themes)",
+          "examples": [
+            "compact",
+            "normal",
+            "spacious"
+          ]
+        },
+        "textWidth": {
+          "description": "Body-text line length. Descendant pages inherit this value.",
+          "type": "string",
+          "oneOf": [
+            {
+              "const": "narrow",
+              "title": "Narrow",
+              "description": "Use a shorter line length suited to reading-focused text."
+            },
+            {
+              "const": "normal",
+              "title": "Normal",
+              "description": "Use the balanced default line length."
+            },
+            {
+              "const": "wide",
+              "title": "Wide",
+              "description": "Allow body text to use more horizontal space."
+            }
+          ],
+          "markdownDescription": "```yaml\nlayout:\n  textWidth: narrow\n```\n\nBody-text line length. Descendant pages inherit this value.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/theme.md#page-themes)",
+          "examples": [
+            "narrow",
+            "normal",
+            "wide"
+          ]
+        }
+      },
+      "additionalProperties": false,
+      "description": "Page-local layout settings inherited by descendant pages.",
+      "markdownDescription": "```yaml\nlayout:\n  textWidth: narrow\n  contentSpacing: compact\n```\n\nAdjusts body-text line length and vertical content spacing for this page and its descendants.\n\n[Page theme reference](https://github.com/janga/norna/blob/v0.7.18/docs/theme.md#page-themes)"
+    },
+    "images": {
+      "type": "object",
+      "properties": {
+        "width": {
+          "description": "Maximum managed-image width. Omit this to keep the selected preset.",
+          "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*\\))$",
+          "markdownDescription": "```yaml\nimages:\n  width: 900px\n```\n\nMaximum managed-image width. Omit this to keep the selected preset.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/theme.md#image-sizing)"
+        },
+        "maxAvailableWidthPercent": {
+          "description": "Maximum percentage of available horizontal space used by managed images.",
+          "anyOf": [
+            {
+              "type": "number",
+              "exclusiveMinimum": 0,
+              "maximum": 100
+            },
+            {
+              "type": "object",
+              "properties": {
+                "desktop": {
+                  "type": "number",
+                  "exclusiveMinimum": 0,
+                  "maximum": 100,
+                  "description": "Percentage used on wider screens.",
+                  "markdownDescription": "```yaml\nimages:\n  maxAvailableWidthPercent:\n    desktop: 100\n```\n\nPercentage used on wider screens.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/theme.md#image-sizing)"
+                },
+                "mobile": {
+                  "type": "number",
+                  "exclusiveMinimum": 0,
+                  "maximum": 100,
+                  "description": "Percentage used on narrow screens.",
+                  "markdownDescription": "```yaml\nimages:\n  maxAvailableWidthPercent:\n    mobile: 100\n```\n\nPercentage used on narrow screens.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/theme.md#image-sizing)"
+                }
+              },
+              "required": [
+                "desktop",
+                "mobile"
+              ],
+              "additionalProperties": false
+            }
+          ],
+          "markdownDescription": "```yaml\nimages:\n  maxAvailableWidthPercent:\n    desktop: 100\n    mobile: 100\n```\n\nMaximum percentage of available horizontal space used by managed images.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/theme.md#image-sizing)"
+        },
+        "maxAvailableHeightPercent": {
+          "description": "Maximum percentage of viewport height used by managed images.",
+          "anyOf": [
+            {
+              "type": "number",
+              "exclusiveMinimum": 0,
+              "maximum": 100
+            },
+            {
+              "type": "object",
+              "properties": {
+                "desktop": {
+                  "type": "number",
+                  "exclusiveMinimum": 0,
+                  "maximum": 100,
+                  "description": "Percentage used on wider screens.",
+                  "markdownDescription": "```yaml\nimages:\n  maxAvailableHeightPercent:\n    desktop: 74\n```\n\nPercentage used on wider screens.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/theme.md#image-sizing)"
+                },
+                "mobile": {
+                  "type": "number",
+                  "exclusiveMinimum": 0,
+                  "maximum": 100,
+                  "description": "Percentage used on narrow screens.",
+                  "markdownDescription": "```yaml\nimages:\n  maxAvailableHeightPercent:\n    mobile: 68\n```\n\nPercentage used on narrow screens.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/theme.md#image-sizing)"
+                }
+              },
+              "required": [
+                "desktop",
+                "mobile"
+              ],
+              "additionalProperties": false
+            }
+          ],
+          "markdownDescription": "```yaml\nimages:\n  maxAvailableHeightPercent:\n    desktop: 74\n    mobile: 68\n```\n\nMaximum percentage of viewport height used by managed images.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/theme.md#image-sizing)"
+        }
+      },
+      "additionalProperties": false,
+      "description": "Optional defaults for managed image presentation.",
+      "markdownDescription": "```yaml\nimages:\n  width: 900px\n```\n\nAdjusts managed-image sizing for this page and its descendants.\n\n[Image sizing reference](https://github.com/janga/norna/blob/v0.7.18/docs/theme.md#image-sizing)"
+    },
+    "sections": {
+      "type": "object",
+      "properties": {
+        "backgroundPattern": {
+          "description": "Section background sequence inherited by descendant pages.",
+          "type": "string",
+          "oneOf": [
+            {
+              "const": "uniform",
+              "title": "Uniform",
+              "description": "Use the palette base surface for every section."
+            },
+            {
+              "const": "alternating",
+              "title": "Alternating",
+              "description": "Alternate between the palette base and soft surfaces."
+            },
+            {
+              "const": "cycling",
+              "title": "Cycling",
+              "description": "Cycle through the palette base, soft and emphasis surfaces."
+            }
+          ],
+          "markdownDescription": "```yaml\nsections:\n  backgroundPattern: alternating\n```\n\nSection background sequence inherited by descendant pages.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/theme.md#page-themes)",
+          "examples": [
+            "uniform",
+            "alternating",
+            "cycling"
+          ]
+        }
+      },
+      "additionalProperties": false,
+      "description": "Page-local section presentation inherited by descendant pages.",
+      "markdownDescription": "```yaml\nsections:\n  backgroundPattern: alternating\n```\n\nAdjusts the section background sequence for this page and its descendants.\n\n[Page theme reference](https://github.com/janga/norna/blob/v0.7.18/docs/theme.md#page-themes)"
+    }
+  },
+  "additionalProperties": false,
+  "description": "Limited page presentation overrides inherited by descendant pages. Site colors, shapes, typography and navigation remain global.",
+  "$id": "https://janga.github.io/norna/schemas/page-theme.schema.json",
+  "title": "Norna page theme",
+  "markdownDescription": "```yaml\nlayout:\n  textWidth: narrow\n  contentSpacing: compact\n```\n\nA page theme may adjust only page layout, managed-image sizing and the section background pattern. Descendant pages inherit these values. Site colors, shapes and typography stay consistent.\n\n[Page theme reference](https://github.com/janga/norna/blob/v0.7.18/docs/theme.md#page-themes)"
+}