@janga/norna 0.7.16 → 0.7.18

package/schemas/theme.schema.json

@@ -27,36 +27,81 @@
           "description": "For short, expressive sites, with larger typography, airy spacing, and stronger section emphasis."
         }
       ],
-      "markdownDescription": "```yaml\npreset: documentation\n```\n\nSelects coordinated layout, image sizing, typography, palette and section surfaces. This is the normal starting point for a theme.\n\n[Compare theme presets](https://github.com/janga/norna/blob/v0.7.16/docs/theme.md#theme-presets)"
+      "markdownDescription": "```yaml\npreset: documentation\n```\n\nSelects coordinated shapes, layout, image sizing, typography, palette and section backgrounds. This is the normal starting point for a theme.\n\n[Compare theme presets](https://github.com/janga/norna/blob/v0.7.18/docs/theme.md#theme-presets)"
+    },
+    "shape": {
+      "description": "Site-wide shape profile. Omit this to use the selected preset.",
+      "type": "string",
+      "oneOf": [
+        {
+          "const": "square",
+          "title": "Square",
+          "description": "Use square corners for navigation, cards and framed content."
+        },
+        {
+          "const": "soft",
+          "title": "Soft",
+          "description": "Use restrained rounded corners consistently across the site."
+        }
+      ],
+      "markdownDescription": "```yaml\nshape: soft\n```\n\nChooses one consistent corner treatment for navigation, cards and framed content throughout the site.\n\n[Theme reference](https://github.com/janga/norna/blob/v0.7.18/docs/theme.md)",
+      "examples": [
+        "square",
+        "soft"
+      ]
     },
     "layout": {
       "type": "object",
       "properties": {
-        "density": {
-          "description": "Overall spacing density. Omit this to keep the selected preset.",
+        "contentSpacing": {
+          "description": "Page content spacing. Omit this to keep the selected preset or inherited page setting.",
           "type": "string",
           "oneOf": [
             {
               "const": "compact",
               "title": "Compact",
-              "description": "Reduce vertical spacing while preserving readable separation."
+              "description": "Use restrained spacing between sections and structured blocks."
             },
             {
               "const": "normal",
               "title": "Normal",
-              "description": "Use balanced vertical spacing."
+              "description": "Use balanced content spacing."
             },
             {
-              "const": "airy",
-              "title": "Airy",
-              "description": "Increase vertical spacing for a more expansive presentation."
+              "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. Omit this to keep the selected preset or inherited page setting.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/theme.md#layout)"
+        },
+        "textWidth": {
+          "description": "Body-text line length. Omit this to keep the selected preset or inherited page setting.",
+          "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. Omit this to keep the selected preset or inherited page setting.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/theme.md#layout)"
         },
         "pageWidth": {
           "description": "Maximum width of the site layout. 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*\\))$"
+          "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\nlayout:\n  pageWidth: 72rem\n```\n\nMaximum width of the site layout. 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#layout)"
         },
         "gutter": {
           "description": "Horizontal page gutter as one value or separate desktop and mobile values.",
@@ -72,12 +117,14 @@
                 "desktop": {
                   "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*\\))$",
-                  "description": "Responsive CSS length or clamp() expression."
+                  "description": "Responsive CSS length or clamp() expression.",
+                  "markdownDescription": "```yaml\nlayout:\n  gutter:\n    desktop: clamp(1.25rem, 4vw, 3rem)\n```\n\nResponsive CSS length or clamp() expression.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/theme.md#layout)"
                 },
                 "mobile": {
                   "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*\\))$",
-                  "description": "Responsive CSS length or clamp() expression."
+                  "description": "Responsive CSS length or clamp() expression.",
+                  "markdownDescription": "```yaml\nlayout:\n  gutter:\n    mobile: 1rem\n```\n\nResponsive CSS length or clamp() expression.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/theme.md#layout)"
                 }
               },
               "required": [
@@ -86,6 +133,17 @@
               ],
               "additionalProperties": false
             }
+          ],
+          "markdownDescription": "```yaml\nlayout:\n  gutter:\n    desktop: clamp(1.25rem, 4vw, 3rem)\n    mobile: 1rem\n```\n\nHorizontal page gutter as one value or separate desktop and mobile values.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/theme.md#layout)",
+          "defaultSnippets": [
+            {
+              "label": "Responsive page gutter",
+              "markdownDescription": "Set separate page gutters for wider and narrow screens.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/theme.md#layout)",
+              "body": {
+                "desktop": "${1:clamp(1.25rem, 4vw, 3rem)}",
+                "mobile": "${2:1rem}"
+              }
+            }
           ]
         },
         "spacing": {
@@ -106,12 +164,14 @@
                     "desktop": {
                       "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*\\))$",
-                      "description": "Responsive CSS length or clamp() expression."
+                      "description": "Responsive CSS length or clamp() expression.",
+                      "markdownDescription": "```yaml\nlayout:\n  spacing:\n    blockGap:\n      desktop: 1.5em\n```\n\nResponsive CSS length or clamp() expression.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/theme.md#layout)"
                     },
                     "mobile": {
                       "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*\\))$",
-                      "description": "Responsive CSS length or clamp() expression."
+                      "description": "Responsive CSS length or clamp() expression.",
+                      "markdownDescription": "```yaml\nlayout:\n  spacing:\n    blockGap:\n      mobile: 1.5em\n```\n\nResponsive CSS length or clamp() expression.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/theme.md#layout)"
                     }
                   },
                   "required": [
@@ -120,6 +180,17 @@
                   ],
                   "additionalProperties": false
                 }
+              ],
+              "markdownDescription": "```yaml\nlayout:\n  spacing:\n    blockGap: 1.5em\n```\n\nDefault vertical gap between structured content blocks.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/theme.md#layout)",
+              "defaultSnippets": [
+                {
+                  "label": "Responsive spacing",
+                  "markdownDescription": "Set separate spacing values for wider and narrow screens.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/theme.md#layout)",
+                  "body": {
+                    "desktop": "${1:1.5em}",
+                    "mobile": "${2:1.5em}"
+                  }
+                }
               ]
             },
             "finalSectionBottom": {
@@ -136,12 +207,14 @@
                     "desktop": {
                       "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*\\))$",
-                      "description": "Responsive CSS length or clamp() expression."
+                      "description": "Responsive CSS length or clamp() expression.",
+                      "markdownDescription": "```yaml\nlayout:\n  spacing:\n    finalSectionBottom:\n      desktop: 2rem\n```\n\nResponsive CSS length or clamp() expression.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/theme.md#layout)"
                     },
                     "mobile": {
                       "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*\\))$",
-                      "description": "Responsive CSS length or clamp() expression."
+                      "description": "Responsive CSS length or clamp() expression.",
+                      "markdownDescription": "```yaml\nlayout:\n  spacing:\n    finalSectionBottom:\n      mobile: 2rem\n```\n\nResponsive CSS length or clamp() expression.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/theme.md#layout)"
                     }
                   },
                   "required": [
@@ -150,6 +223,17 @@
                   ],
                   "additionalProperties": false
                 }
