@janga/norna 0.7.15 → 0.7.16

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 (5) hide show
  1. package/package.json +1 -1
  2. package/schemas/config.schema.json +4 -4
  3. package/schemas/content-frontmatter.schema.json +5 -5
  4. package/schemas/sitewide-content.schema.json +6 -6
  5. package/schemas/theme.schema.json +7 -7
package/package.json CHANGED
@@ -2,7 +2,7 @@
2
2
  "name": "@janga/norna",
3
3
  "description": "An opinionated CLI for building responsive websites from Markdown, images, and theme presets.",
4
4
  "type": "module",
5
- "version": "0.7.15",
5
+ "version": "0.7.16",
6
6
  "license": "GPL-3.0-only",
7
7
  "repository": {
8
8
  "type": "git",
package/schemas/config.schema.json CHANGED
@@ -6,7 +6,7 @@
6
6
  "type": "string",
7
7
  "format": "uri",
8
8
  "description": "Absolute public URL for the built site.",
9
- "markdownDescription": "```yaml\nurl: https://example.com/\n```\n\nThe absolute public URL. Its path also determines the base path for generated links and assets.\n\n[Public URL reference](https://github.com/janga/norna/blob/v0.7.15/docs/configuration.md#url)",
9
+ "markdownDescription": "```yaml\nurl: https://example.com/\n```\n\nThe absolute public URL. Its path also determines the base path for generated links and assets.\n\n[Public URL reference](https://github.com/janga/norna/blob/v0.7.16/docs/configuration.md#url)",
10
10
  "examples": [
11
11
  "https://example.com/",
12
12
  "https://owner.github.io/repository-name/"
@@ -41,7 +41,7 @@
41
41
  "description": "Use an English or Swedish regional language tag such as en-GB or sv-SE."
42
42
  }
43
43
  ],
44
- "markdownDescription": "```yaml\nlanguage: en-GB\n```\n\nSets the page language and selects Norna's built-in English or Swedish interface text. The default is `en`.\n\n[Language reference](https://github.com/janga/norna/blob/v0.7.15/docs/configuration.md#language)"
44
+ "markdownDescription": "```yaml\nlanguage: en-GB\n```\n\nSets the page language and selects Norna's built-in English or Swedish interface text. The default is `en`.\n\n[Language reference](https://github.com/janga/norna/blob/v0.7.16/docs/configuration.md#language)"
45
45
  },
46
46
  "scrollBehavior": {
47
47
  "default": "instant",
@@ -59,7 +59,7 @@
59
59
  "description": "Use the browser's native smooth scrolling for anchor navigation."
60
60
  }
61
61
  ],
62
- "markdownDescription": "```yaml\nscrollBehavior: smooth\n```\n\nControls same-page anchor movement. `instant` is the default; `smooth` uses the browser's native smooth scrolling.\n\n[Scroll behavior reference](https://github.com/janga/norna/blob/v0.7.15/docs/configuration.md#scrollbehavior)",
62
+ "markdownDescription": "```yaml\nscrollBehavior: smooth\n```\n\nControls same-page anchor movement. `instant` is the default; `smooth` uses the browser's native smooth scrolling.\n\n[Scroll behavior reference](https://github.com/janga/norna/blob/v0.7.16/docs/configuration.md#scrollbehavior)",
63
63
  "examples": [
64
64
  "instant",
65
65
  "smooth"
@@ -73,5 +73,5 @@
73
73
  "description": "Technical settings for one Norna site. Routes cannot provide technical configuration.",
74
74
  "$id": "https://janga.github.io/norna/schemas/config.schema.json",
75
75
  "title": "Norna site configuration",
76
- "markdownDescription": "```yaml\nurl: https://example.com/\n```\n\n`config.yaml` contains the few technical settings shared by the complete site.\n\n[Configuration reference](https://github.com/janga/norna/blob/v0.7.15/docs/configuration.md)"
76
+ "markdownDescription": "```yaml\nurl: https://example.com/\n```\n\n`config.yaml` contains the few technical settings shared by the complete site.\n\n[Configuration reference](https://github.com/janga/norna/blob/v0.7.16/docs/configuration.md)"
77
77
  }
package/schemas/content-frontmatter.schema.json CHANGED
@@ -5,7 +5,7 @@
5
5
  "title": {
6
6
  "type": "string",
7
7
  "description": "Page title used in metadata and route navigation.",
8
- "markdownDescription": "```yaml\ntitle: About\n```\n\nThe page title used in metadata and, by default, route navigation.\n\n[Page frontmatter reference](https://github.com/janga/norna/blob/v0.7.15/docs/content.md#page-frontmatter)",
8
+ "markdownDescription": "```yaml\ntitle: About\n```\n\nThe page title used in metadata and, by default, route navigation.\n\n[Page frontmatter reference](https://github.com/janga/norna/blob/v0.7.16/docs/content.md#page-frontmatter)",
9
9
  "examples": [
10
10
  "About"
11
11
  ]
@@ -13,7 +13,7 @@
13
13
  "description": {
14
14
  "type": "string",
15
15
  "description": "Page description used in metadata.",
16
- "markdownDescription": "```yaml\ndescription: About this project.\n```\n\nA concise page description used in metadata.\n\n[Page frontmatter reference](https://github.com/janga/norna/blob/v0.7.15/docs/content.md#page-frontmatter)",
16
+ "markdownDescription": "```yaml\ndescription: About this project.\n```\n\nA concise page description used in metadata.\n\n[Page frontmatter reference](https://github.com/janga/norna/blob/v0.7.16/docs/content.md#page-frontmatter)",
17
17
  "examples": [
18
18
  "About this project."
19
19
  ]
@@ -32,7 +32,7 @@
32
32
  }
33
33
  },
