@janga/norna 0.7.24 → 0.7.25

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 (43) hide show
  1. package/README.md +2 -2
  2. package/astro.config.mjs +2 -0
  3. package/package.json +14 -2
  4. package/schemas/category.schema.json +2 -2
  5. package/schemas/config.schema.json +56 -21
  6. package/schemas/content-frontmatter.schema.json +7 -7
  7. package/schemas/page-theme.schema.json +26 -26
  8. package/schemas/sitewide-content.schema.json +18 -18
  9. package/schemas/theme.schema.json +241 -241
  10. package/scripts/check-config.mjs +5 -1
  11. package/scripts/dev-local.mjs +106 -11
  12. package/scripts/init-site.mjs +2 -0
  13. package/scripts/lib/code-fence-metadata.mjs +11 -6
  14. package/scripts/lib/edit-source-link.mjs +53 -0
  15. package/scripts/lib/navigation-model.mjs +1 -1
  16. package/scripts/lib/norna-markdown-blocks.mjs +91 -0
  17. package/scripts/lib/project-config.mjs +42 -12
  18. package/scripts/lib/schema-definitions.mjs +10 -2
  19. package/scripts/lib/schema-editor-metadata.mjs +20 -3
  20. package/scripts/lib/schema-value-definitions.mjs +3 -0
  21. package/scripts/lib/site-paths.mjs +14 -2
  22. package/scripts/lib/table-render-plugin.mjs +33 -0
  23. package/src/components/CardList.astro +1 -0
  24. package/src/components/CodeBlockCopyScript.astro +2 -1
  25. package/src/components/ImageCarousel.astro +4 -1
  26. package/src/components/ImageStack.astro +34 -9
  27. package/src/components/ImageStackEnhancement.astro +331 -0
  28. package/src/components/PageContentsNavigation.astro +2 -3
  29. package/src/components/SectionNavigationScript.astro +45 -7
  30. package/src/components/SiteNavigation.astro +73 -49
  31. package/src/components/SitePage.astro +38 -23
  32. package/src/components/SiteTreeNavigation.astro +3 -0
  33. package/src/components/TableOverflowScript.astro +251 -0
  34. package/src/components/TreeNavigationScript.astro +78 -22
  35. package/src/layouts/BaseLayout.astro +31 -5
  36. package/src/lib/generatedImages.ts +18 -0
  37. package/src/lib/sectionContent.ts +4 -27
  38. package/src/lib/sitePages.ts +6 -3
  39. package/src/styles/content.css +298 -23
  40. package/src/styles/media.css +187 -3
  41. package/src/styles/navigation.css +168 -3
  42. package/src/styles/page-layout.css +48 -16
  43. package/src/styles/responsive.css +67 -20
@@ -12,12 +12,12 @@
12
12
  "examples": [
13
13
  "2rem"
14
14
  ],
15
- "markdownDescription": "```yaml\nlogo:\n height: 2rem\n```\n\nDisplayed logo height on wider screens. Omit it to use 2.6rem; narrow screens cap the height at 2.15rem. Width follows the intrinsic aspect ratio.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.24/docs/public-files.md#navigation-logo)"
15
+ "markdownDescription": "```yaml\nlogo:\n height: 2rem\n```\n\nDisplayed logo height on wider screens. Omit it to use 2.6rem; narrow screens cap the height at 2.15rem. Width follows the intrinsic aspect ratio.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.25/docs/public-files.md#navigation-logo)"
16
16
  }
17
17
  },
18
18
  "additionalProperties": false,
19
19
  "description": "Optional display settings for a convention-based navigation logo.",
20
- "markdownDescription": "```yaml\nlogo:\n height: 2rem\n```\n\n`logo` optionally overrides the displayed height of the convention-based logo file. Without an override, Norna uses 2.6rem on wider screens and caps the logo at 2.15rem on narrow screens. The logo links home, and its alternative text comes from the homepage Markdown H1. This setting does not enable or select the file.\n\n[Navigation logo filenames and placement](https://github.com/janga/norna/blob/v0.7.24/docs/public-files.md#navigation-logo)"
20
+ "markdownDescription": "```yaml\nlogo:\n height: 2rem\n```\n\n`logo` optionally overrides the displayed height of the convention-based logo file. Without an override, Norna uses 2.6rem on wider screens and caps the logo at 2.15rem on narrow screens. The logo links home, and its alternative text comes from the homepage Markdown H1. This setting does not enable or select the file.\n\n[Navigation logo filenames and placement](https://github.com/janga/norna/blob/v0.7.25/docs/public-files.md#navigation-logo)"
21
21
  },