+              ],
+              "markdownDescription": "```yaml\nlayout:\n  spacing:\n    finalSectionBottom: 2rem\n```\n\nBottom space after the final section.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/theme.md#layout)",
+              "defaultSnippets": [
+                {
+                  "label": "Responsive spacing",
+                  "markdownDescription": "Set separate spacing values for wider and narrow screens.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/theme.md#layout)",
+                  "body": {
+                    "desktop": "${1:2rem}",
+                    "mobile": "${2:2rem}"
+                  }
+                }
               ]
             },
             "firstSectionTop": {
@@ -166,12 +250,14 @@
                     "desktop": {
                       "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*\\))$",
-                      "description": "Responsive CSS length or clamp() expression."
+                      "description": "Responsive CSS length or clamp() expression.",
+                      "markdownDescription": "```yaml\nlayout:\n  spacing:\n    firstSectionTop:\n      desktop: 1.5rem\n```\n\nResponsive CSS length or clamp() expression.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/theme.md#layout)"
                     },
                     "mobile": {
                       "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*\\))$",
-                      "description": "Responsive CSS length or clamp() expression."
+                      "description": "Responsive CSS length or clamp() expression.",
+                      "markdownDescription": "```yaml\nlayout:\n  spacing:\n    firstSectionTop:\n      mobile: 1.5rem\n```\n\nResponsive CSS length or clamp() expression.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/theme.md#layout)"
                     }
                   },
                   "required": [
@@ -180,6 +266,17 @@
                   ],
                   "additionalProperties": false
                 }
+              ],
+              "markdownDescription": "```yaml\nlayout:\n  spacing:\n    firstSectionTop: 1.5rem\n```\n\nTop space before the first section.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/theme.md#layout)",
+              "defaultSnippets": [
+                {
+                  "label": "Responsive spacing",
+                  "markdownDescription": "Set separate spacing values for wider and narrow screens.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/theme.md#layout)",
+                  "body": {
+                    "desktop": "${1:1.5rem}",
+                    "mobile": "${2:1.5rem}"
+                  }
+                }
               ]
             },
             "headingToBlock": {
@@ -196,12 +293,14 @@
                     "desktop": {
                       "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*\\))$",
-                      "description": "Responsive CSS length or clamp() expression."
+                      "description": "Responsive CSS length or clamp() expression.",
+                      "markdownDescription": "```yaml\nlayout:\n  spacing:\n    headingToBlock:\n      desktop: 0.75em\n```\n\nResponsive CSS length or clamp() expression.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/theme.md#layout)"
                     },
                     "mobile": {
                       "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*\\))$",
-                      "description": "Responsive CSS length or clamp() expression."
+                      "description": "Responsive CSS length or clamp() expression.",
+                      "markdownDescription": "```yaml\nlayout:\n  spacing:\n    headingToBlock:\n      mobile: 0.75em\n```\n\nResponsive CSS length or clamp() expression.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/theme.md#layout)"
                     }
                   },
                   "required": [
@@ -210,6 +309,17 @@
                   ],
                   "additionalProperties": false
                 }
+              ],
+              "markdownDescription": "```yaml\nlayout:\n  spacing:\n    headingToBlock: 0.75em\n```\n\nGap from a section heading to a following structured block.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/theme.md#layout)",
+              "defaultSnippets": [
+                {
+                  "label": "Responsive spacing",
+                  "markdownDescription": "Set separate spacing values for wider and narrow screens.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/theme.md#layout)",
+                  "body": {
+                    "desktop": "${1:0.75em}",
+                    "mobile": "${2:0.75em}"
+                  }
+                }
               ]
             },
             "imageGap": {
@@ -226,12 +336,14 @@
                     "desktop": {
                       "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*\\))$",
-                      "description": "Responsive CSS length or clamp() expression."
+                      "description": "Responsive CSS length or clamp() expression.",
+                      "markdownDescription": "```yaml\nlayout:\n  spacing:\n    imageGap:\n      desktop: 1rem\n```\n\nResponsive CSS length or clamp() expression.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/theme.md#layout)"
                     },
                     "mobile": {
                       "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*\\))$",
-                      "description": "Responsive CSS length or clamp() expression."
+                      "description": "Responsive CSS length or clamp() expression.",
+                      "markdownDescription": "```yaml\nlayout:\n  spacing:\n    imageGap:\n      mobile: 1rem\n```\n\nResponsive CSS length or clamp() expression.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/theme.md#layout)"
                     }
                   },
                   "required": [
@@ -240,6 +352,17 @@
                   ],
                   "additionalProperties": false
                 }
