@janga/norna 0.7.9 → 0.7.11

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

@@ -0,0 +1,44 @@
+---
+title: Surfaces
+description: See how palette defaults and section surfaces work together.
+navigation:
+  label: Surfaces
+---
+
+## Palette options {#palette-options}
+
+Norna currently provides a small set of named palettes. The theme chooses one
+for the whole site:
+
+```yaml
+presentation:
+  palette: dark
+```
+
+The available choices are `dark`, `light` and `paper`. A palette defines the
+page, navigation, frame and section colours together, so these parts stay in
+balance.
+
+## Emphasis surface {#emphasis-surface}
+
+The route theme uses a palette and a surface sequence when a visual pause or
+change of rhythm helps the reader. This is not a free-form colour override:
+
+```yaml
+presentation:
+  sectionSurfaces:
+    mode: cycle
+    sequence: [base, soft, emphasis]
+```
+
+The theme can cycle through the selected surfaces automatically. Individual
+sections do not select their own colours.
+
+## A practical rule {#practical-rule}
+
+Use the site palette for the overall tone. Use soft and emphasis surfaces for a
+small number of meaningful transitions, not to make every section look
+unrelated.
+
+Typography presets and media blocks can vary the content inside that system;
+surfaces provide the route-level rhythm around it.

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

@@ -0,0 +1,8 @@
+---
+preset: project
+presentation:
+  palette: light
+  sectionSurfaces:
+    mode: cycle
+    sequence: [base, soft, emphasis]
+---

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

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

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

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

package/examples/{typography-presets/.astro/collections/theme.schema.json → feature-demos/theme-presets/.astro/collections/routeTheme.schema.json}

