@janga/norna 0.7.18 → 0.7.23

package/docs/typography.md

@@ -1,168 +0,0 @@
-# Typography
-
-Norna typography is configured in `site/theme.yaml` through a site-wide font,
-profile, text rhythm, and optional overrides.
-
-The normal workflow is to select a complete top-level theme preset. It already
-chooses a coordinated font, typography profile, and rhythm:
-
-```yaml
-preset: documentation
-```
-
-Use the nested `typography` block only when those typographic choices need to
-differ from the selected theme preset. Typography is configured at root-theme
-or page-theme level, not in page or section content.
-
-## Typography Profiles
-
-Available profiles:
-
-- `restrained`: the default for image-led sites. Text is restrained and
-  supports the images without dominating the page.
-- `dense`: tighter typography for many sections, many images, or
-  short information blocks.
-- `reading`: more generous body text for pages where longer text carries
-  more of the experience.
-- `statement`: tighter, more declarative line-height for short programmatic
-  statements. Use it sparingly, usually as a page-level exception.
-
-If a complete top-level theme preset is selected, that preset supplies the
-typography choice. If both the top-level preset and nested typography are
-omitted, the engine default is `restrained`.
-
-Profiles define alignment, size, weight, and line height for `headings.h1`
-through `headings.h4`, `body`, and `caption`. They also choose a readable body
-text width. Built-in presets use `medium` as the default size for every text
-role. Visual heading hierarchy comes from the Markdown heading level, so `h1`
-is larger than `h2`, `h2` is larger than `h3`, and so on.
-
-The profiles use these controls deliberately:
-
-- `restrained` uses restrained heading weights and a normal reading width.
-- `dense` uses stronger headings and a wider text column for short,
-  scannable content.
-- `reading` uses a narrower reading width and more generous body line
-  height.
-- `statement` uses the strongest heading weights and a narrow text column for
-  short, declarative content.
-
-`rhythm` defines text-near spacing for headings, paragraphs, and captions.
-Available rhythms are `compact`, `normal`, and `airy`. Built-in rhythm values
-use `em` so spacing follows the rendered text size.
-
-Use this command to inspect the exact profile and rhythm values shipped with
-the installed engine:
-
-```sh
-norna typography profiles
-```
-
-Use this command to inspect the effective values for the selected site after
-profiles, rhythms, and overrides have been applied:
-
-```sh
-norna typography show
-```
-
-The output includes the site theme, every page, and every section. Each
-resolved value shows its `source`; values inherited by a page or section are
-also marked with `inherited: true`.
-
-## Configuration Shape
-
-```yaml
-typography:
-  fontFamily: "Arial, 'Helvetica Neue', Helvetica, sans-serif"
-  profile: restrained
-  rhythm: normal
-  overrides:
-    headings:
-      h2:
-        size: medium
-        weight: 600
-        spacingAfter: 0.55em
-      h3:
-        size: medium
-        spacingBefore: 1.5em
-        spacingAfter: 0.5em
-    body:
-      width: narrow
-      paragraphSpacing: 0.8em
-    caption:
-      spacingBefore: 0.5em
-```
-
-The typographic roles are:
-
-- `headings.h1`: reserved for page-level Markdown `#` headings if the content
-  model starts supporting them.
-- `headings.h2`: Markdown `##` section headings.
-- `headings.h3`: Markdown `###` subheadings inside section body text.
-- `headings.h4`: Markdown `####` subheadings inside section body text.
-- `body`: Markdown body text inside sections.
-- `caption`: image captions.
-
-Allowed alignment values are `left`, `center`, and `right`. Alignment can be
-responsive:
-
-```yaml
-align:
-  desktop: left
-  mobile: center
-```
-
-Allowed size values are `small`, `medium`, `large`, and `xlarge`. `medium` is
-the normal reading size. Use `small` for quieter supporting text, and use
-`large` or `xlarge` only when a page or section needs stronger emphasis.
-Each heading level uses its own scale but follows the same principle:
-`medium` is the normal size for that level. Norna may render the first section
-heading as an HTML `h1` for document structure, but its visual typography still
-follows the Markdown level the user wrote: `##` uses `headings.h2`.
-
-`lineHeight` is a unitless number from `1` through `3`. `spacingBefore`,
-`spacingAfter`, and `paragraphSpacing` are CSS lengths such as `0`, `0.8em`,
-`1rem`, or `12px`. Use `em` for spacing that should track the text size.
-
-`weight` is a controlled heading weight. Allowed values are `400`, `500`,
-`600`, and `700`. Configure readable line length with `layout.textWidth` in the
-root or page theme; it controls the prose column, not the page's maximum width
-or the width of image blocks.
-
-Supported override fields:
-
-- `headings.h1.align`, `headings.h1.size`, `headings.h1.weight`,
-  `headings.h1.lineHeight`,
-  `headings.h1.spacingBefore`, `headings.h1.spacingAfter`
-- `headings.h2.align`, `headings.h2.size`, `headings.h2.weight`,
-  `headings.h2.lineHeight`,
-  `headings.h2.spacingBefore`, `headings.h2.spacingAfter`
-- `headings.h3.align`, `headings.h3.size`, `headings.h3.weight`,
-  `headings.h3.lineHeight`,
-  `headings.h3.spacingBefore`, `headings.h3.spacingAfter`
-- `headings.h4.align`, `headings.h4.size`, `headings.h4.weight`,
-  `headings.h4.lineHeight`,
-  `headings.h4.spacingBefore`, `headings.h4.spacingAfter`
-- `body.align`, `body.size`, `body.lineHeight`,
-  `body.paragraphSpacing`
-- `caption.align`, `caption.size`, `caption.lineHeight`,
-  `caption.spacingBefore`
-
-## Page Text Width
-
-Typography itself remains site-wide so pages keep the same font, heading
-hierarchy, and typographic character. A page-local `theme.yaml` may adjust the
-body-text line length when a particular page or subtree needs a narrower or
-wider reading column:
-
-```yaml
-# site/pages/010-introduction/theme.yaml
-layout:
-  textWidth: narrow
-```
-
-The page setting is inherited by descendant pages. Page themes cannot select a
-typography profile, rhythm, font family, or heading override.
-
-Captions are normally centered, but `reading` uses left-aligned captions to
-support longer explanatory text.