+              ],
+              "markdownDescription": "```yaml\nlayout:\n  spacing:\n    imageGap: 1rem\n```\n\nGap between images in an image stack.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/theme.md#layout)",
+              "defaultSnippets": [
+                {
+                  "label": "Responsive spacing",
+                  "markdownDescription": "Set separate spacing values for wider and narrow screens.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/theme.md#layout)",
+                  "body": {
+                    "desktop": "${1:1rem}",
+                    "mobile": "${2:1rem}"
+                  }
+                }
               ]
             },
             "sectionGap": {
@@ -256,12 +379,14 @@
                     "desktop": {
                       "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*\\))$",
-                      "description": "Responsive CSS length or clamp() expression."
+                      "description": "Responsive CSS length or clamp() expression.",
+                      "markdownDescription": "```yaml\nlayout:\n  spacing:\n    sectionGap:\n      desktop: 2rem\n```\n\nResponsive CSS length or clamp() expression.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/theme.md#layout)"
                     },
                     "mobile": {
                       "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*\\))$",
-                      "description": "Responsive CSS length or clamp() expression."
+                      "description": "Responsive CSS length or clamp() expression.",
+                      "markdownDescription": "```yaml\nlayout:\n  spacing:\n    sectionGap:\n      mobile: 2rem\n```\n\nResponsive CSS length or clamp() expression.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/theme.md#layout)"
                     }
                   },
                   "required": [
@@ -270,15 +395,41 @@
                   ],
                   "additionalProperties": false
                 }
+              ],
+              "markdownDescription": "```yaml\nlayout:\n  spacing:\n    sectionGap: 2rem\n```\n\nVertical separation between page sections.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/theme.md#layout)",
+              "defaultSnippets": [
+                {
+                  "label": "Responsive spacing",
+                  "markdownDescription": "Set separate spacing values for wider and narrow screens.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/theme.md#layout)",
+                  "body": {
+                    "desktop": "${1:2rem}",
+                    "mobile": "${2:2rem}"
+                  }
+                }
               ]
             }
           },
-          "additionalProperties": false
+          "additionalProperties": false,
+          "markdownDescription": "```yaml\nlayout:\n  spacing:\n    sectionGap: 2rem\n```\n\nFine-grained spacing overrides.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/theme.md#layout)",
+          "defaultSnippets": [
+            {
+              "label": "Layout spacing overrides",
+              "markdownDescription": "Start with the structural spacing values most commonly adjusted together.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/theme.md#layout)",
+              "body": {
+                "sectionGap": {
+                  "desktop": "${1:2rem}",
+                  "mobile": "${2:1.5rem}"
+                },
+                "headingToBlock": "${3:0.75em}",
+                "blockGap": "${4:1.5em}"
+              }
+            }
+          ]
         }
       },
       "additionalProperties": false,
       "description": "Optional layout overrides applied after the preset.",
-      "markdownDescription": "```yaml\nlayout:\n  density: compact\n  pageWidth: 72rem\n```\n\nOverrides page width, gutters and structural spacing after the selected preset.\n\n[Layout reference](https://github.com/janga/norna/blob/v0.7.16/docs/theme.md#layout)"
+      "markdownDescription": "```yaml\nlayout:\n  contentSpacing: compact\n  textWidth: narrow\n```\n\nOverrides text width, content spacing, page width and gutters after the selected preset.\n\n[Layout reference](https://github.com/janga/norna/blob/v0.7.18/docs/theme.md#layout)"
     },
     "images": {
       "type": "object",
@@ -286,7 +437,8 @@
         "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*\\))$"
+          "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.",
@@ -303,13 +455,15 @@
                   "type": "number",
                   "exclusiveMinimum": 0,
                   "maximum": 100,
-                  "description": "Percentage used on wider screens."
+                  "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."
+                  "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": [
@@ -318,6 +472,17 @@
               ],
               "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)",
+          "defaultSnippets": [
+            {
+              "label": "Responsive image limit",
+              "markdownDescription": "Set separate managed-image limits for wider and narrow screens.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/theme.md#image-sizing)",
+              "body": {
+                "desktop": "${1:100}",
+                "mobile": "${2:100}"
+              }
+            }
           ]
         },
         "maxAvailableHeightPercent": {
@@ -335,13 +500,15 @@
                   "type": "number",
                   "exclusiveMinimum": 0,
                   "maximum": 100,
-                  "description": "Percentage used on wider screens."
+                  "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."
+                  "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": [
@@ -350,12 +517,23 @@
               ],
               "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)",
+          "defaultSnippets": [
+            {
+              "label": "Responsive image limit",
+              "markdownDescription": "Set separate managed-image limits for wider and narrow screens.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/theme.md#image-sizing)",
+              "body": {
+                "desktop": "${1:74}",
+                "mobile": "${2:68}"
+              }
+            }
           ]
         }
       },
       "additionalProperties": false,
       "description": "Optional defaults for managed image presentation.",
-      "markdownDescription": "```yaml\nimages:\n  width: 900px\n  maxAvailableHeightPercent: 74\n```\n\nOverrides the available width and height used by Norna-managed images.\n\n[Image sizing reference](https://github.com/janga/norna/blob/v0.7.16/docs/theme.md#image-sizing)"
+      "markdownDescription": "```yaml\nimages:\n  width: 900px\n  maxAvailableHeightPercent: 74\n```\n\nOverrides the available width and height used by Norna-managed images.\n\n[Image sizing reference](https://github.com/janga/norna/blob/v0.7.18/docs/theme.md#image-sizing)"
     },
     "typography": {
       "type": "object",
@@ -363,7 +541,8 @@
         "fontFamily": {
           "description": "CSS font-family stack.",
           "type": "string",
-          "minLength": 1
+          "minLength": 1,
+          "markdownDescription": "```yaml\ntypography:\n  fontFamily: \"Arial, sans-serif\"\n```\n\nCSS font-family stack.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/typography.md#configuration-shape)"
         },
         "profile": {
           "description": "Typography profile. Omit this to keep the selected preset.",
@@ -389,7 +568,8 @@
               "title": "Statement",
               "description": "Stronger headings and tighter body rhythm for short, expressive pages."
             }
-          ]
+          ],
+          "markdownDescription": "```yaml\ntypography:\n  profile: reading\n```\n\nTypography profile. Omit this to keep the selected preset.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/typography.md#configuration-shape)"
         },
         "rhythm": {
           "description": "Typography spacing rhythm. Omit this to keep the selected preset.",
@@ -410,7 +590,8 @@
               "title": "Airy",
               "description": "Increase vertical spacing for a more expansive presentation."
             }