34
34
  "additionalProperties": false,
35
- "markdownDescription": "```yaml\nnavigation:\n include: true\n label: About us\n```\n\nControls whether a route appears in site navigation and optionally replaces its visible title there. Homepage navigation is section-based.\n\n[Route navigation reference](https://github.com/janga/norna/blob/v0.7.15/docs/routes.md#navigation)"
35
+ "markdownDescription": "```yaml\nnavigation:\n include: true\n label: About us\n```\n\nControls whether a route appears in site navigation and optionally replaces its visible title there. Homepage navigation is section-based.\n\n[Route navigation reference](https://github.com/janga/norna/blob/v0.7.16/docs/routes.md#navigation)"
36
36
  },
37
37
  "sections": {
38
38
  "default": {},
@@ -66,7 +66,7 @@
66
66
  "additionalProperties": false,
67
67
  "description": "Metadata keyed by the explicit Markdown section id. Markdown order remains authoritative."
68
68
  },
69
- "markdownDescription": "```yaml\nsections:\n announcement:\n visible:\n until: \"2026-12-01\"\n```\n\nAdds optional metadata keyed by explicit Markdown section id. Markdown headings remain the source of section content and order.\n\n[Section metadata reference](https://github.com/janga/norna/blob/v0.7.15/docs/content.md#section-metadata)"
69
+ "markdownDescription": "```yaml\nsections:\n announcement:\n visible:\n until: \"2026-12-01\"\n```\n\nAdds optional metadata keyed by explicit Markdown section id. Markdown headings remain the source of section content and order.\n\n[Section metadata reference](https://github.com/janga/norna/blob/v0.7.16/docs/content.md#section-metadata)"
70
70
  }
71
71
  },
72
72
  "required": [
@@ -77,5 +77,5 @@
77
77
  "description": "Frontmatter for a homepage or route content.md file.",
78
78
  "$id": "https://janga.github.io/norna/schemas/content-frontmatter.schema.json",
79
79
  "title": "Norna page frontmatter",
80
- "markdownDescription": "```yaml\n---\ntitle: About\ndescription: About this project.\n---\n```\n\nEvery homepage and route `content.md` starts with page metadata, followed by Markdown sections.\n\n[Page frontmatter reference](https://github.com/janga/norna/blob/v0.7.15/docs/content.md#page-frontmatter)"
80
+ "markdownDescription": "```yaml\n---\ntitle: About\ndescription: About this project.\n---\n```\n\nEvery homepage and route `content.md` starts with page metadata, followed by Markdown sections.\n\n[Page frontmatter reference](https://github.com/janga/norna/blob/v0.7.16/docs/content.md#page-frontmatter)"
81
81
  }
package/schemas/sitewide-content.schema.json CHANGED
@@ -10,7 +10,7 @@
10
10
  "description": "Accessible site label used for navigation text and logo alternative text.",
11
11
  "type": "string",
12
12
  "minLength": 1,
13
- "markdownDescription": "```yaml\nnavigation:\n label: Example Site\n```\n\n- Without a logo, this text is shown in the navigation.\n\n- With a logo, this text becomes the image alternative text.\n\n- When omitted, Norna uses the homepage title.\n\n[Navigation identity reference](https://github.com/janga/norna/blob/v0.7.15/docs/sitewide-content.md#navigation-identity)",
13
+ "markdownDescription": "```yaml\nnavigation:\n label: Example Site\n```\n\n- Without a logo, this text is shown in the navigation.\n\n- With a logo, this text becomes the image alternative text.\n\n- When omitted, Norna uses the homepage title.\n\n[Navigation identity reference](https://github.com/janga/norna/blob/v0.7.16/docs/sitewide-content.md#navigation-identity)",
14
14
  "examples": [
15
15
  "Example Site"
16
16
  ]
@@ -29,11 +29,11 @@
29
29
  }
30
30
  },
31
31
  "additionalProperties": false,
32
- "markdownDescription": "```yaml\nnavigation:\n label: Example Site\n logo:\n height: 2rem\n```\n\n`logo` optionally overrides the displayed height of the logo file that Norna discovers automatically. It does not enable or select the file.\n\n[Navigation logo filenames and placement](https://github.com/janga/norna/blob/v0.7.15/docs/public-files.md#navigation-logo)"
32
+ "markdownDescription": "```yaml\nnavigation:\n label: Example Site\n logo:\n height: 2rem\n```\n\n`logo` optionally overrides the displayed height of the logo file that Norna discovers automatically. It does not enable or select the file.\n\n[Navigation logo filenames and placement](https://github.com/janga/norna/blob/v0.7.16/docs/public-files.md#navigation-logo)"
33
33
  }