@@ -2,16 +2,6 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "type": "object",
   "properties": {
-    "navigation": {
-      "type": "object",
-      "properties": {
-        "brand": {
-          "type": "string",
-          "minLength": 1
-        }
-      },
-      "additionalProperties": false
-    },
     "layout": {
       "type": "object",
       "properties": {
@@ -56,7 +46,7 @@
         "spacing": {
           "type": "object",
           "properties": {
-            "bodyToImages": {
+            "blockGap": {
               "anyOf": [
                 {
                   "type": "string",
@@ -134,6 +124,32 @@
                 }
               ]
             },
+            "headingToBlock": {
+              "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*\\))$"
+                },
+                {
+                  "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*\\))$"
+                    },
+                    "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*\\))$"
+                    }
+                  },
+                  "required": [
+                    "desktop",
+                    "mobile"
+                  ],
+                  "additionalProperties": false
+                }
+              ]
+            },
             "imageGap": {
               "anyOf": [
                 {
@@ -329,6 +345,26 @@
                       "minimum": 1,
                       "maximum": 3
                     },
+                    "weight": {
+                      "anyOf": [
+                        {
+                          "type": "number",
+                          "const": 400
+                        },
+                        {
+                          "type": "number",
+                          "const": 500
+                        },
+                        {
+                          "type": "number",
+                          "const": 600
+                        },
+                        {
+                          "type": "number",
+                          "const": 700
+                        }
+                      ]
+                    },
                     "spacingBefore": {
                       "type": "string",
                       "pattern": "^(?:0|(?:\\d+(?:\\.\\d+)?|\\.\\d+)(?:px|rem|em|ch|lh))$"
@@ -379,6 +415,26 @@
                       "minimum": 1,
                       "maximum": 3
                     },
+                    "weight": {
+                      "anyOf": [
+                        {
+                          "type": "number",
+                          "const": 400
+                        },
+                        {
+                          "type": "number",
+                          "const": 500
+                        },
+                        {
+                          "type": "number",
+                          "const": 600
+                        },
+                        {
+                          "type": "number",
+                          "const": 700
+                        }
+                      ]
+                    },
                     "spacingBefore": {
                       "type": "string",
                       "pattern": "^(?:0|(?:\\d+(?:\\.\\d+)?|\\.\\d+)(?:px|rem|em|ch|lh))$"
@@ -429,6 +485,26 @@
                       "minimum": 1,
                       "maximum": 3
                     },
+                    "weight": {
+                      "anyOf": [
+                        {
+                          "type": "number",
+                          "const": 400
+                        },
+                        {
+                          "type": "number",
+                          "const": 500
+                        },
+                        {
+                          "type": "number",
+                          "const": 600
+                        },
+                        {
+                          "type": "number",
+                          "const": 700
+                        }
+                      ]
+                    },
                     "spacingBefore": {
                       "type": "string",
                       "pattern": "^(?:0|(?:\\d+(?:\\.\\d+)?|\\.\\d+)(?:px|rem|em|ch|lh))$"
@@ -479,6 +555,26 @@
                       "minimum": 1,
                       "maximum": 3
                     },
+                    "weight": {
+                      "anyOf": [
+                        {
+                          "type": "number",
+                          "const": 400
+                        },
+                        {
+                          "type": "number",
+                          "const": 500
+                        },
+                        {
+                          "type": "number",
+                          "const": 600
+                        },
+                        {
+                          "type": "number",
+                          "const": 700
+                        }
+                      ]
+                    },
                     "spacingBefore": {
                       "type": "string",
                       "pattern": "^(?:0|(?:\\d+(?:\\.\\d+)?|\\.\\d+)(?:px|rem|em|ch|lh))$"
@@ -532,6 +628,14 @@
                   "minimum": 1,
                   "maximum": 3
                 },
+                "width": {
+                  "type": "string",
+                  "enum": [
+                    "narrow",
+                    "normal",
+                    "wide"
+                  ]
+                },
                 "paragraphSpacing": {
                   "type": "string",
                   "pattern": "^(?:0|(?:\\d+(?:\\.\\d+)?|\\.\\d+)(?:px|rem|em|ch|lh))$"
@@ -594,68 +698,42 @@
     "presentation": {
       "type": "object",
       "properties": {
-        "backgroundColor": {
-          "type": "string",
-          "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$"
-        },
-        "textColor": {
+        "palette": {
           "type": "string",
-          "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$"
+          "enum": [
+            "dark",
+            "light",
+            "paper"
+          ]
         },
-        "inlineStyles": {
+        "sectionSurfaces": {
           "type": "object",
-          "propertyNames": {
-            "type": "string",
-            "pattern": "^[a-z][a-z0-9-]*$"
-          },
-          "additionalProperties": {
-            "type": "object",
-            "properties": {
-              "color": {
-                "type": "string",
-                "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$"
-              }
-            },
-            "required": [
-              "color"
-            ],
-            "additionalProperties": false
-          }
-        }
-      },
-      "additionalProperties": false
-    },
-    "frame": {
-      "type": "object",
-      "properties": {
-        "colors": {
-          "anyOf": [
-            {
+          "properties": {
+            "mode": {
               "type": "string",
               "enum": [
-                "theme",
-                "presentation"
+                "none",
+                "cycle"
               ]
             },
-            {
-              "type": "object",
-              "properties": {
-                "backgroundColor": {
-                  "type": "string",
-                  "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$"
-                },
-                "textColor": {
-                  "type": "string",
-                  "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$"
-                }
-              },
-              "required": [
-                "backgroundColor",
-                "textColor"
-              ],
-              "additionalProperties": false
+            "sequence": {
+              "minItems": 1,
+              "maxItems": 3,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "enum": [
+                  "base",
+                  "soft",
+                  "emphasis"
+                ]
+              }
             }
-          ]
+          },
+          "required": [
+            "mode"
+          ],
+          "additionalProperties": false
         }
       },
       "additionalProperties": false

package/examples/feature-demos/theme-presets/.astro/collections/site.schema.json

@@ -0,0 +1,59 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "title": {
+      "type": "string"
+    },
+    "description": {
+      "type": "string"
+    },
+    "navigation": {
+      "type": "object",
+      "properties": {
+        "include": {
+          "type": "boolean"
+        },
+        "label": {
+          "type": "string"
+        }
+      },
+      "additionalProperties": false
+    },
+    "sections": {
+      "default": {},
+      "type": "object",
+      "propertyNames": {
+        "type": "string",
+        "pattern": "^[a-z0-9-]+$"
+      },
+      "additionalProperties": {
+        "type": "object",
+        "properties": {
+          "visible": {
+            "type": "object",
+            "properties": {
+              "from": {
+                "type": "string",
+                "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
+              },
+              "until": {
+                "type": "string",
+                "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
+              }
+            },
+            "additionalProperties": false
+          }
+        },
+        "additionalProperties": false
+      }
+    },
+    "$schema": {
+      "type": "string"
+    }
+  },
+  "required": [
+    "title",
+    "description"
+  ]
+}

package/examples/feature-demos/theme-presets/.astro/collections/sitewide.schema.json

@@ -0,0 +1,138 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "navigation": {
+      "type": "object",
+      "properties": {
+        "brand": {
+          "type": "string",
+          "minLength": 1
+        },
+        "logo": {
+          "type": "object",
+          "properties": {
+            "alt": {
+              "type": "string",
+              "minLength": 1
+            },
+            "height": {
+              "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*\\))$"
+            }
+          },
+          "additionalProperties": false
+        }
+      },
+      "additionalProperties": false
+    },
+    "banners": {
+      "default": [],
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string",
+            "pattern": "^[a-z0-9-]+$"
+          },
+          "tone": {
+            "default": "warning",
+            "type": "string",
+            "enum": [
+              "warning"
+            ]
+          },
+          "visible": {
+            "type": "object",
+            "properties": {
+              "from": {
+                "type": "string",
+                "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
+              },
+              "until": {
+                "type": "string",
+                "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
+              }
+            },
+            "additionalProperties": false
+          },
+          "title": {
+            "type": "string",
+            "minLength": 1
+          },
+          "text": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "required": [
+          "id",
+          "title",
+          "text"
+        ],
+        "additionalProperties": false
+      }
+    },
+    "footer": {
+      "type": "object",
+      "properties": {
+        "copyrightMessage": {
+          "type": "string",
+          "minLength": 1
+        },
+        "buildInfo": {
+          "type": "object",
+          "properties": {
+            "enabled": {
+              "default": true,
+              "type": "boolean"
+            },
+            "text": {
+              "type": "string",
+              "minLength": 1
+            },
+            "dateTimeFormat": {
+              "type": "object",
+              "properties": {
+                "locale": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "timeZone": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "dateStyle": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "timeStyle": {
+                  "type": "string",
+                  "minLength": 1
+                }
+              },
+              "required": [
+                "locale",
+                "timeZone",
+                "dateStyle",
+                "timeStyle"
+              ],
+              "additionalProperties": false
+            }
+          },
+          "required": [
+            "text",
+            "dateTimeFormat"
+          ],
+          "additionalProperties": false
+        }
+      },
+      "additionalProperties": false
+    },
+    "$schema": {
+      "type": "string"
+    }
+  },
+  "additionalProperties": false
+}