-          ]
+          ],
+          "markdownDescription": "```yaml\ntypography:\n  rhythm: normal\n```\n\nTypography spacing rhythm. Omit this to keep the selected preset.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/typography.md#configuration-shape)"
         },
         "overrides": {
           "description": "Focused typography overrides applied after the profile.",
@@ -447,7 +628,8 @@
                               "title": "Right",
                               "description": "Align text with the right edge of its text area."
                             }
-                          ]
+                          ],
+                          "markdownDescription": "```yaml\ntypography:\n  overrides:\n    headings:\n      h1:\n      \n  align:\n    desktop: left\n```\n\nText alignment on wider screens.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/typography.md#configuration-shape)"
                         },
                         "mobile": {
                           "description": "Text alignment on narrow screens.",
@@ -468,10 +650,22 @@
                               "title": "Right",
                               "description": "Align text with the right edge of its text area."
                             }
-                          ]
+                          ],
+                          "markdownDescription": "```yaml\ntypography:\n  overrides:\n    headings:\n      h1:\n      \n  align:\n    mobile: left\n```\n\nText alignment on narrow screens.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/typography.md#configuration-shape)"
                         }
                       },
-                      "additionalProperties": false
+                      "additionalProperties": false,
+                      "markdownDescription": "```yaml\ntypography:\n  overrides:\n    headings:\n      h1:\n      \n  align:\n    desktop: left\n    mobile: left\n```\n\nResponsive text alignment override.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/typography.md#configuration-shape)",
+                      "defaultSnippets": [
+                        {
+                          "label": "Responsive text alignment",
+                          "markdownDescription": "Set separate text alignment for wider and narrow screens.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/typography.md#configuration-shape)",
+                          "body": {
+                            "desktop": "${1:left}",
+                            "mobile": "${2:left}"
+                          }
+                        }
+                      ]
                     },
                     "size": {
                       "type": "string",
@@ -497,13 +691,15 @@
                           "title": "Extra large",
                           "description": "Use the largest available type size for exceptional emphasis."
                         }
-                      ]
+                      ],
+                      "markdownDescription": "```yaml\ntypography:\n  overrides:\n    headings:\n      h1:\n      \n  size: medium\n```\n\nText size from the active typography system. Omit an override to keep the profile value.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/typography.md#configuration-shape)"
                     },
                     "lineHeight": {
                       "type": "number",
                       "minimum": 1,
                       "maximum": 3,
-                      "description": "Unitless line height between 1 and 3."
+                      "description": "Unitless line height between 1 and 3.",
+                      "markdownDescription": "```yaml\ntypography:\n  overrides:\n    headings:\n      h1:\n      \n  lineHeight: 1.5\n```\n\nUnitless line height between 1 and 3.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/typography.md#configuration-shape)"
                     },
                     "weight": {
                       "description": "Heading font weight. Omit this to keep the profile value.",
@@ -528,20 +724,24 @@
                           "title": "Bold",
                           "description": "Use bold font weight."
                         }
-                      ]
+                      ],
+                      "markdownDescription": "```yaml\ntypography:\n  overrides:\n    headings:\n      h1:\n      \n  weight: 600\n```\n\nHeading font weight. Omit this to keep the profile value.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/typography.md#configuration-shape)"
                     },
                     "spacingBefore": {
                       "description": "Vertical space before the heading.",
                       "type": "string",
-                      "pattern": "^(?:0|(?:\\d+(?:\\.\\d+)?|\\.\\d+)(?:px|rem|em|ch|lh))$"
+                      "pattern": "^(?:0|(?:\\d+(?:\\.\\d+)?|\\.\\d+)(?:px|rem|em|ch|lh))$",
+                      "markdownDescription": "```yaml\ntypography:\n  overrides:\n    headings:\n      h1:\n      \n  spacingBefore: 1.5em\n```\n\nVertical space before the heading.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/typography.md#configuration-shape)"
                     },
                     "spacingAfter": {
                       "description": "Vertical space after the heading.",
                       "type": "string",
-                      "pattern": "^(?:0|(?:\\d+(?:\\.\\d+)?|\\.\\d+)(?:px|rem|em|ch|lh))$"
+                      "pattern": "^(?:0|(?:\\d+(?:\\.\\d+)?|\\.\\d+)(?:px|rem|em|ch|lh))$",
+                      "markdownDescription": "```yaml\ntypography:\n  overrides:\n    headings:\n      h1:\n      \n  spacingAfter: 0.5em\n```\n\nVertical space after the heading.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/typography.md#configuration-shape)"
                     }
                   },
-                  "additionalProperties": false
+                  "additionalProperties": false,
+                  "markdownDescription": "```yaml\ntypography:\n  overrides:\n    headings:\n      h1:\n        size: medium\n```\n\nOverrides for Markdown level 1 headings.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/typography.md#configuration-shape)"
                 },
                 "h2": {
                   "description": "Overrides for Markdown level 2 section headings.",
@@ -570,7 +770,8 @@
                               "title": "Right",
                               "description": "Align text with the right edge of its text area."
                             }
-                          ]
+                          ],
+                          "markdownDescription": "```yaml\ntypography:\n  overrides:\n    headings:\n      h2:\n      \n  align:\n    desktop: left\n```\n\nText alignment on wider screens.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/typography.md#configuration-shape)"
                         },
                         "mobile": {
                           "description": "Text alignment on narrow screens.",
@@ -591,10 +792,22 @@
                               "title": "Right",
                               "description": "Align text with the right edge of its text area."
                             }
-                          ]
+                          ],
+                          "markdownDescription": "```yaml\ntypography:\n  overrides:\n    headings:\n      h2:\n      \n  align:\n    mobile: left\n```\n\nText alignment on narrow screens.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/typography.md#configuration-shape)"
                         }
                       },
-                      "additionalProperties": false
+                      "additionalProperties": false,
+                      "markdownDescription": "```yaml\ntypography:\n  overrides:\n    headings:\n      h2:\n      \n  align:\n    desktop: left\n    mobile: left\n```\n\nResponsive text alignment override.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/typography.md#configuration-shape)",
+                      "defaultSnippets": [
+                        {
+                          "label": "Responsive text alignment",
+                          "markdownDescription": "Set separate text alignment for wider and narrow screens.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/typography.md#configuration-shape)",
+                          "body": {
+                            "desktop": "${1:left}",
+                            "mobile": "${2:left}"
+                          }
+                        }
+                      ]
                     },
                     "size": {
                       "type": "string",
@@ -620,13 +833,15 @@
                           "title": "Extra large",
                           "description": "Use the largest available type size for exceptional emphasis."
                         }