package/examples/README.md

@@ -1,49 +0,0 @@
-# Norna Examples
-
-These examples are source projects, visual demonstrations, and integration
-checks. Every example is built by `npm run test:examples` and published by the
-documentation workflow.
-
-| Example | Purpose | Live demo | Source |
-| --- | --- | --- | --- |
-| Dog shelter, single page | A coherent homepage made from sections | [Open site](https://janga.github.io/norna/examples/complete-sites/dog-shelter-single-page/) | [View files](complete-sites/dog-shelter-single-page/) |
-| Dog shelter, multi-page | A coherent site with ordered pages and page-local images | [Open site](https://janga.github.io/norna/examples/complete-sites/dog-shelter-multi-page/) | [View files](complete-sites/dog-shelter-multi-page/) |
-| Portfolio preset | Complete `portfolio` preset without overrides | [Open site](https://janga.github.io/norna/examples/feature-demos/theme-preset-portfolio/) | [View files](feature-demos/theme-preset-portfolio/) |
-| Documentation preset | Complete `documentation` preset without overrides | [Open site](https://janga.github.io/norna/examples/feature-demos/theme-preset-documentation/) | [View files](feature-demos/theme-preset-documentation/) |
-| Project preset | Complete `project` preset without overrides | [Open site](https://janga.github.io/norna/examples/feature-demos/theme-preset-project/) | [View files](feature-demos/theme-preset-project/) |
-| Statement preset | Complete `statement` preset without overrides | [Open site](https://janga.github.io/norna/examples/feature-demos/theme-preset-statement/) | [View files](feature-demos/theme-preset-statement/) |
-| Media and surfaces | Image blocks, cards, notes, palettes, and section surfaces | [Open site](https://janga.github.io/norna/examples/feature-demos/media-and-surfaces/) | [View files](feature-demos/media-and-surfaces/) |
-| Sitewide content | Shared logo settings, banners, and footer content | [Open site](https://janga.github.io/norna/examples/feature-demos/sitewide-content/) | [View files](feature-demos/sitewide-content/) |
-
-## Directory Structure
-
-```text
-examples/
-|-- complete-sites/
-|   |-- dog-shelter-single-page/
-|   `-- dog-shelter-multi-page/
-`-- feature-demos/
-    |-- theme-preset-portfolio/
-    |-- theme-preset-documentation/
-    |-- theme-preset-project/
-    |-- theme-preset-statement/
-    |-- media-and-surfaces/
-    `-- sitewide-content/
-```
-
-`complete-sites/` contains small sites that can be read as coherent Norna
-projects. `feature-demos/` contains focused visual test benches. Feature demos
-are useful for documentation and integration checks, but are not starter
-templates.
-
-## Run An Example Locally
-
-From the Norna repository root, pass the example's `site/` directory:
-
-```sh
-node bin/norna.mjs --site-dir examples/feature-demos/media-and-surfaces/site dev:local
-```
-
-Use another path from the table to run a different example. The repository's
-GitHub Pages workflow publishes the same source projects under
-`https://janga.github.io/norna/examples/`.

package/examples/complete-sites/dog-shelter-multi-page/.astro/collections/site.schema.json

@@ -1,35 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "type": "object",
-  "properties": {
-    "page": {
-      "type": "object",
-      "properties": {
-        "description": {
-          "description": "Optional page-specific meta description.",
-          "type": "string",
-          "minLength": 1
-        }
-      },
-      "additionalProperties": false,
-      "description": "Optional metadata for this homepage or additional page. The Markdown H1 supplies the page title."
-    },
-    "navigation": {
-      "description": "Optional navigation metadata for this page.",
-      "type": "object",
-      "properties": {
-        "listed": {
-          "default": true,
-          "description": "List this page in site navigation. The page remains public when false.",
-          "type": "boolean"
-        }
-      },
-      "additionalProperties": false
-    },
-    "$schema": {
-      "type": "string"
-    }
-  },
-  "additionalProperties": false,
-  "description": "Frontmatter for a homepage or additional page content.md file."
-}

package/examples/complete-sites/dog-shelter-multi-page/.astro/collections/sitewide.schema.json

@@ -1,97 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "type": "object",
-  "properties": {
-    "logo": {
-      "type": "object",
-      "properties": {
-        "height": {
-          "description": "Displayed logo height. Width follows the intrinsic aspect ratio.",
-          "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,
-      "description": "Optional display settings for a convention-based navigation logo."
-    },
-    "banners": {
-      "default": [],
-      "description": "Site-wide dismissible notices.",
-      "type": "array",
-      "items": {
-        "type": "object",
-        "properties": {
-          "id": {
-            "type": "string",
-            "pattern": "^[a-z0-9-]+$",
-            "description": "Stable banner identifier used for dismissal state."
-          },
-          "tone": {
-            "default": "warning",
-            "description": "Semantic banner tone.",
-            "type": "string",
-            "enum": [
-              "warning"
-            ]
-          },
-          "visible": {
-            "description": "Optional date window for the banner.",
-            "type": "object",
-            "properties": {
-              "from": {
-                "description": "First date on which the content is visible.",
-                "type": "string",
-                "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
-              },
-              "until": {
-                "description": "First date on which the content is no longer visible.",
-                "type": "string",
-                "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
-              }
-            },
-            "additionalProperties": false
-          },
-          "title": {
-            "type": "string",
-            "minLength": 1,
-            "description": "Short banner heading."
-          },
-          "text": {
-            "type": "string",
-            "minLength": 1,
-            "description": "Concise banner message."
-          }
-        },
-        "required": [
-          "id",
-          "title",
-          "text"
-        ],
-        "additionalProperties": false,
-        "description": "Dismissible site-wide warning shown above page content for important temporary information."
-      }
-    },
-    "footer": {
-      "description": "Site-wide footer content.",
-      "type": "object",
-      "properties": {
-        "copyrightMessage": {
-          "description": "Copyright or ownership text shown in the site footer.",
-          "type": "string",
-          "minLength": 1
-        },
-        "buildInfo": {
-          "default": false,
-          "description": "Show a localized generated build timestamp in the footer.",
-          "type": "boolean"
-        }
-      },
-      "additionalProperties": false
-    },
-    "$schema": {
-      "type": "string"
-    }
-  },
-  "additionalProperties": false,
-  "description": "Editorial content and optional navigation logo display settings shared by every page."
-}