npm - @janga/norna - Versions diffs - 0.7.16 → 0.7.18 - Mend

@janga/norna 0.7.16 → 0.7.18

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (342) hide show

package/examples/complete-sites/dog-shelter-single-page/.astro/collections/theme.schema.json CHANGED Viewed

@@ -3,6 +3,7 @@
   "type": "object",
   "properties": {
     "preset": {
+      "description": "Complete visual starting point. Add only the overrides the site actually needs.",
       "type": "string",
       "enum": [
         "portfolio",
@@ -11,10 +12,28 @@
         "statement"
       ]
     },
+    "navigation": {
+      "type": "object",
+      "properties": {
+        "mode": {
+          "description": "Navigation model. Omit this to keep the selected preset.",
+          "type": "string",
+          "enum": [
+            "automatic",
+            "sections",
+            "top",
+            "tree"
+          ]
+        }
+      },
+      "additionalProperties": false,
+      "description": "Site-wide navigation behavior. This may be set only in the root theme."
+    },
     "layout": {
       "type": "object",
       "properties": {
         "density": {
+          "description": "Overall spacing density. Omit this to keep the selected preset.",
           "type": "string",
           "enum": [
             "compact",
@@ -23,25 +42,30 @@
           ]
         },
         "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*\\))$"
         },
         "gutter": {
+          "description": "Horizontal page gutter as one value or separate desktop and mobile values.",
           "anyOf": [
             {
               "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*\\))$",
+              "description": "Responsive CSS length or clamp() expression."
             },
             {
               "type": "object",
               "properties": {
                 "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*\\))$"
+                  "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."
                 },
                 "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*\\))$"
+                  "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."
                 }
               },
               "required": [
@@ -53,24 +77,29 @@
           ]
         },
         "spacing": {
+          "description": "Fine-grained spacing overrides.",
           "type": "object",
           "properties": {
             "blockGap": {
+              "description": "Default vertical gap between structured content blocks.",
               "anyOf": [
                 {
                   "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*\\))$",
+                  "description": "Responsive CSS length or clamp() expression."
                 },
                 {
                   "type": "object",
                   "properties": {
                     "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*\\))$"
+                      "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."
                     },
                     "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*\\))$"
+                      "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."
                     }
                   },
                   "required": [
@@ -82,21 +111,25 @@
               ]
             },
             "finalSectionBottom": {
+              "description": "Bottom space after the final section.",
               "anyOf": [
                 {
                   "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*\\))$",
+                  "description": "Responsive CSS length or clamp() expression."
                 },
                 {
                   "type": "object",
                   "properties": {
                     "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*\\))$"
+                      "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."
                     },
                     "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*\\))$"
+                      "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."
                     }
                   },
                   "required": [
@@ -108,21 +141,25 @@
               ]
             },
             "firstSectionTop": {
+              "description": "Top space before the first section.",
               "anyOf": [
                 {
                   "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*\\))$",
+                  "description": "Responsive CSS length or clamp() expression."
                 },
                 {
                   "type": "object",
                   "properties": {
                     "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*\\))$"
+                      "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."
                     },
                     "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*\\))$"
+                      "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."
                     }
                   },
                   "required": [
@@ -134,21 +171,25 @@
               ]
             },
             "headingToBlock": {
+              "description": "Gap from a section heading to a following structured block.",
               "anyOf": [
                 {
                   "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*\\))$",
+                  "description": "Responsive CSS length or clamp() expression."
                 },
                 {
                   "type": "object",
                   "properties": {
                     "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*\\))$"
+                      "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."
                     },
                     "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*\\))$"
+                      "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."
                     }
                   },
                   "required": [
@@ -160,21 +201,25 @@
               ]
             },
             "imageGap": {
+              "description": "Gap between images in an image stack.",
               "anyOf": [
                 {
                   "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*\\))$",
+                  "description": "Responsive CSS length or clamp() expression."
                 },
                 {
                   "type": "object",
                   "properties": {
                     "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*\\))$"
+                      "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."
                     },
                     "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*\\))$"
+                      "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."
                     }
                   },
                   "required": [
@@ -186,21 +231,25 @@
               ]
             },
             "sectionGap": {
+              "description": "Vertical separation between page sections.",
               "anyOf": [
                 {
                   "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*\\))$",
+                  "description": "Responsive CSS length or clamp() expression."
                 },
                 {
                   "type": "object",
                   "properties": {
                     "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*\\))$"
+                      "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."
                     },
                     "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*\\))$"
+                      "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."
                     }
                   },
                   "required": [
@@ -215,16 +264,19 @@
           "additionalProperties": false
         }
       },
-      "additionalProperties": false
+      "additionalProperties": false,
+      "description": "Optional layout overrides applied after the preset."
     },
-    "gallery": {
+    "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*\\))$"
         },
         "maxAvailableWidthPercent": {
+          "description": "Maximum percentage of available horizontal space used by managed images.",
           "anyOf": [
             {
               "type": "number",
@@ -237,12 +289,14 @@
                 "desktop": {
                   "type": "number",
                   "exclusiveMinimum": 0,
-                  "maximum": 100
+                  "maximum": 100,
+                  "description": "Percentage used on wider screens."
                 },
                 "mobile": {
                   "type": "number",
                   "exclusiveMinimum": 0,
-                  "maximum": 100
+                  "maximum": 100,
+                  "description": "Percentage used on narrow screens."
                 }
               },
               "required": [
@@ -254,6 +308,7 @@
           ]
         },
         "maxAvailableHeightPercent": {
+          "description": "Maximum percentage of viewport height used by managed images.",
           "anyOf": [
             {
               "type": "number",
@@ -266,12 +321,14 @@
                 "desktop": {
                   "type": "number",
                   "exclusiveMinimum": 0,
-                  "maximum": 100
+                  "maximum": 100,
+                  "description": "Percentage used on wider screens."
                 },
                 "mobile": {
                   "type": "number",
                   "exclusiveMinimum": 0,
-                  "maximum": 100
+                  "maximum": 100,
+                  "description": "Percentage used on narrow screens."
                 }
               },
               "required": [
@@ -283,25 +340,29 @@
           ]
         }
       },
-      "additionalProperties": false
+      "additionalProperties": false,
+      "description": "Optional defaults for managed image presentation."
     },
     "typography": {
       "type": "object",
       "properties": {
         "fontFamily": {
+          "description": "CSS font-family stack.",
           "type": "string",
           "minLength": 1
         },
-        "preset": {
+        "profile": {
+          "description": "Typography profile. Omit this to keep the selected preset.",
           "type": "string",
           "enum": [
-            "quiet-gallery",
-            "compact-gallery",
-            "text-forward",
+            "restrained",
+            "dense",
+            "reading",
             "statement"
           ]
         },
         "rhythm": {
+          "description": "Typography spacing rhythm. Omit this to keep the selected preset.",
           "type": "string",
           "enum": [
             "compact",
@@ -310,18 +371,23 @@
           ]
         },
         "overrides": {
+          "description": "Focused typography overrides applied after the profile.",
           "type": "object",
           "properties": {
             "headings": {
+              "description": "Overrides for heading levels.",
               "type": "object",
               "properties": {
                 "h1": {
+                  "description": "Overrides for Markdown level 1 headings.",
                   "type": "object",
                   "properties": {
                     "align": {
+                      "description": "Responsive text alignment override.",
                       "type": "object",
                       "properties": {
                         "desktop": {
+                          "description": "Text alignment on wider screens.",
                           "type": "string",
                           "enum": [
                             "left",
@@ -330,6 +396,7 @@
                           ]
                         },
                         "mobile": {
+                          "description": "Text alignment on narrow screens.",
                           "type": "string",
                           "enum": [
                             "left",
@@ -347,14 +414,17 @@
                         "medium",
                         "large",
                         "xlarge"
-                      ]
+                      ],
+                      "description": "Text size from the active typography system. Omit an override to keep the profile value."
                     },
                     "lineHeight": {
                       "type": "number",
                       "minimum": 1,
-                      "maximum": 3
+                      "maximum": 3,
+                      "description": "Unitless line height between 1 and 3."
                     },
                     "weight": {
+                      "description": "Heading font weight. Omit this to keep the profile value.",
                       "anyOf": [
                         {
                           "type": "number",
@@ -375,10 +445,12 @@
                       ]
                     },
                     "spacingBefore": {
+                      "description": "Vertical space before the heading.",
                       "type": "string",
                       "pattern": "^(?:0|(?:\\d+(?:\\.\\d+)?|\\.\\d+)(?:px|rem|em|ch|lh))$"
                     },
                     "spacingAfter": {
+                      "description": "Vertical space after the heading.",
                       "type": "string",
                       "pattern": "^(?:0|(?:\\d+(?:\\.\\d+)?|\\.\\d+)(?:px|rem|em|ch|lh))$"
                     }
@@ -386,12 +458,15 @@
                   "additionalProperties": false
                 },
                 "h2": {
+                  "description": "Overrides for Markdown level 2 section headings.",
                   "type": "object",
                   "properties": {
                     "align": {
+                      "description": "Responsive text alignment override.",
                       "type": "object",
                       "properties": {
                         "desktop": {
+                          "description": "Text alignment on wider screens.",
                           "type": "string",
                           "enum": [
                             "left",
@@ -400,6 +475,7 @@
                           ]
                         },
                         "mobile": {
+                          "description": "Text alignment on narrow screens.",
                           "type": "string",
                           "enum": [
                             "left",
@@ -417,14 +493,17 @@
                         "medium",
                         "large",
                         "xlarge"
-                      ]
+                      ],
+                      "description": "Text size from the active typography system. Omit an override to keep the profile value."
                     },
                     "lineHeight": {
                       "type": "number",
                       "minimum": 1,
-                      "maximum": 3
+                      "maximum": 3,
+                      "description": "Unitless line height between 1 and 3."
                     },
                     "weight": {
+                      "description": "Heading font weight. Omit this to keep the profile value.",
                       "anyOf": [
                         {
                           "type": "number",
@@ -445,10 +524,12 @@
                       ]
                     },
                     "spacingBefore": {
+                      "description": "Vertical space before the heading.",
                       "type": "string",
                       "pattern": "^(?:0|(?:\\d+(?:\\.\\d+)?|\\.\\d+)(?:px|rem|em|ch|lh))$"
                     },
                     "spacingAfter": {
+                      "description": "Vertical space after the heading.",
                       "type": "string",
                       "pattern": "^(?:0|(?:\\d+(?:\\.\\d+)?|\\.\\d+)(?:px|rem|em|ch|lh))$"
                     }
@@ -456,12 +537,15 @@
                   "additionalProperties": false
                 },
                 "h3": {
+                  "description": "Overrides for Markdown level 3 headings.",
                   "type": "object",
                   "properties": {
                     "align": {
+                      "description": "Responsive text alignment override.",
                       "type": "object",
                       "properties": {
                         "desktop": {
+                          "description": "Text alignment on wider screens.",
                           "type": "string",
                           "enum": [
                             "left",
@@ -470,6 +554,7 @@
                           ]
                         },
                         "mobile": {
+                          "description": "Text alignment on narrow screens.",
                           "type": "string",
                           "enum": [
                             "left",
@@ -487,14 +572,17 @@
                         "medium",
                         "large",
                         "xlarge"
-                      ]
+                      ],
+                      "description": "Text size from the active typography system. Omit an override to keep the profile value."
                     },
                     "lineHeight": {
                       "type": "number",
                       "minimum": 1,
-                      "maximum": 3
+                      "maximum": 3,
+                      "description": "Unitless line height between 1 and 3."
                     },
                     "weight": {
+                      "description": "Heading font weight. Omit this to keep the profile value.",
                       "anyOf": [
                         {
                           "type": "number",
@@ -515,10 +603,12 @@
                       ]
                     },
                     "spacingBefore": {
+                      "description": "Vertical space before the heading.",
                       "type": "string",
                       "pattern": "^(?:0|(?:\\d+(?:\\.\\d+)?|\\.\\d+)(?:px|rem|em|ch|lh))$"
                     },
                     "spacingAfter": {
+                      "description": "Vertical space after the heading.",
                       "type": "string",
                       "pattern": "^(?:0|(?:\\d+(?:\\.\\d+)?|\\.\\d+)(?:px|rem|em|ch|lh))$"
                     }
@@ -526,12 +616,15 @@
                   "additionalProperties": false
                 },
                 "h4": {
+                  "description": "Overrides for Markdown level 4 headings.",
                   "type": "object",
                   "properties": {
                     "align": {
+                      "description": "Responsive text alignment override.",
                       "type": "object",
                       "properties": {
                         "desktop": {
+                          "description": "Text alignment on wider screens.",
                           "type": "string",
                           "enum": [
                             "left",
@@ -540,6 +633,7 @@
                           ]
                         },
                         "mobile": {
+                          "description": "Text alignment on narrow screens.",
                           "type": "string",
                           "enum": [
                             "left",
@@ -557,14 +651,17 @@
                         "medium",
                         "large",
                         "xlarge"
-                      ]
+                      ],
+                      "description": "Text size from the active typography system. Omit an override to keep the profile value."
                     },
                     "lineHeight": {
                       "type": "number",
                       "minimum": 1,
-                      "maximum": 3
+                      "maximum": 3,
+                      "description": "Unitless line height between 1 and 3."
                     },
                     "weight": {
+                      "description": "Heading font weight. Omit this to keep the profile value.",
                       "anyOf": [
                         {
                           "type": "number",
@@ -585,10 +682,12 @@
                       ]
                     },
                     "spacingBefore": {
+                      "description": "Vertical space before the heading.",
                       "type": "string",
                       "pattern": "^(?:0|(?:\\d+(?:\\.\\d+)?|\\.\\d+)(?:px|rem|em|ch|lh))$"
                     },
                     "spacingAfter": {
+                      "description": "Vertical space after the heading.",
                       "type": "string",
                       "pattern": "^(?:0|(?:\\d+(?:\\.\\d+)?|\\.\\d+)(?:px|rem|em|ch|lh))$"
                     }
@@ -599,12 +698,15 @@
               "additionalProperties": false
             },
             "body": {
+              "description": "Overrides for body text.",
               "type": "object",
               "properties": {
                 "align": {
+                  "description": "Responsive text alignment override.",
                   "type": "object",
                   "properties": {
                     "desktop": {
+                      "description": "Text alignment on wider screens.",
                       "type": "string",
                       "enum": [
                         "left",
@@ -613,6 +715,7 @@
                       ]
                     },
                     "mobile": {
+                      "description": "Text alignment on narrow screens.",
                       "type": "string",
                       "enum": [
                         "left",
@@ -630,14 +733,17 @@
                     "medium",
                     "large",
                     "xlarge"
-                  ]
+                  ],
+                  "description": "Text size from the active typography system. Omit an override to keep the profile value."
                 },
                 "lineHeight": {
                   "type": "number",
                   "minimum": 1,
-                  "maximum": 3
+                  "maximum": 3,
+                  "description": "Unitless line height between 1 and 3."
                 },
                 "width": {
+                  "description": "Maximum body-text line length.",
                   "type": "string",
                   "enum": [
                     "narrow",
@@ -646,6 +752,7 @@
                   ]
                 },
                 "paragraphSpacing": {
+                  "description": "Vertical space between body paragraphs.",
                   "type": "string",
                   "pattern": "^(?:0|(?:\\d+(?:\\.\\d+)?|\\.\\d+)(?:px|rem|em|ch|lh))$"
                 }
@@ -653,12 +760,15 @@
               "additionalProperties": false
             },
             "caption": {
+              "description": "Overrides for image captions.",
               "type": "object",
               "properties": {
                 "align": {
+                  "description": "Responsive text alignment override.",
                   "type": "object",
                   "properties": {
                     "desktop": {
+                      "description": "Text alignment on wider screens.",
                       "type": "string",
                       "enum": [
                         "left",
@@ -667,6 +777,7 @@
                       ]
                     },
                     "mobile": {
+                      "description": "Text alignment on narrow screens.",
                       "type": "string",
                       "enum": [
                         "left",
@@ -684,14 +795,17 @@
                     "medium",
                     "large",
                     "xlarge"
-                  ]
+                  ],
+                  "description": "Text size from the active typography system. Omit an override to keep the profile value."
                 },
                 "lineHeight": {
                   "type": "number",
                   "minimum": 1,
-                  "maximum": 3
+                  "maximum": 3,
+                  "description": "Unitless line height between 1 and 3."
                 },
                 "spacingBefore": {
+                  "description": "Vertical space between an image and its caption.",
                   "type": "string",
                   "pattern": "^(?:0|(?:\\d+(?:\\.\\d+)?|\\.\\d+)(?:px|rem|em|ch|lh))$"
                 }
@@ -702,54 +816,37 @@
           "additionalProperties": false
         }
       },
-      "additionalProperties": false
+      "additionalProperties": false,
+      "description": "Typography profile, rhythm, font family, and focused overrides."
     },
-    "presentation": {
-      "type": "object",
-      "properties": {
-        "palette": {
-          "type": "string",
-          "enum": [
-            "dark",
-            "light",
-            "paper"
-          ]
-        },
-        "sectionSurfaces": {
-          "type": "object",
-          "properties": {
-            "mode": {
-              "type": "string",
-              "enum": [
-                "none",
-                "cycle"
-              ]
-            },
-            "sequence": {
-              "minItems": 1,
-              "maxItems": 3,
-              "type": "array",
-              "items": {
-                "type": "string",
-                "enum": [
-                  "base",
-                  "soft",
-                  "emphasis"
-                ]
-              }
-            }
-          },
-          "required": [
-            "mode"
-          ],
-          "additionalProperties": false
-        }
-      },
-      "additionalProperties": false
+    "palette": {
+      "type": "string",
+      "enum": [
+        "dark",
+        "light",
+        "paper"
+      ],
+      "description": "Coordinated site color palette. Omit this to use the selected preset."
+    },
+    "sectionSurfaces": {
+      "description": "Surface sequence cycled through page sections. Omit this to keep the selected preset.",
+      "minItems": 1,
+      "maxItems": 3,
+      "type": "array",
+      "items": {
+        "type": "string",
+        "enum": [
+          "base",
+          "soft",
+          "emphasis"
+        ],
+        "description": "Semantic section surface from the active palette."
+      }
     },
     "$schema": {
       "type": "string"
     }
   },
-  "additionalProperties": false
+  "additionalProperties": false,
+  "description": "Visual settings for a site or page. A page theme replaces the inherited visual theme; navigation logo settings remain site-wide."
 }