-                      ]
+                      ],
+                      "markdownDescription": "```yaml\ntypography:\n  overrides:\n    headings:\n      h2:\n      \n  size: medium\n```\n\nText size from the active typography system. Omit an override to keep the profile value.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/typography.md#configuration-shape)"
                     },
                     "lineHeight": {
                       "type": "number",
                       "minimum": 1,
                       "maximum": 3,
-                      "description": "Unitless line height between 1 and 3."
+                      "description": "Unitless line height between 1 and 3.",
+                      "markdownDescription": "```yaml\ntypography:\n  overrides:\n    headings:\n      h2:\n      \n  lineHeight: 1.5\n```\n\nUnitless line height between 1 and 3.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/typography.md#configuration-shape)"
                     },
                     "weight": {
                       "description": "Heading font weight. Omit this to keep the profile value.",
@@ -651,20 +866,24 @@
                           "title": "Bold",
                           "description": "Use bold font weight."
                         }
-                      ]
+                      ],
+                      "markdownDescription": "```yaml\ntypography:\n  overrides:\n    headings:\n      h2:\n      \n  weight: 600\n```\n\nHeading font weight. Omit this to keep the profile value.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/typography.md#configuration-shape)"
                     },
                     "spacingBefore": {
                       "description": "Vertical space before the heading.",
                       "type": "string",
-                      "pattern": "^(?:0|(?:\\d+(?:\\.\\d+)?|\\.\\d+)(?:px|rem|em|ch|lh))$"
+                      "pattern": "^(?:0|(?:\\d+(?:\\.\\d+)?|\\.\\d+)(?:px|rem|em|ch|lh))$",
+                      "markdownDescription": "```yaml\ntypography:\n  overrides:\n    headings:\n      h2:\n      \n  spacingBefore: 1.5em\n```\n\nVertical space before the heading.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/typography.md#configuration-shape)"
                     },
                     "spacingAfter": {
                       "description": "Vertical space after the heading.",
                       "type": "string",
-                      "pattern": "^(?:0|(?:\\d+(?:\\.\\d+)?|\\.\\d+)(?:px|rem|em|ch|lh))$"
+                      "pattern": "^(?:0|(?:\\d+(?:\\.\\d+)?|\\.\\d+)(?:px|rem|em|ch|lh))$",
+                      "markdownDescription": "```yaml\ntypography:\n  overrides:\n    headings:\n      h2:\n      \n  spacingAfter: 0.5em\n```\n\nVertical space after the heading.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/typography.md#configuration-shape)"
                     }
                   },
-                  "additionalProperties": false
+                  "additionalProperties": false,
+                  "markdownDescription": "```yaml\ntypography:\n  overrides:\n    headings:\n      h2:\n        size: medium\n```\n\nOverrides for Markdown level 2 section headings.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/typography.md#configuration-shape)"
                 },
                 "h3": {
                   "description": "Overrides for Markdown level 3 headings.",
@@ -693,7 +912,8 @@
                               "title": "Right",
                               "description": "Align text with the right edge of its text area."
                             }
-                          ]
+                          ],
+                          "markdownDescription": "```yaml\ntypography:\n  overrides:\n    headings:\n      h3:\n      \n  align:\n    desktop: left\n```\n\nText alignment on wider screens.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/typography.md#configuration-shape)"
                         },
                         "mobile": {
                           "description": "Text alignment on narrow screens.",
@@ -714,10 +934,22 @@
                               "title": "Right",
                               "description": "Align text with the right edge of its text area."
                             }
-                          ]
+                          ],
+                          "markdownDescription": "```yaml\ntypography:\n  overrides:\n    headings:\n      h3:\n      \n  align:\n    mobile: left\n```\n\nText alignment on narrow screens.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/typography.md#configuration-shape)"
                         }
                       },
-                      "additionalProperties": false
+                      "additionalProperties": false,
+                      "markdownDescription": "```yaml\ntypography:\n  overrides:\n    headings:\n      h3:\n      \n  align:\n    desktop: left\n    mobile: left\n```\n\nResponsive text alignment override.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/typography.md#configuration-shape)",
+                      "defaultSnippets": [
+                        {
+                          "label": "Responsive text alignment",
+                          "markdownDescription": "Set separate text alignment for wider and narrow screens.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/typography.md#configuration-shape)",
+                          "body": {
+                            "desktop": "${1:left}",
+                            "mobile": "${2:left}"
+                          }
+                        }
+                      ]
                     },
                     "size": {
                       "type": "string",
@@ -743,13 +975,15 @@
                           "title": "Extra large",
                           "description": "Use the largest available type size for exceptional emphasis."
                         }
-                      ]
+                      ],
+                      "markdownDescription": "```yaml\ntypography:\n  overrides:\n    headings:\n      h3:\n      \n  size: medium\n```\n\nText size from the active typography system. Omit an override to keep the profile value.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/typography.md#configuration-shape)"
                     },
                     "lineHeight": {
                       "type": "number",
                       "minimum": 1,
                       "maximum": 3,
-                      "description": "Unitless line height between 1 and 3."
+                      "description": "Unitless line height between 1 and 3.",
+                      "markdownDescription": "```yaml\ntypography:\n  overrides:\n    headings:\n      h3:\n      \n  lineHeight: 1.5\n```\n\nUnitless line height between 1 and 3.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/typography.md#configuration-shape)"
                     },
                     "weight": {
                       "description": "Heading font weight. Omit this to keep the profile value.",
@@ -774,20 +1008,24 @@
                           "title": "Bold",
                           "description": "Use bold font weight."
                         }