22
22
  "banners": {
23
23
  "default": [],
@@ -30,7 +30,7 @@
30
30
  "type": "string",
31
31
  "pattern": "^[a-z0-9-]+$",
32
32
  "description": "Stable banner identifier used for dismissal state.",
33
- "markdownDescription": "```yaml\nbanners:\n - id: project-status\n```\n\nStable banner identifier used for dismissal state.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.24/docs/sitewide-content.md#banners)"
33
+ "markdownDescription": "```yaml\nbanners:\n - id: project-status\n```\n\nStable banner identifier used for dismissal state.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.25/docs/sitewide-content.md#banners)"
34
34
  },
35
35
  "tone": {
36
36
  "default": "warning",
@@ -41,10 +41,10 @@
41
41
  "const": "warning",
42
42
  "title": "Warning",
43
43
  "description": "Present the banner as an important warning notice.",
44
- "markdownDescription": "Present the banner as an important warning notice.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.24/docs/sitewide-content.md#banners)"
44
+ "markdownDescription": "Present the banner as an important warning notice.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.25/docs/sitewide-content.md#banners)"
45
45
  }
46
46
  ],
47
- "markdownDescription": "```yaml\nbanners:\n - tone: warning\n```\n\nSemantic banner tone.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.24/docs/sitewide-content.md#banners)"
47
+ "markdownDescription": "```yaml\nbanners:\n - tone: warning\n```\n\nSemantic banner tone.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.25/docs/sitewide-content.md#banners)"
48
48
  },
49
49
  "visible": {
50
50
  "description": "Optional date window for the banner.",
@@ -54,21 +54,21 @@
54
54
  "description": "First date on which the content is visible.",
55
55
  "type": "string",
56
56
  "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
57
- "markdownDescription": "```yaml\nbanners:\n - visible:\n from: \"2026-01-01\"\n```\n\nFirst date on which the content is visible.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.24/docs/sitewide-content.md#banners)"
57
+ "markdownDescription": "```yaml\nbanners:\n - visible:\n from: \"2026-01-01\"\n```\n\nFirst date on which the content is visible.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.25/docs/sitewide-content.md#banners)"
58
58
  },
59
59
  "until": {
60
60
  "description": "First date on which the content is no longer visible.",
61
61
  "type": "string",
62
62
  "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
63
- "markdownDescription": "```yaml\nbanners:\n - visible:\n until: \"2026-02-01\"\n```\n\nFirst date on which the content is no longer visible.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.24/docs/sitewide-content.md#banners)"
63
+ "markdownDescription": "```yaml\nbanners:\n - visible:\n until: \"2026-02-01\"\n```\n\nFirst date on which the content is no longer visible.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.25/docs/sitewide-content.md#banners)"
64
64
  }
65
65
  },
66
66
  "additionalProperties": false,
