@krigsvold/theme 0.0.0-stage → 2.1.0

package/dist/tokens.json

@@ -0,0 +1,566 @@
+{
+  "name": "Krigsvold",
+  "version": "2.1.0",
+  "heritage": {
+    "navy950": "#061325",
+    "navy900": "#0A1D35",
+    "navy800": "#123456",
+    "blue600": "#286A9D",
+    "ice400": "#9ED5E6",
+    "ice200": "#D9EEF4",
+    "ice100": "#EEF8FA",
+    "paper": "#FBFAF7",
+    "ink": "#17202A",
+    "muted": "#56616C",
+    "rule": "#D9DEE2",
+    "gold": "#B58A3B"
+  },
+  "design": {
+    "radius": {
+      "sm": ".15rem",
+      "md": ".3rem",
+      "lg": ".4rem",
+      "control": ".15rem",
+      "card": "0"
+    },
+    "spacing": {
+      "1": ".25rem",
+      "2": ".5rem",
+      "3": ".75rem",
+      "4": "1rem",
+      "6": "1.5rem",
+      "8": "2rem",
+      "12": "3rem",
+      "16": "4rem",
+      "24": "6rem"
+    },
+    "fonts": {
+      "serif": "'Roboto Slab', Georgia, serif",
+      "sans": "'Roboto', Arial, sans-serif",
+      "display": "'Roboto Slab', Georgia, serif",
+      "mono": "'Roboto Mono', ui-monospace, SFMono-Regular, Menlo, Consolas, monospace",
+      "ui": "'Roboto', Arial, sans-serif",
+      "code": "'Roboto Mono', ui-monospace, SFMono-Regular, Menlo, Consolas, monospace"
+    },
+    "widths": {
+      "reading-width": "760px",
+      "content-width": "1320px",
+      "archive-width": "1320px"
+    },
+    "shadows": {
+      "shadow-sm": "0 10px 35px rgb(0 0 0 / 12%)",
+      "shadow-md": "0 18px 44px rgb(6 19 37 / 18%)",
+      "shadow-lg": "0 24px 65px rgb(10 29 53 / 12%)"
+    },
+    "motion": {
+      "transition": ".15s ease-in",
+      "reduced": "0s"
+    },
+    "breakpoints": {
+      "sm": "576px",
+      "md": "768px",
+      "lg": "992px",
+      "xl": "1200px",
+      "xxl": "1400px"
+    }
+  },
+  "foundation": {
+    "origin": "https://krigsvold.org/",
+    "sourceRepository": "basuhoward/krigsvold.org",
+    "sourceCommit": "e92e989b6e850b3a9cd8fbb565edb7eba6d3a6f7",
+    "sourceFiles": [
+      "assets/css/krigsvold.css",
+      "_includes/head.html",
+      "assets/css/material-kit.css",
+      "assets/scss/material-kit/bootstrap/_variables.scss"
+    ],
+    "tokens": {
+      "color-navy-950": "#061325",
+      "color-navy-900": "#0a1d35",
+      "color-navy-800": "#123456",
+      "color-blue-600": "#286a9d",
+      "color-ice-400": "#9ed5e6",
+      "color-ice-200": "#d9eef4",
+      "color-ice-100": "#eef8fa",
+      "color-paper": "#fbfaf7",
+      "color-ink": "#17202a",
+      "color-muted": "#56616c",
+      "color-rule": "#d9dee2",
+      "color-gold": "#b58a3b",
+      "font-serif": "'Roboto Slab', Georgia, serif",
+      "font-display": "'Roboto Slab', Georgia, serif",
+      "font-sans": "'Roboto', Arial, sans-serif",
+      "font-mono": "'Roboto Mono', ui-monospace, SFMono-Regular, Menlo, Consolas, monospace",
+      "space-1": ".25rem",
+      "space-2": ".5rem",
+      "space-3": ".75rem",
+      "space-4": "1rem",
+      "space-6": "1.5rem",
+      "space-8": "2rem",
+      "space-12": "3rem",
+      "space-16": "4rem",
+      "space-24": "6rem",
+      "reading-width": "760px",
+      "content-width": "1320px",
+      "archive-width": "1320px",
+      "radius-sm": ".15rem",
+      "radius-md": ".3rem",
+      "radius-lg": ".4rem",
+      "radius-control": ".15rem",
+      "radius-card": "0",
+      "shadow-sm": "0 10px 35px rgb(0 0 0 / 12%)",
+      "shadow-md": "0 18px 44px rgb(6 19 37 / 18%)",
+      "shadow-lg": "0 24px 65px rgb(10 29 53 / 12%)",
+      "shadow-card": "none",
+      "transition-ui": ".15s ease-in",
+      "motion-duration": ".15s",
+      "text-body": "1.06rem",
+      "text-h1": "clamp(2.8rem, 6vw, 5.5rem)",
+      "text-h2": "2.1rem",
+      "text-h3": "1.42rem",
+      "text-display": "clamp(3.4rem, 7vw, 6.8rem)",
+      "text-section": "clamp(2rem, 4vw, 3.5rem)",
+      "leading-body": "1.65",
+      "leading-heading": "1.13",
+      "leading-display": ".98",
+      "weight-heading": "700",
+      "tracking-heading": "-.025em",
+      "tracking-display": "-.045em",
+      "tracking-label": ".16em",
+      "tracking-button": ".035em",
+      "border-width": "1px",
+      "focus-width": "3px",
+      "focus-gap": "3px",
+      "gutter": ".75rem",
+      "section-space": "clamp(4.5rem, 8vw, 7.5rem)",
+      "control-height": "2.75rem",
+      "control-padding": ".9rem",
+      "button-padding": ".625rem 1.5rem",
+      "text-button": ".75rem",
+      "leading-button": "1.667",
+      "divider-width": "3rem",
+      "divider-thickness": "3px",
+      "link-underline-offset": ".18em",
+      "hero-overlay": "linear-gradient(90deg, rgba(3,15,30,.93) 0%, rgba(6,27,51,.76) 52%, rgba(7,28,48,.42) 100%)",
+      "breakpoint-sm": "576px",
+      "breakpoint-md": "768px",
+      "breakpoint-lg": "992px",
+      "breakpoint-xl": "1200px",
+      "breakpoint-xxl": "1400px",
+      "layout-gap": "2rem",
+      "layout-gap-small": "1rem",
+      "layout-gap-large": "3rem",
+      "layout-sidebar-width": "20rem",
+      "layout-main-min": "30rem",
+      "layout-grid-min": "20rem",
+      "layout-split-min": "22rem",
+      "layout-section-space": "clamp(4.5rem, 8vw, 7.5rem)"
+    },
+    "typographyRoles": {
+      "serif": {
+        "family": "Roboto Slab",
+        "usage": "Editorial headings, ledes, quotations",
+        "weights": [
+          400,
+          700
+        ]
+      },
+      "display": {
+        "family": "Roboto Slab",
+        "usage": "Hero and page titles, section headings",
+        "weights": [
+          400,
+          700
+        ]
+      },
+      "sans": {
+        "family": "Roboto",
+        "usage": "Body prose, navigation, controls, tables, metadata",
+        "weights": [
+          400,
+          500,
+          700
+        ],
+        "styles": [
+          "normal",
+          "italic"
+        ]
+      },
+      "mono": {
+        "family": "Roboto Mono",
+        "usage": "Code, terminal text, keyboard notation",
+        "weights": [
+          400,
+          500,
+          700
+        ],
+        "styles": [
+          "normal",
+          "italic"
+        ],
+        "provenance": "New redistributable companion selected for the Roboto family"
+      }
+    },
+    "normalization": {
+      "spacing": "Quarter-rem scale organizing the source site’s recurring spacing; values are not taken from the theme demo.",
+      "focus": "Explicit 3px visible focus ring and offset added for reusable controls.",
+      "controlHeight": "44px minimum interaction target added to the generic primitives.",
+      "readingWidth": "760px text measure from source hero/subtitle limits, generalized to reading containers.",
+      "card": "Flat editorial card from .work-card, with a 3px top rule; larger feature shadows remain separately available.",
+      "motion": "Source Material Kit .15s ease-in transition, reduced to zero when requested."
+    }
+  },
+  "capabilities": {
+    "web-core": {
+      "applied": [
+        "colors",
+        "typography variables",
+        "spacing",
+        "shape",
+        "depth",
+        "interaction variables",
+        "layout primitives"
+      ],
+      "optional": [
+        "font loading",
+        "element typography",
+        "components"
+      ]
+    },
+    "astro": {
+      "applied": [
+        "web-core",
+        "document shell",
+        "container",
+        "section heading",
+        "card",
+        "button",
+        "page header",
+        "site header",
+        "site footer",
+        "article layout",
+        "landing layout",
+        "documentation layout"
+      ],
+      "hostOwned": [
+        "navigation",
+        "content",
+        "consent",
+        "analytics",
+        "personal identity"
+      ]
+    },
+    "vim": {
+      "applied": [
+        "colors",
+        "syntax"
+      ],
+      "separateConfiguration": [
+        "monospace font"
+      ],
+      "unsupported": [
+        "web layout",
+        "proportional typography"
+      ]
+    },
+    "emacs": {
+      "applied": [
+        "colors",
+        "syntax"
+      ],
+      "separateConfiguration": [
+        "font roles"
+      ],
+      "unsupported": [
+        "web layout"
+      ]
+    },
+    "terminal": {
+      "applied": [
+        "colors"
+      ],
+      "separateConfiguration": [
+        "monospace font"
+      ],
+      "unsupported": [
+        "web layout",
+        "serif",
+        "sans"
+      ]
+    },
+    "firefox": {
+      "applied": [
+        "browser chrome colors"
+      ],
+      "unsupported": [
+        "fonts",
+        "website content",
+        "spacing",
+        "components"
+      ]
+    },
+    "chrome": {
+      "applied": [
+        "browser chrome colors"
+      ],
+      "unsupported": [
+        "fonts",
+        "website content",
+        "spacing",
+        "components"
+      ]
+    }
+  },
+  "layout": {
+    "schemaVersion": 1,
+    "primitives": [
+      "container",
+      "stack",
+      "cluster",
+      "grid",
+      "sidebar",
+      "split"
+    ],
+    "compositions": [
+      "article",
+      "landing",
+      "documentation"
+    ],
+    "defaults": {
+      "space": "regular",
+      "columns": 3,
+      "splitRatio": "equal",
+      "sidebarSide": "end"
+    },
+    "tokens": {
+      "layout-gap": "2rem",
+      "layout-gap-small": "1rem",
+      "layout-gap-large": "3rem",
+      "layout-sidebar-width": "20rem",
+      "layout-main-min": "30rem",
+      "layout-grid-min": "20rem",
+      "layout-split-min": "22rem",
+      "layout-section-space": "clamp(4.5rem, 8vw, 7.5rem)"
+    },
+    "sources": [
+      {
+        "url": "https://krigsvold.org/",
+        "repository": "basuhoward/krigsvold.org",
+        "commit": "a3cf072c516c59ed35814e0fa153028cc91ceecd",
+        "files": [
+          "src/layouts/Page.astro",
+          "src/components/HomeContent.astro",
+          "src/components/HomeHero.astro",
+          "src/styles/site.css"
+        ]
+      },
+      {
+        "url": "https://krigsvoldtheme.dev/",
+        "repository": "krigsvoldtheme/krigsvoldtheme",
+        "commit": "880bdd2bd8430bbdfd8d728faaae0c21199540b1",
+        "files": [
+          "site/src/pages/index.astro",
+          "site/src/styles/global.css",
+          "site/src/components/FoundationSpecimen.astro"
+        ]
+      }
+    ],
+    "normalization": {
+      "intrinsicSizing": "Columns and sidebars respond to their available container width, including nested containers, rather than only to viewport breakpoints.",
+      "readingOrder": "Sidebar side selects matching DOM order; split content retains its source order at all widths.",
+      "scope": "Namespaced optional layout classes; no global reset, framework dependency, image, personal identity, or scripts."
+    }
+  },
+  "themes": {
+    "light": {
+      "id": "krigsvold-light",
+      "name": "Krigsvold Light",
+      "mode": "light",
+      "tokens": {
+        "bg": "#FBFAF7",
+        "panel": "#EEF8FA",
+        "panel2": "#D9EEF4",
+        "text": "#17202A",
+        "muted": "#56616C",
+        "accent": "#286A9D",
+        "accent2": "#79571F",
+        "on-accent": "#FFFFFF",
+        "accent-hover": "#1E557F",
+        "line": "#D9DEE2",
+        "control-line": "#75828D",
+        "focus": "#286A9D",
+        "selection": "#C6E2EC",
+        "selection-text": "#17202A",
+        "green": "#35644E",
+        "danger": "#9A3542",
+        "warning": "#79571F",
+        "error-bg": "#F5E6E6",
+        "error-text": "#9A3542",
+        "shadow": "0 10px 40px #0613251A",
+        "surface-canvas": "#FBFAF7",
+        "surface-subtle": "#FEFEFC",
+        "surface-sunken": "#E4EDF0",
+        "surface-overlay": "#FFFFFF",
+        "text-strong": "#061325",
+        "text-subtle": "#56616C",
+        "text-disabled": "#62717B",
+        "text-inverse": "#FFFFFF",
+        "link": "#286A9D",
+        "link-hover": "#123456",
+        "link-visited": "#655477",
+        "border-subtle": "#D9DEE2",
+        "border-strong": "#75828D",
+        "input-bg": "#FFFFFF",
+        "input-text": "#17202A",
+        "input-placeholder": "#62717B",
+        "input-border": "#75828D",
+        "button-secondary-bg": "#D9EEF4",
+        "button-secondary-text": "#17202A",
+        "button-secondary-hover": "#C6E2EC",
+        "disabled-bg": "#E4EDF0",
+        "disabled-text": "#62717B",
+        "focus-ring": "#286A9D",
+        "focus-offset": "#FBFAF7",
+        "hover-bg": "#EEF8FA",
+        "active-bg": "#D9EEF4",
+        "code-bg": "#EEF8FA",
+        "code-text": "#17202A",
+        "quote-border": "#286A9D",
+        "table-stripe": "#EEF8FA",
+        "scrollbar-track": "#EEF8FA",
+        "scrollbar-thumb": "#75828D",
+        "overlay-scrim": "#061325AA",
+        "info": "#286A9D",
+        "info-bg": "#E3F1F5",
+        "info-text": "#123456",
+        "success": "#35644E",
+        "success-bg": "#E7F1E9",
+        "success-text": "#285039",
+        "warning-bg": "#F5ECD9",
+        "warning-text": "#79571F",
+        "danger-bg": "#F5E6E6",
+        "danger-text": "#9A3542",
+        "chart-1": "#286A9D",
+        "chart-2": "#35644E",
+        "chart-3": "#79571F",
+        "chart-4": "#9A3542",
+        "chart-5": "#655477",
+        "chart-6": "#187178",
+        "chart-7": "#985238",
+        "chart-8": "#56616C",
+        "chart-grid": "#D9DEE2",
+        "chart-axis": "#56616C",
+        "syntax-keyword": "#286A9D",
+        "syntax-string": "#35644E",
+        "syntax-function": "#123456",
+        "syntax-type": "#79571F",
+        "syntax-variable": "#17202A",
+        "syntax-comment": "#56616C",
+        "syntax-number": "#9A3542",
+        "syntax-operator": "#56616C",
+        "syntax-constant": "#655477",
+        "syntax-tag": "#286A9D",
+        "syntax-attribute": "#79571F",
+        "syntax-regexp": "#35644E",
+        "syntax-invalid": "#9A3542",
+        "syntax-property": "#123456",
+        "syntax-decorator": "#655477"
+      }
+    },
+    "dark": {
+      "id": "krigsvold-dark",
+      "name": "Krigsvold Dark",
+      "mode": "dark",
+      "tokens": {
+        "bg": "#061325",
+        "panel": "#0A1D35",
+        "panel2": "#123456",
+        "text": "#EEF8FA",
+        "muted": "#B3CCD5",
+        "accent": "#9ED5E6",
+        "accent2": "#D9B876",
+        "on-accent": "#061325",
+        "accent-hover": "#D9EEF4",
+        "line": "#345066",
+        "control-line": "#7A929F",
+        "focus": "#9ED5E6",
+        "selection": "#244C61",
+        "selection-text": "#EEF8FA",
+        "green": "#A6CFB5",
+        "danger": "#F0A4AF",
+        "warning": "#E0BF84",
+        "error-bg": "#302335",
+        "error-text": "#F0A4AF",
+        "shadow": "0 10px 40px #00000055",
+        "surface-canvas": "#061325",
+        "surface-subtle": "#07182B",
+        "surface-sunken": "#040E1C",
+        "surface-overlay": "#123456",
+        "text-strong": "#FBFAF7",
+        "text-subtle": "#B3CCD5",
+        "text-disabled": "#8BA4B2",
+        "text-inverse": "#061325",
+        "link": "#9ED5E6",
+        "link-hover": "#D9EEF4",
+        "link-visited": "#C6B6DB",
+        "border-subtle": "#345066",
+        "border-strong": "#7A929F",
+        "input-bg": "#0A1D35",
+        "input-text": "#EEF8FA",
+        "input-placeholder": "#B3CCD5",
+        "input-border": "#7A929F",
+        "button-secondary-bg": "#123456",
+        "button-secondary-text": "#EEF8FA",
+        "button-secondary-hover": "#1C4565",
+        "disabled-bg": "#183044",
+        "disabled-text": "#8BA4B2",
+        "focus-ring": "#9ED5E6",
+        "focus-offset": "#061325",
+        "hover-bg": "#123456",
+        "active-bg": "#1C4565",
+        "code-bg": "#0A1D35",
+        "code-text": "#EEF8FA",
+        "quote-border": "#9ED5E6",
+        "table-stripe": "#0A1D35",
+        "scrollbar-track": "#0A1D35",
+        "scrollbar-thumb": "#607B8D",
+        "overlay-scrim": "#061325CC",
+        "info": "#9ED5E6",
+        "info-bg": "#103549",
+        "info-text": "#D9EEF4",
+        "success": "#A6CFB5",
+        "success-bg": "#16362B",
+        "success-text": "#B7DDC3",
+        "warning-bg": "#3B301F",
+        "warning-text": "#E8CB97",
+        "danger-bg": "#3D2330",
+        "danger-text": "#F4B4BC",
+        "chart-1": "#9ED5E6",
+        "chart-2": "#D9B876",
+        "chart-3": "#A6CFB5",
+        "chart-4": "#F0A4AF",
+        "chart-5": "#C6B6DB",
+        "chart-6": "#8FCBC7",
+        "chart-7": "#E1AC90",
+        "chart-8": "#D4D8D9",
+        "chart-grid": "#345066",
+        "chart-axis": "#B3CCD5",
+        "syntax-keyword": "#9ED5E6",
+        "syntax-string": "#A6CFB5",
+        "syntax-function": "#C2E4EF",
+        "syntax-type": "#D9B876",
+        "syntax-variable": "#EEF8FA",
+        "syntax-comment": "#B3CCD5",
+        "syntax-number": "#F0A4AF",
+        "syntax-operator": "#B3CCD5",
+        "syntax-constant": "#C6B6DB",
+        "syntax-tag": "#9ED5E6",
+        "syntax-attribute": "#D9B876",
+        "syntax-regexp": "#A6CFB5",
+        "syntax-invalid": "#F0A4AF",
+        "syntax-property": "#C2E4EF",
+        "syntax-decorator": "#C6B6DB"
+      }
+    }
+  }
+}