-                      ]
+                      ],
+                      "markdownDescription": "```yaml\ntypography:\n  overrides:\n    headings:\n      h3:\n      \n  weight: 600\n```\n\nHeading font weight. Omit this to keep the profile value.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/typography.md#configuration-shape)"
                     },
                     "spacingBefore": {
                       "description": "Vertical space before the heading.",
                       "type": "string",
-                      "pattern": "^(?:0|(?:\\d+(?:\\.\\d+)?|\\.\\d+)(?:px|rem|em|ch|lh))$"
+                      "pattern": "^(?:0|(?:\\d+(?:\\.\\d+)?|\\.\\d+)(?:px|rem|em|ch|lh))$",
+                      "markdownDescription": "```yaml\ntypography:\n  overrides:\n    headings:\n      h3:\n      \n  spacingBefore: 1.5em\n```\n\nVertical space before the heading.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/typography.md#configuration-shape)"
                     },
                     "spacingAfter": {
                       "description": "Vertical space after the heading.",
                       "type": "string",
-                      "pattern": "^(?:0|(?:\\d+(?:\\.\\d+)?|\\.\\d+)(?:px|rem|em|ch|lh))$"
+                      "pattern": "^(?:0|(?:\\d+(?:\\.\\d+)?|\\.\\d+)(?:px|rem|em|ch|lh))$",
+                      "markdownDescription": "```yaml\ntypography:\n  overrides:\n    headings:\n      h3:\n      \n  spacingAfter: 0.5em\n```\n\nVertical space after the heading.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/typography.md#configuration-shape)"
                     }
                   },
-                  "additionalProperties": false
+                  "additionalProperties": false,
+                  "markdownDescription": "```yaml\ntypography:\n  overrides:\n    headings:\n      h3:\n        size: medium\n```\n\nOverrides for Markdown level 3 headings.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/typography.md#configuration-shape)"
                 },
                 "h4": {
                   "description": "Overrides for Markdown level 4 headings.",
@@ -816,7 +1054,8 @@
                               "title": "Right",
                               "description": "Align text with the right edge of its text area."
                             }
-                          ]
+                          ],
+                          "markdownDescription": "```yaml\ntypography:\n  overrides:\n    headings:\n      h4:\n      \n  align:\n    desktop: left\n```\n\nText alignment on wider screens.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/typography.md#configuration-shape)"
                         },
                         "mobile": {
                           "description": "Text alignment on narrow screens.",
@@ -837,10 +1076,22 @@
                               "title": "Right",
                               "description": "Align text with the right edge of its text area."
                             }
-                          ]
+                          ],
+                          "markdownDescription": "```yaml\ntypography:\n  overrides:\n    headings:\n      h4:\n      \n  align:\n    mobile: left\n```\n\nText alignment on narrow screens.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/typography.md#configuration-shape)"
                         }
                       },
-                      "additionalProperties": false
+                      "additionalProperties": false,
+                      "markdownDescription": "```yaml\ntypography:\n  overrides:\n    headings:\n      h4:\n      \n  align:\n    desktop: left\n    mobile: left\n```\n\nResponsive text alignment override.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/typography.md#configuration-shape)",
+                      "defaultSnippets": [
+                        {
+                          "label": "Responsive text alignment",
+                          "markdownDescription": "Set separate text alignment for wider and narrow screens.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/typography.md#configuration-shape)",
+                          "body": {
+                            "desktop": "${1:left}",
+                            "mobile": "${2:left}"
+                          }
+                        }
+                      ]
                     },
                     "size": {
                       "type": "string",
@@ -866,13 +1117,15 @@
                           "title": "Extra large",
                           "description": "Use the largest available type size for exceptional emphasis."
                         }
-                      ]
+                      ],
+                      "markdownDescription": "```yaml\ntypography:\n  overrides:\n    headings:\n      h4:\n      \n  size: medium\n```\n\nText size from the active typography system. Omit an override to keep the profile value.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/typography.md#configuration-shape)"
                     },
                     "lineHeight": {
                       "type": "number",
                       "minimum": 1,
                       "maximum": 3,
-                      "description": "Unitless line height between 1 and 3."
+                      "description": "Unitless line height between 1 and 3.",
+                      "markdownDescription": "```yaml\ntypography:\n  overrides:\n    headings:\n      h4:\n      \n  lineHeight: 1.5\n```\n\nUnitless line height between 1 and 3.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/typography.md#configuration-shape)"
                     },
                     "weight": {
                       "description": "Heading font weight. Omit this to keep the profile value.",
@@ -897,23 +1150,28 @@
                           "title": "Bold",
                           "description": "Use bold font weight."
                         }
-                      ]
+                      ],
+                      "markdownDescription": "```yaml\ntypography:\n  overrides:\n    headings:\n      h4:\n      \n  weight: 600\n```\n\nHeading font weight. Omit this to keep the profile value.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/typography.md#configuration-shape)"
                     },
                     "spacingBefore": {
                       "description": "Vertical space before the heading.",
                       "type": "string",
-                      "pattern": "^(?:0|(?:\\d+(?:\\.\\d+)?|\\.\\d+)(?:px|rem|em|ch|lh))$"
+                      "pattern": "^(?:0|(?:\\d+(?:\\.\\d+)?|\\.\\d+)(?:px|rem|em|ch|lh))$",
+                      "markdownDescription": "```yaml\ntypography:\n  overrides:\n    headings:\n      h4:\n      \n  spacingBefore: 1.5em\n```\n\nVertical space before the heading.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/typography.md#configuration-shape)"
                     },
                     "spacingAfter": {
                       "description": "Vertical space after the heading.",
                       "type": "string",
-                      "pattern": "^(?:0|(?:\\d+(?:\\.\\d+)?|\\.\\d+)(?:px|rem|em|ch|lh))$"
+                      "pattern": "^(?:0|(?:\\d+(?:\\.\\d+)?|\\.\\d+)(?:px|rem|em|ch|lh))$",
+                      "markdownDescription": "```yaml\ntypography:\n  overrides:\n    headings:\n      h4:\n      \n  spacingAfter: 0.5em\n```\n\nVertical space after the heading.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/typography.md#configuration-shape)"
                     }
                   },
-                  "additionalProperties": false
+                  "additionalProperties": false,
+                  "markdownDescription": "```yaml\ntypography:\n  overrides:\n    headings:\n      h4:\n        size: medium\n```\n\nOverrides for Markdown level 4 headings.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/typography.md#configuration-shape)"
                 }
               },