67
- "markdownDescription": "```yaml\nbanners:\n - visible:\n from: \"2026-01-01\"\n until: \"2026-02-01\"\n```\n\nOptional date window for the banner.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.24/docs/sitewide-content.md#banners)",
67
+ "markdownDescription": "```yaml\nbanners:\n - visible:\n from: \"2026-01-01\"\n until: \"2026-02-01\"\n```\n\nOptional date window for the banner.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.25/docs/sitewide-content.md#banners)",
68
68
  "defaultSnippets": [
69
69
  {
70
70
  "label": "Visibility window",
71
- "markdownDescription": "Show the banner from the first date up to, but not including, the second date.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.24/docs/sitewide-content.md#banners)",
71
+ "markdownDescription": "Show the banner from the first date up to, but not including, the second date.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.25/docs/sitewide-content.md#banners)",
72
72
  "body": {
73
73
  "from": "${1:2026-01-01}",
74
74
  "until": "${2:2026-02-01}"
@@ -80,13 +80,13 @@
80
80
  "type": "string",
81
81
  "minLength": 1,
82
82
  "description": "Short banner heading.",
83
- "markdownDescription": "```yaml\nbanners:\n - title: Important notice\n```\n\nShort banner heading.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.24/docs/sitewide-content.md#banners)"
83
+ "markdownDescription": "```yaml\nbanners:\n - title: Important notice\n```\n\nShort banner heading.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.25/docs/sitewide-content.md#banners)"
84
84
  },
85
85
  "text": {
86
86
  "type": "string",
87
87
  "minLength": 1,
88
88
  "description": "Concise banner message.",
89
- "markdownDescription": "```yaml\nbanners:\n - text: Brief explanation.\n```\n\nConcise banner message.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.24/docs/sitewide-content.md#banners)"
89
+ "markdownDescription": "```yaml\nbanners:\n - text: Brief explanation.\n```\n\nConcise banner message.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.25/docs/sitewide-content.md#banners)"
90
90
  }
91
91
  },
92
92
  "required": [
@@ -97,11 +97,11 @@
97
97
  "additionalProperties": false,
98
98
  "description": "Dismissible site-wide warning shown above page content for important temporary information.",
99
99
  "title": "Warning banner",
100
- "markdownDescription": "A `warning` is a dismissible site-wide notice shown above page content. Use it for important temporary information visitors should notice, rather than ordinary page content.\n\n[Banner reference](https://github.com/janga/norna/blob/v0.7.24/docs/sitewide-content.md#banners)",
100
+ "markdownDescription": "A `warning` is a dismissible site-wide notice shown above page content. Use it for important temporary information visitors should notice, rather than ordinary page content.\n\n[Banner reference](https://github.com/janga/norna/blob/v0.7.25/docs/sitewide-content.md#banners)",
101
101
  "defaultSnippets": [
102
102
  {
103
103
  "label": "Warning banner",
104
- "markdownDescription": "A `warning` is a dismissible site-wide notice shown above page content. Use it for important temporary information visitors should notice, rather than ordinary page content.\n\n[Banner reference](https://github.com/janga/norna/blob/v0.7.24/docs/sitewide-content.md#banners)",
104
+ "markdownDescription": "A `warning` is a dismissible site-wide notice shown above page content. Use it for important temporary information visitors should notice, rather than ordinary page content.\n\n[Banner reference](https://github.com/janga/norna/blob/v0.7.25/docs/sitewide-content.md#banners)",
105
105
  "body": {
106
106
  "id": "${1:project-status}",
107
107
  "tone": "warning",
@@ -111,7 +111,7 @@
111
111
  }
112
112
  ]
113
113
  },
114
- "markdownDescription": "```yaml\nbanners:\n - id: project-status\n tone: warning\n title: Experimental code\n text: Not for production use.\n```\n\nAdds dismissible notices above page content. List order controls their presentation order; each `id` must be unique.\n\n[Banner reference](https://github.com/janga/norna/blob/v0.7.24/docs/sitewide-content.md#banners)"
114
+ "markdownDescription": "```yaml\nbanners:\n - id: project-status\n tone: warning\n title: Experimental code\n text: Not for production use.\n```\n\nAdds dismissible notices above page content. List order controls their presentation order; each `id` must be unique.\n\n[Banner reference](https://github.com/janga/norna/blob/v0.7.25/docs/sitewide-content.md#banners)"
115
115
  },
116
116
  "footer": {
117
117
  "description": "Site-wide footer content.",
@@ -121,22 +121,22 @@
121
121
  "description": "Copyright or ownership text shown in the site footer.",
122
122
  "type": "string",
123
123
  "minLength": 1,
124
- "markdownDescription": "```yaml\nfooter:\n copyrightMessage: Copyright Example Owner.\n```\n\nCopyright or ownership text shown in the site footer.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.24/docs/sitewide-content.md#footer)"
124
+ "markdownDescription": "```yaml\nfooter:\n copyrightMessage: Copyright Example Owner.\n```\n\nCopyright or ownership text shown in the site footer.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.25/docs/sitewide-content.md#footer)"
125
125
  },
126
126
  "buildInfo": {
127
127
  "default": false,
128
128
  "description": "Show a localized generated build timestamp in the footer.",
129
129
  "type": "boolean",
130
- "markdownDescription": "```yaml\nfooter:\n buildInfo: true\n```\n\nShow a localized generated build timestamp in the footer.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.24/docs/sitewide-content.md#footer)"
130
+ "markdownDescription": "```yaml\nfooter:\n buildInfo: true\n```\n\nShow a localized generated build timestamp in the footer.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.25/docs/sitewide-content.md#footer)"
131
131
  }
132
132
  },
133
133
  "additionalProperties": false,
134
- "markdownDescription": "```yaml\nfooter:\n copyrightMessage: Copyright Example Owner.\n```\n\nAdds shared footer content. Generated build information is optional.\n\n[Footer reference](https://github.com/janga/norna/blob/v0.7.24/docs/sitewide-content.md#footer)"
134
+ "markdownDescription": "```yaml\nfooter:\n copyrightMessage: Copyright Example Owner.\n```\n\nAdds shared footer content. Generated build information is optional.\n\n[Footer reference](https://github.com/janga/norna/blob/v0.7.25/docs/sitewide-content.md#footer)"
135
135
  }
136
136
  },
137
137
  "additionalProperties": false,
138
138
  "description": "Editorial content and optional navigation logo display settings shared by every page.",
139
139
  "$id": "https://janga.github.io/norna/schemas/sitewide-content.schema.json",
140
140
  "title": "Norna site-wide content",
141
- "markdownDescription": "```yaml\nfooter:\n copyrightMessage: Copyright Example Owner.\n```\n\n`sitewide-content.yaml` optionally defines banners, footer content, and logo display settings shared by every page.\n\n[Site-wide content reference](https://github.com/janga/norna/blob/v0.7.24/docs/sitewide-content.md)"
141
+ "markdownDescription": "```yaml\nfooter:\n copyrightMessage: Copyright Example Owner.\n```\n\n`sitewide-content.yaml` optionally defines banners, footer content, and logo display settings shared by every page.\n\n[Site-wide content reference](https://github.com/janga/norna/blob/v0.7.25/docs/sitewide-content.md)"
142
142
  }