package/dist/typography.css

@@ -0,0 +1,9 @@
+/* Optional typography, independent of font loading. */
+:where(.krigsvold) { font-family: var(--krigsvold-font-sans); font-size: var(--krigsvold-text-body); line-height: var(--krigsvold-leading-body); }
+:where(.krigsvold) :where(h1,h2,h3) { font-family: var(--krigsvold-font-serif); font-weight: var(--krigsvold-weight-heading); letter-spacing: var(--krigsvold-tracking-heading); line-height: var(--krigsvold-leading-heading); text-wrap: balance; }
+:where(.krigsvold) :where(h4,h5,h6) { font-family: var(--krigsvold-font-sans); font-weight: 700; line-height: var(--krigsvold-leading-heading); }
+:where(.krigsvold) h1 { font-size: var(--krigsvold-text-h1); }
+:where(.krigsvold) h2 { font-size: var(--krigsvold-text-h2); }
+:where(.krigsvold) h3 { font-size: var(--krigsvold-text-h3); }
+:where(.krigsvold) :where(nav,button,input,select,textarea,table,.krigsvold-ui) { font-family: var(--krigsvold-font-sans); }
+:where(.krigsvold) :where(code,pre,kbd,samp), :where(.krigsvold-code) { font-family: var(--krigsvold-font-mono); }