-              "additionalProperties": false
+              "additionalProperties": false,
+              "markdownDescription": "```yaml\ntypography:\n  overrides:\n    headings:\n      h2:\n        size: medium\n```\n\nOverrides for heading levels.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/typography.md#configuration-shape)"
             },
             "body": {
               "description": "Overrides for body text.",
@@ -942,7 +1200,8 @@
                           "title": "Right",
                           "description": "Align text with the right edge of its text area."
                         }
-                      ]
+                      ],
+                      "markdownDescription": "```yaml\ntypography:\n  overrides:\n    body:\n  align:\n    desktop: left\n```\n\nText alignment on wider screens.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/typography.md#configuration-shape)"
                     },
                     "mobile": {
                       "description": "Text alignment on narrow screens.",
@@ -963,10 +1222,22 @@
                           "title": "Right",
                           "description": "Align text with the right edge of its text area."
                         }
-                      ]
+                      ],
+                      "markdownDescription": "```yaml\ntypography:\n  overrides:\n    body:\n  align:\n    mobile: left\n```\n\nText alignment on narrow screens.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/typography.md#configuration-shape)"
                     }
                   },
-                  "additionalProperties": false
+                  "additionalProperties": false,
+                  "markdownDescription": "```yaml\ntypography:\n  overrides:\n    body:\n  align:\n    desktop: left\n    mobile: left\n```\n\nResponsive text alignment override.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/typography.md#configuration-shape)",
+                  "defaultSnippets": [
+                    {
+                      "label": "Responsive text alignment",
+                      "markdownDescription": "Set separate text alignment for wider and narrow screens.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/typography.md#configuration-shape)",
+                      "body": {
+                        "desktop": "${1:left}",
+                        "mobile": "${2:left}"
+                      }
+                    }
+                  ]
                 },
                 "size": {
                   "type": "string",
@@ -992,42 +1263,25 @@
                       "title": "Extra large",
                       "description": "Use the largest available type size for exceptional emphasis."
                     }
-                  ]
+                  ],
+                  "markdownDescription": "```yaml\ntypography:\n  overrides:\n    body:\n  size: medium\n```\n\nText size from the active typography system. Omit an override to keep the profile value.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/typography.md#configuration-shape)"
                 },
                 "lineHeight": {
                   "type": "number",
                   "minimum": 1,
                   "maximum": 3,
-                  "description": "Unitless line height between 1 and 3."
-                },
-                "width": {
-                  "description": "Maximum body-text line length.",
-                  "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."
-                    }
-                  ]
+                  "description": "Unitless line height between 1 and 3.",
+                  "markdownDescription": "```yaml\ntypography:\n  overrides:\n    body:\n  lineHeight: 1.5\n```\n\nUnitless line height between 1 and 3.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/typography.md#configuration-shape)"
                 },
                 "paragraphSpacing": {
                   "description": "Vertical space between body paragraphs.",
                   "type": "string",
-                  "pattern": "^(?:0|(?:\\d+(?:\\.\\d+)?|\\.\\d+)(?:px|rem|em|ch|lh))$"
+                  "pattern": "^(?:0|(?:\\d+(?:\\.\\d+)?|\\.\\d+)(?:px|rem|em|ch|lh))$",
+                  "markdownDescription": "```yaml\ntypography:\n  overrides:\n    body:\n      paragraphSpacing: 1em\n```\n\nVertical space between body paragraphs.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/typography.md#configuration-shape)"
                 }
               },
-              "additionalProperties": false
+              "additionalProperties": false,
+              "markdownDescription": "```yaml\ntypography:\n  overrides:\n    body:\n      lineHeight: 1.55\n```\n\nOverrides for body text.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/typography.md#configuration-shape)"
             },
             "caption": {
               "description": "Overrides for image captions.",
@@ -1056,7 +1310,8 @@
                           "title": "Right",
                           "description": "Align text with the right edge of its text area."
                         }
-                      ]
+                      ],
+                      "markdownDescription": "```yaml\ntypography:\n  overrides:\n    caption:\n  align:\n    desktop: left\n```\n\nText alignment on wider screens.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/typography.md#configuration-shape)"
                     },
                     "mobile": {
                       "description": "Text alignment on narrow screens.",
@@ -1077,10 +1332,22 @@
                           "title": "Right",
                           "description": "Align text with the right edge of its text area."
                         }
-                      ]
+                      ],
+                      "markdownDescription": "```yaml\ntypography:\n  overrides:\n    caption:\n  align:\n    mobile: left\n```\n\nText alignment on narrow screens.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/typography.md#configuration-shape)"
                     }
                   },
-                  "additionalProperties": false
+                  "additionalProperties": false,
+                  "markdownDescription": "```yaml\ntypography:\n  overrides:\n    caption:\n  align:\n    desktop: left\n    mobile: left\n```\n\nResponsive text alignment override.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/typography.md#configuration-shape)",
+                  "defaultSnippets": [
+                    {
+                      "label": "Responsive text alignment",
+                      "markdownDescription": "Set separate text alignment for wider and narrow screens.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/typography.md#configuration-shape)",
+                      "body": {
+                        "desktop": "${1:left}",
+                        "mobile": "${2:left}"
+                      }
+                    }
+                  ]
                 },
                 "size": {
                   "type": "string",
@@ -1106,29 +1373,51 @@
                       "title": "Extra large",
                       "description": "Use the largest available type size for exceptional emphasis."
                     }
-                  ]
+                  ],
+                  "markdownDescription": "```yaml\ntypography:\n  overrides:\n    caption:\n  size: medium\n```\n\nText size from the active typography system. Omit an override to keep the profile value.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/typography.md#configuration-shape)"
                 },
                 "lineHeight": {
                   "type": "number",
                   "minimum": 1,
                   "maximum": 3,
-                  "description": "Unitless line height between 1 and 3."
+                  "description": "Unitless line height between 1 and 3.",
+                  "markdownDescription": "```yaml\ntypography:\n  overrides:\n    caption:\n  lineHeight: 1.5\n```\n\nUnitless line height between 1 and 3.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/typography.md#configuration-shape)"
                 },
                 "spacingBefore": {
                   "description": "Vertical space between an image and its caption.",
                   "type": "string",
-                  "pattern": "^(?:0|(?:\\d+(?:\\.\\d+)?|\\.\\d+)(?:px|rem|em|ch|lh))$"
+                  "pattern": "^(?:0|(?:\\d+(?:\\.\\d+)?|\\.\\d+)(?:px|rem|em|ch|lh))$",
+                  "markdownDescription": "```yaml\ntypography:\n  overrides:\n    caption:\n      spacingBefore: 0.5em\n```\n\nVertical space between an image and its caption.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/typography.md#configuration-shape)"
                 }
               },