34
34
  },
35
35
  "additionalProperties": false,
36
- "markdownDescription": "```yaml\nnavigation:\n label: Example Site\n```\n\n`navigation` defines the identity shared by the homepage and every route. Routes cannot replace it.\n\n[Navigation identity reference](https://github.com/janga/norna/blob/v0.7.15/docs/sitewide-content.md#navigation-identity)"
36
+ "markdownDescription": "```yaml\nnavigation:\n label: Example Site\n```\n\n`navigation` defines the identity shared by the homepage and every route. Routes cannot replace it.\n\n[Navigation identity reference](https://github.com/janga/norna/blob/v0.7.16/docs/sitewide-content.md#navigation-identity)"
37
37
  },
38
38
  "banners": {
39
39
  "default": [],
@@ -95,7 +95,7 @@
95
95
  "additionalProperties": false,
96
96
  "description": "Dismissible, site-wide one-line notice."
97
97
  },
98
- "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.15/docs/sitewide-content.md#banners)"
98
+ "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.16/docs/sitewide-content.md#banners)"
99
99
  },
100
100
  "footer": {
101
101
  "description": "Site-wide footer content.",
@@ -204,12 +204,12 @@
204
204
  }
205
205
  },
206
206
  "additionalProperties": false,
207
- "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.15/docs/sitewide-content.md#footer)"
207
+ "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.16/docs/sitewide-content.md#footer)"
208
208
  }
209
209
  },
210
210
  "additionalProperties": false,
211
211
  "description": "Editorial content and identity shared by every page.",
212
212
  "$id": "https://janga.github.io/norna/schemas/sitewide-content.schema.json",
213
213
  "title": "Norna site-wide content",
214
- "markdownDescription": "```yaml\nnavigation:\n label: Example Site\n```\n\n`sitewide-content.yaml` optionally defines editorial content and identity shared by every page.\n\n[Site-wide content reference](https://github.com/janga/norna/blob/v0.7.15/docs/sitewide-content.md)"
214
+ "markdownDescription": "```yaml\nnavigation:\n label: Example Site\n```\n\n`sitewide-content.yaml` optionally defines editorial content and identity shared by every page.\n\n[Site-wide content reference](https://github.com/janga/norna/blob/v0.7.16/docs/sitewide-content.md)"
215
215
  }
package/schemas/theme.schema.json CHANGED
@@ -27,7 +27,7 @@
27
27
  "description": "For short, expressive sites, with larger typography, airy spacing, and stronger section emphasis."
28
28
  }
29
29
  ],
30
- "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.15/docs/theme.md#theme-presets)"
30
+ "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)"
31
31
  },
32
32
  "layout": {
33
33
  "type": "object",
@@ -278,7 +278,7 @@
278
278
  },
279
279
  "additionalProperties": false,
280
280
  "description": "Optional layout overrides applied after the preset.",
281
- "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.15/docs/theme.md#layout)"
281
+ "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)"
282
282
  },
283
283
  "images": {
284
284
  "type": "object",
@@ -355,7 +355,7 @@
355
355
  },
356
356
  "additionalProperties": false,
357
357
  "description": "Optional defaults for managed image presentation.",
358
- "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.15/docs/theme.md#image-sizing)"
358
+ "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)"
359
359
  },
360
360
  "typography": {
361
361
  "type": "object",
@@ -1128,7 +1128,7 @@
1128
1128
  },
1129
1129
  "additionalProperties": false,
1130
1130
  "description": "Typography profile, rhythm, font family, and focused overrides.",
1131
- "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.15/docs/typography.md#configuration-shape)"
1131
+ "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)"
1132
1132
  },
1133
1133
  "palette": {
1134
1134
  "type": "string",
@@ -1150,7 +1150,7 @@
1150
1150
  "description": "Warm off-white surfaces with dark text."
1151
1151
  }
1152
1152
  ],
1153
- "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.15/docs/theme.md#palette-and-section-surfaces)",
1153
+ "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)",
1154
1154
  "examples": [
1155
1155
  "dark",
1156
1156
  "light",
@@ -1183,7 +1183,7 @@
1183
1183
  }
1184
1184
  ]
1185
1185
  },
1186
- "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.15/docs/theme.md#palette-and-section-surfaces)",
1186
+ "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)",
1187
1187
  "examples": [
1188
1188
  [
1189
1189
  "base"
@@ -1204,5 +1204,5 @@
1204
1204
  "description": "Visual settings for a site or route. A route theme replaces the inherited visual theme; site identity remains site-wide.",
1205
1205
  "$id": "https://janga.github.io/norna/schemas/theme.schema.json",
1206
1206
  "title": "Norna visual theme",
1207
- "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.15/docs/theme.md)"
1207
+ "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)"
1208
1208
  }