package/docs/layout.md

@@ -0,0 +1,20 @@
+# Krigsvold layout extraction
+
+Release candidate: core 2.1.0 and Astro 1.1.0. Existing color, font, and component contracts remain available.
+
+## Source observations
+
+- Originating site: [krigsvold.org](https://github.com/basuhoward/krigsvold.org/tree/a3cf072c516c59ed35814e0fa153028cc91ceecd). Inspected files: `src/layouts/Page.astro`, `src/components/HomeContent.astro`, `src/components/HomeHero.astro`, `src/styles/site.css`.
+- Demonstration site: [krigsvoldtheme.dev](https://github.com/krigsvoldtheme/krigsvoldtheme/tree/880bdd2bd8430bbdfd8d728faaae0c21199540b1). Inspected files: `site/src/pages/index.astro`, `site/src/styles/global.css`, `site/src/components/FoundationSpecimen.astro`.
+
+The originating site uses broad section bands, paired geography and feature regions, three-column work/metric groups, a main article plus fellowship facts, and image/copy listings. The demonstration site adds a full-width landscape opening, a single workbench, a paired contrast/token laboratory, and a three-card foundation specimen.
+
+## Reusable contract
+
+The core retains its original reading/content/archive widths. New layout variables normalize recurring gaps, a 20rem sidebar, a 30rem minimum main region, a 20rem card minimum, and a 22rem split-panel basis. These are documented defaults, not a claim that every source element used exactly the same values. Krigsvold's default split is `equal`.
+
+Use `@krigsvold/theme/layout.css` with foundation variables for structural classes; it loads no fonts or palette. `full.css` includes it. `layout.json` and the ESM/CommonJS `layout` export describe defaults and provenance. No existing source value is silently replaced.
+
+Intrinsic wrapping responds to the containing region. Grid `columns` is a maximum, not a promise to fit that many columns at every width. Sidebars use a separate main-content minimum; splits retain DOM order. There is no overflow-hiding workaround. Wide tables belong in a labelled `.krigsvold-scroll` region with `tabindex="0"` when keyboard scrolling is needed.
+
+The Astro package supplies wrappers, site chrome, and complete article, landing, and documentation compositions. Identity, route generation, content rendering, analytics, and consent remain host-owned. Header links wrap naturally; this release does not implement dropdown or disclosure-menu behavior.

package/docs/provenance.md

@@ -0,0 +1,27 @@
+# Krigsvold design extraction
+
+Origin: https://krigsvold.org/, repository basuhoward/krigsvold.org, commit e92e989b6e850b3a9cd8fbb565edb7eba6d3a6f7. references/krigsvold-origin.css records the source CSS. source.json is the canonical package input.
+
+| Design | Source | Package treatment |
+| --- | --- | --- |
+| Navy, ice, paper, ink, muted, rule, gold | krigsvold.css root variables | Exact foundation identity values; semantic Light/Dark colors preserved separately |
+| Roboto body and UI | body, navbar links, head font import | Sans role; local 400/500/700 normal and italic |
+| Roboto Slab display | home-hero h1, home-hero__title, page-masthead h1 | Separate display role, 700; original responsive scale, tracking, and line-height |
+| Roboto Slab editorial | editorial-content h2/h3, introduction and quotations | Serif role sharing display family; body remains sans |
+| Roboto Mono | Newly agreed public companion | Monospace code, terminal and keyboard notation |
+| Spacing | Recurring source quarter-rem values and 1.5rem/2rem gaps | Named quarter-rem scale organizing source values |
+| Content width | Material Kit Bootstrap container maximums | 1320px maximum; 760px text measure generalized from source hero/subtitle limits; fluid widths |
+| Corners | btn, site-search-input, dropdown and navbar | .15rem controls, .3rem dropdowns, .4rem larger corners; flat editorial cards |
+| Depth | Navbar, dropdown, fellow-feature container | Three separate source shadows; no shadow on flat work cards |
+| Borders | work-card, editorial tables, root rule color | 1px rules, 3px editorial accent rule |
+| Motion | Material Kit compiled btn, reduced-motion override | .15s ease-in, zero with reduced motion |
+| Interaction | Source buttons, hover states and skip link | Native semantics, semantic hover/disabled colors; explicit 3px focus ring and 44px minimum control target are accessibility additions |
+| Breakpoints | Material Kit Bootstrap SCSS | 576, 768, 992, 1200, 1400px in design JSON; primitives reflow without fixed page widths |
+
+These values come from assets/css/krigsvold.css, _includes/head.html, assets/css/material-kit.css and assets/scss/material-kit/bootstrap/_variables.scss. The package does not copy Material Kit or Bootstrap implementation code. Arms, content, navigation structure, analytics, consent and icons remain site responsibilities.
+
+Font licenses ship verbatim in dist/licenses/: Roboto Slab is Apache-2.0; Roboto and Roboto Mono are OFL-1.1 in the selected pinned packages.
+
+## Migration gate
+
+Publish and verify the core and Astro packages, deploy krigsvoldtheme.dev against the registry releases, then begin the originating site's migration. Preserve its content, routes, metadata, redirects, feeds and behavior as separate migration requirements.

package/docs/releasing.md

@@ -0,0 +1,27 @@
+# Automated npm releases
+
+GitHub Actions publishes stable GitHub releases through npm trusted publishing (OIDC), using `.github/workflows/publish.yml`. It requires no npm token secret.
+
+## One-time npm setup
+
+Open [package settings](https://www.npmjs.com/package/@krigsvold/theme/access), then Trusted publishing, Add trusted publisher, GitHub Actions. Enter these exact values:
+
+| Setting | Value |
+| --- | --- |
+| Organization/user | `krigsvoldtheme` |
+| Repository | `npm` |
+| Workflow filename | `publish.yml` |
+| Environment | Leave blank |
+| Allowed action | Enable direct `npm publish` |
+
+The workflow must be merged before use. New trusted publisher connections must complete their first publish within two days; otherwise recreate the connection. Existing package maintainers configure this on npm. No npm account settings are changed by this PR.
+
+## Release
+
+1. Merge reviewed version and changelog changes to `main`.
+2. Publish a stable GitHub release whose tag is exactly `v` plus `package.json`'s version.
+3. The workflow runs the full verification suite, checks tag/version/repository identity and ancestry in `main`, builds from a fresh install, and publishes to npm. Failed checks prevent publication.
+
+Release core 2.1.0 before Astro 1.1.0, then migrate the demonstration sites to registry versions. Prereleases do not publish through this stable-release workflow. Re-running a successful release fails rather than overwriting an existing npm version. Public repositories produce provenance attestations; private repositories publish with provenance disabled because npm does not support those attestations from private source repositories. Repository visibility is unchanged.
+
+Reference: https://docs.npmjs.com/trusted-publishers/