-              "additionalProperties": false
+              "additionalProperties": false,
+              "markdownDescription": "```yaml\ntypography:\n  overrides:\n    caption:\n      size: small\n```\n\nOverrides for image captions.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/typography.md#configuration-shape)"
             }
           },
-          "additionalProperties": false
+          "additionalProperties": false,
+          "markdownDescription": "```yaml\ntypography:\n  overrides:\n    body:\n      lineHeight: 1.55\n```\n\nFocused typography overrides applied after the profile.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/typography.md#configuration-shape)",
+          "defaultSnippets": [
+            {
+              "label": "Typography overrides",
+              "markdownDescription": "Start a focused set of heading and body-text overrides.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/typography.md#configuration-shape)",
+              "body": {
+                "headings": {
+                  "h2": {
+                    "size": "${1:medium}",
+                    "weight": "${2:600}"
+                  }
+                },
+                "body": {
+                  "lineHeight": "${3:1.55}"
+                }
+              }
+            }
+          ]
         }
       },
       "additionalProperties": false,
       "description": "Typography profile, rhythm, font family, and focused overrides.",
-      "markdownDescription": "```yaml\ntypography:\n  profile: reading\n  rhythm: normal\n```\n\nOverrides the preset's font stack, typography profile, rhythm or individual text settings.\n\n[Typography configuration reference](https://github.com/janga/norna/blob/v0.7.16/docs/typography.md#configuration-shape)"
+      "markdownDescription": "```yaml\ntypography:\n  profile: reading\n  rhythm: normal\n```\n\nOverrides the preset's font stack, typography profile, rhythm or individual text settings.\n\n[Typography configuration reference](https://github.com/janga/norna/blob/v0.7.18/docs/typography.md#configuration-shape)"
     },
     "palette": {
       "type": "string",
@@ -1150,59 +1439,52 @@
           "description": "Warm off-white surfaces with dark text."
         }
       ],
-      "markdownDescription": "```yaml\npalette: paper\n```\n\nChooses a coordinated color system for the page frame, navigation, footer and section surfaces.\n\n[Palette and section surfaces](https://github.com/janga/norna/blob/v0.7.16/docs/theme.md#palette-and-section-surfaces)",
+      "markdownDescription": "```yaml\npalette: paper\n```\n\nChooses a coordinated color system for the page frame, navigation, footer and section surfaces.\n\n[Palette and section surfaces](https://github.com/janga/norna/blob/v0.7.18/docs/theme.md#palette-and-section-surfaces)",
       "examples": [
         "dark",
         "light",
         "paper"
       ]
     },
-    "sectionSurfaces": {
-      "description": "Surface sequence cycled through page sections. Omit this to keep the selected preset.",
-      "minItems": 1,
-      "maxItems": 3,
-      "type": "array",
-      "items": {
-        "type": "string",
-        "description": "Semantic section surface from the active palette.",
-        "oneOf": [
-          {
-            "const": "base",
-            "title": "Base",
-            "description": "Use the palette's normal page surface."
-          },
-          {
-            "const": "soft",
-            "title": "Soft",
-            "description": "Use the palette's subtle contrasting surface."
-          },
-          {
-            "const": "emphasis",
-            "title": "Emphasis",
-            "description": "Use the palette's strongest section surface."
-          }
-        ]
+    "sections": {
+      "type": "object",
+      "properties": {
+        "backgroundPattern": {
+          "description": "Section background sequence. Omit this to keep the selected preset or inherited page setting.",
+          "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. Omit this to keep the selected preset or inherited page setting.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.18/docs/theme.md#palette-and-section-surfaces)",
+          "examples": [
+            "uniform",
+            "alternating",
+            "cycling"
+          ]
+        }
       },
-      "markdownDescription": "```yaml\nsectionSurfaces: [base, soft, emphasis]\n```\n\nLists one to three semantic surfaces. Norna cycles through them in section order; omit this field to keep the preset sequence.\n\n[Palette and section surfaces](https://github.com/janga/norna/blob/v0.7.16/docs/theme.md#palette-and-section-surfaces)",
-      "examples": [
-        [
-          "base"
-        ],
-        [
-          "base",
-          "soft"
-        ],
-        [
-          "base",
-          "soft",
-          "emphasis"
-        ]
-      ]
+      "additionalProperties": false,
+      "description": "Defaults for page section presentation.",
+      "markdownDescription": "```yaml\nsections:\n  backgroundPattern: alternating\n```\n\nChooses whether section backgrounds stay uniform, alternate between two surfaces or cycle through three.\n\n[Palette and section surfaces](https://github.com/janga/norna/blob/v0.7.18/docs/theme.md#palette-and-section-surfaces)"
     }
   },
   "additionalProperties": false,
-  "description": "Visual settings for a site or route. A route theme replaces the inherited visual theme; site identity remains site-wide.",
+  "description": "Site-wide visual identity and default page presentation. Presets may be selected only in the root theme.",
   "$id": "https://janga.github.io/norna/schemas/theme.schema.json",
   "title": "Norna visual theme",
-  "markdownDescription": "```yaml\npreset: documentation\n```\n\nChoose one complete preset first. Add focused overrides only when the site needs to differ from it.\n\n[Theme reference](https://github.com/janga/norna/blob/v0.7.16/docs/theme.md)"
+  "markdownDescription": "```yaml\npreset: documentation\n```\n\nChoose one complete preset first. Add focused overrides only when the site needs to differ from it.\n\n[Theme reference](https://github.com/janga/norna/blob/v0.7.18/docs/theme.md)"
 }