@takazudo/zudo-doc 3.2.0 → 4.0.0

package/dist/theme-packs/hearth/fonts/OFL.txt

@@ -0,0 +1,95 @@
+Copyright 2020 The Fraunces Project Authors (https://github.com/undercasetype/Fraunces)
+Copyright 2014 The Nunito Project Authors (https://github.com/googlefonts/nunito)
+Copyright 2021 The Spline Sans Mono Project Authors (https://github.com/SorkinType/SplineSansMono)
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+https://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded, 
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/dist/theme-packs/hearth/meta.json

@@ -0,0 +1,38 @@
+{
+  "schemaVersion": 1,
+  "slug": "hearth",
+  "name": "Hearth",
+  "description": "Warm cream & brick-red fireside docs — Fraunces headings, amber code blocks, ember-glow dark mode.",
+  "mode": "light",
+  "version": "1.0.1",
+  "fonts": {
+    "sans": "Nunito",
+    "mono": "Spline Sans Mono",
+    "display": "Fraunces",
+    "loaded": ["Fraunces", "Nunito", "Spline Sans Mono"]
+  },
+  "preview": {
+    "light": {
+      "bg": "oklch(0.958 0.02 85)",
+      "fg": "oklch(0.255 0.028 40)",
+      "accent": "oklch(0.49 0.145 31)",
+      "syntax": {
+        "keyword": "oklch(0.48 0.148 30)",
+        "string": "oklch(0.47 0.1 135)",
+        "comment": "oklch(0.51 0.035 60)",
+        "callable": "oklch(0.45 0.092 245)"
+      }
+    },
+    "dark": {
+      "bg": "oklch(0.215 0.022 45)",
+      "fg": "oklch(0.915 0.02 80)",
+      "accent": "oklch(0.735 0.128 45)",
+      "syntax": {
+        "keyword": "oklch(0.745 0.138 40)",
+        "string": "oklch(0.785 0.1 130)",
+        "comment": "oklch(0.645 0.032 65)",
+        "callable": "oklch(0.765 0.075 235)"
+      }
+    }
+  }
+}

package/dist/theme-packs/hearth/pack.css

@@ -0,0 +1,385 @@
+/* ============================================================
+   Hearth — zudo-doc theme pack (ADR docs/adr/theme-packs.md)
+
+   Warm cream & brick-red fireside docs: Fraunces serif chrome over
+   a Nunito reading face and Spline Sans Mono code, toasted amber
+   code panels with a warm inset highlight, firelight radial
+   gradients on the page body. Light = a cream room in daylight;
+   dark = the same room after sundown, lit by embers — roasted
+   brown field, terracotta accents, honey syntax. Cozy is round:
+   soft 12px cards/code, 8px controls, warm brown-tinted shadows
+   (never neutral gray).
+
+   Every rule below is scoped under html[data-theme-pack="hearth"]
+   — this is what makes the runtime pack swap atomic (Decision 3)
+   and lets the validator prove a pack can never leak styles while
+   inactive (Decision 6.7). The @font-face blocks are the sole
+   exception (at-rules can't be selector-scoped).
+
+   Prototype-selector adaptations against the REAL DOM (tokens-dump
+   §6 + component sources), noted inline where they matter:
+   - `.sb-group a`       → `#desktop-sidebar a` (hover wash) +
+                           `a[data-nav-active]` (active pill)
+   - `.toc-active`       → `nav[data-zd-toc] a[aria-current="true"]`
+                           (toc/toc.tsx marks the active entry with
+                           aria-current, not a mock class)
+   - `.doc-pager`        → `.zd-content > nav[data-doc-pager]` (stable
+                           hook on the DocPager nav, kept anchored under
+                           the structural `.zd-content >` chain)
+   - `footer[data-footer]` → `footer[data-footer]` (stable hook on the
+                           sole <footer> inside .zd-sidebar-content-wrapper)
+   - `.hdr-search` / `.hdr-icon-btn` / `.sb-group > p` — prototype-mock
+     markup with no stable hook; their rounded/brick styling is NOT
+     ported.
+   - the theme-switcher flyout + glowing-coal launcher have stable hooks
+     now ([data-switcher-card] / [data-switcher-launcher]), but this pack
+     styles neither — intentionally NOT ported.
+   - the prototype's `--hearth-shadow` / `--hearth-line` helper
+     properties are not part of the token manifest, so their
+     light-dark() values are inlined at each use site below.
+   ============================================================ */
+
+/* ---- Fraunces — display serif for headings, logo, blockquote,
+        table heads. Weight-only variable files (400–700; the opsz
+        axis is dropped for payload — glyphs render at the soft
+        text-optical default, which suits the fireside brief), both
+        styles — the blockquote cushion wants a TRUE italic. Latin
+        subsets only (all three families): latin-ext was dropped to
+        meet the ~250KB payload budget — a stray latin-ext glyph
+        falls back to the stack's system face. ---- */
+
+@font-face {
+  font-family: "Fraunces";
+  font-style: normal;
+  font-weight: 400 700;
+  font-display: swap;
+  src: url("./fonts/Fraunces-latin.woff2") format("woff2");
+  unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA,
+    U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191,
+    U+2193, U+2212, U+2215, U+FEFF, U+FFFD;
+}
+
+@font-face {
+  font-family: "Fraunces";
+  font-style: italic;
+  font-weight: 400 700;
+  font-display: swap;
+  src: url("./fonts/Fraunces-italic-latin.woff2") format("woff2");
+  unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA,
+    U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191,
+    U+2193, U+2212, U+2215, U+FEFF, U+FFFD;
+}
+
+/* ---- Nunito — rounded humanist sans for prose. Variable 400–800
+        (bold prose emphasis and the 700 sidebar/nav weights come
+        from the same file). ---- */
+
+@font-face {
+  font-family: "Nunito";
+  font-style: normal;
+  font-weight: 400 800;
+  font-display: swap;
+  src: url("./fonts/Nunito-latin.woff2") format("woff2");
+  unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA,
+    U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191,
+    U+2193, U+2212, U+2215, U+FEFF, U+FFFD;
+}
+
+/* ---- Spline Sans Mono — soft mono for the amber code panels.
+        Variable 400–600. ---- */
+
+@font-face {
+  font-family: "Spline Sans Mono";
+  font-style: normal;
+  font-weight: 400 600;
+  font-display: swap;
+  src: url("./fonts/SplineSansMono-latin.woff2") format("woff2");
+  unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA,
+    U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191,
+    U+2193, U+2212, U+2215, U+FEFF, U+FFFD;
+}
+
+html[data-theme-pack="hearth"] {
+  /* Tier-2 semantic roles — warm cream room / ember-lit brown room.
+     Both modes always via light-dark(). */
+  --zd-bg: light-dark(oklch(0.958 0.02 85), oklch(0.215 0.022 45));
+  --zd-fg: light-dark(oklch(0.255 0.028 40), oklch(0.915 0.02 80));
+  --zd-selection-bg: light-dark(oklch(0.845 0.085 75), oklch(0.455 0.09 45));
+  --zd-selection-fg: light-dark(oklch(0.225 0.03 40), oklch(0.965 0.015 85));
+  --zd-surface: light-dark(oklch(0.938 0.026 82), oklch(0.245 0.024 45));
+  --zd-muted: light-dark(oklch(0.45 0.042 50), oklch(0.725 0.032 60));
+  --zd-accent: light-dark(oklch(0.49 0.145 31), oklch(0.735 0.128 45));
+  --zd-accent-hover: light-dark(oklch(0.42 0.132 30), oklch(0.795 0.112 50));
+  --zd-code-bg: light-dark(oklch(0.928 0.048 84), oklch(0.268 0.038 55));
+  --zd-code-fg: light-dark(oklch(0.29 0.048 45), oklch(0.908 0.028 80));
+  --zd-success: light-dark(oklch(0.455 0.1 140), oklch(0.765 0.105 135));
+  --zd-danger: light-dark(oklch(0.5 0.17 28), oklch(0.705 0.15 30));
+  --zd-warning: light-dark(oklch(0.51 0.105 72), oklch(0.805 0.115 78));
+  --zd-info: light-dark(oklch(0.465 0.085 240), oklch(0.745 0.08 235));
+
+  /* syntax — all 9 roles, both modes: brick keywords, olive strings,
+     burnt-orange numbers, dusk-blue callables, honey types — embers
+     brighten after dark. The light comment ink runs one step darker
+     than the prototype (L .52 → .51) to clear WCAG AA (4.69:1) on
+     the amber code panel. inserted/deleted reuse the success/danger
+     hues. */
+  --zd-syntax-comment: light-dark(oklch(0.51 0.035 60), oklch(0.645 0.032 65));
+  --zd-syntax-string: light-dark(oklch(0.47 0.1 135), oklch(0.785 0.1 130));
+  --zd-syntax-number: light-dark(oklch(0.505 0.122 55), oklch(0.815 0.118 70));
+  --zd-syntax-keyword: light-dark(oklch(0.48 0.148 30), oklch(0.745 0.138 40));
+  --zd-syntax-callable: light-dark(oklch(0.45 0.092 245), oklch(0.765 0.075 235));
+  --zd-syntax-type: light-dark(oklch(0.498 0.098 76), oklch(0.82 0.1 86));
+  --zd-syntax-name: light-dark(oklch(0.29 0.048 45), oklch(0.908 0.028 80));
+  --zd-syntax-inserted: light-dark(oklch(0.455 0.1 140), oklch(0.765 0.105 135));
+  --zd-syntax-deleted: light-dark(oklch(0.5 0.17 28), oklch(0.705 0.15 30));
+
+  /* fonts — Nunito reading face, Spline Sans Mono code, Fraunces
+     display face for headings/serif chrome. */
+  --font-sans: "Nunito", system-ui, sans-serif;
+  --font-mono: "Spline Sans Mono", ui-monospace, monospace;
+  --font-display: "Fraunces", Georgia, serif;
+
+  /* Tier-3 component seams — Fraunces headings (the 570 h2 weight
+     rides the variable wght axis), soft 12px cards, brick-fill
+     active nav. */
+  --zdc-doc-title-font: var(--font-display);
+  --zdc-doc-title-weight: 600;
+  --zdc-doc-title-tracking: -0.015em;
+  --zdc-doc-h2-font: var(--font-display);
+  --zdc-doc-h2-weight: 570;
+  --zdc-doc-h2-tracking: -0.005em;
+  --zdc-admonition-radius: 0 12px 12px 0;
+  --zdc-card-radius: 12px;
+  --zdc-nav-active-indicator-color: light-dark(oklch(0.49 0.145 31), oklch(0.74 0.125 45));
+}
+
+/* ---- Hearth extras ---- */
+
+/* firelight in the room: daylight glow from above (light), ember
+   glow rising from below-right (dark) */
+html[data-theme-pack="hearth"] body {
+  background-image:
+    radial-gradient(
+      120% 65% at 50% 0%,
+      light-dark(oklch(0.972 0.022 90 / 0.9), oklch(0.245 0.03 45 / 0.55)) 0%,
+      transparent 60%
+    ),
+    radial-gradient(
+      90% 55% at 88% 100%,
+      light-dark(oklch(0.925 0.055 78 / 0.55), oklch(0.3 0.062 42 / 0.5)) 0%,
+      transparent 55%
+    );
+  background-attachment: fixed;
+}
+
+/* header: warm mantelpiece — soft gradient, warm hairline, brown
+   shadow */
+html[data-theme-pack="hearth"] header[data-header] {
+  border-bottom-color: light-dark(oklch(0.85 0.042 76), oklch(0.335 0.034 48));
+  box-shadow: 0 3px 14px -8px light-dark(oklch(0.42 0.09 45 / 0.2), oklch(0.05 0.01 45 / 0.6));
+  background-image: linear-gradient(
+    180deg,
+    light-dark(oklch(0.945 0.028 84), oklch(0.252 0.026 45)) 0%,
+    light-dark(oklch(0.93 0.028 80), oklch(0.238 0.023 45)) 100%
+  );
+}
+html[data-theme-pack="hearth"] [data-header-logo] {
+  font-family: var(--font-display);
+  font-weight: 620;
+  color: var(--zd-accent);
+}
+html[data-theme-pack="hearth"] [data-nav-item]:hover {
+  color: var(--zd-accent);
+  text-decoration-color: color-mix(in oklch, var(--zd-accent) 50%, transparent);
+  text-underline-offset: 4px;
+}
+
+/* sidebar: a shade warmer than the page; rounded hover cushions */
+html[data-theme-pack="hearth"] #desktop-sidebar {
+  background-color: light-dark(oklch(0.944 0.024 82), oklch(0.202 0.02 45));
+  border-right-color: light-dark(oklch(0.85 0.042 76), oklch(0.335 0.034 48));
+}
+html[data-theme-pack="hearth"] #desktop-sidebar a {
+  border-radius: 8px;
+  transition:
+    background-color 0.15s ease,
+    color 0.15s ease;
+}
+html[data-theme-pack="hearth"] #desktop-sidebar a:hover {
+  color: var(--zd-accent);
+  text-decoration: none;
+  background: light-dark(oklch(0.905 0.038 80 / 0.7), oklch(0.268 0.032 48 / 0.75));
+}
+/* active item: brick pill (fill from --zdc-nav-active-indicator-color)
+   lifted by a warm shadow; cream/dark-roast text via the bg token */
+html[data-theme-pack="hearth"] a[data-nav-active] {
+  color: var(--zd-bg);
+  border-radius: 8px;
+  box-shadow: 0 3px 10px -4px light-dark(oklch(0.42 0.09 45 / 0.2), oklch(0.05 0.01 45 / 0.6));
+}
+
+/* headings: brick serif, ember rule under h2. The SSR-inlined
+   `style="border-image:linear-gradient(...)"` bar is defeated with
+   border-image none !important (Decision 6.6's sole allowlisted
+   carve-out) + a zeroed border-top; the fading ember rule is then
+   painted as a 3px top-anchored background gradient instead. */
+html[data-theme-pack="hearth"] .zd-content h1 {
+  color: light-dark(oklch(0.435 0.135 30), oklch(0.79 0.112 48));
+}
+html[data-theme-pack="hearth"] .zd-content h2 {
+  border-image: none !important;
+  border-top-width: 0;
+  color: light-dark(oklch(0.43 0.12 32), oklch(0.8 0.1 55));
+  background-image: linear-gradient(
+    to right,
+    var(--zd-accent),
+    color-mix(in oklch, var(--zd-warning) 70%, transparent) 55%,
+    transparent
+  );
+  background-size: 100% 3px;
+  background-repeat: no-repeat;
+  background-position: top left;
+}
+html[data-theme-pack="hearth"] .zd-content h3 {
+  color: light-dark(oklch(0.36 0.07 40), oklch(0.85 0.055 65));
+}
+
+/* links: brick with a soft amber underline that warms on hover */
+html[data-theme-pack="hearth"] .zd-content a {
+  text-decoration-color: color-mix(in oklch, var(--zd-accent) 40%, transparent);
+  text-decoration-thickness: 1.5px;
+  text-underline-offset: 3px;
+}
+html[data-theme-pack="hearth"] .zd-content a:hover {
+  text-decoration-color: var(--zd-accent-hover);
+}
+
+/* amber code blocks — the centerpiece: toasted panel, warm inset
+   highlight, soft 12px corners, brown shadow underneath */
+html[data-theme-pack="hearth"] pre.hi-root {
+  border-radius: 12px;
+  border-color: light-dark(oklch(0.845 0.058 80), oklch(0.352 0.048 55));
+  background-image: linear-gradient(
+    180deg,
+    light-dark(oklch(0.936 0.05 86), oklch(0.282 0.04 56)) 0%,
+    light-dark(oklch(0.922 0.048 82), oklch(0.258 0.036 52)) 100%
+  );
+  box-shadow:
+    inset 0 1px 0 light-dark(oklch(1 0 0 / 0.55), oklch(1 0 0 / 0.05)),
+    0 10px 24px -16px light-dark(oklch(0.42 0.09 45 / 0.2), oklch(0.05 0.01 45 / 0.6));
+  padding: 1.1rem 1.25rem;
+}
+html[data-theme-pack="hearth"] .hi-com {
+  font-style: italic;
+}
+
+/* inline code: little amber pills */
+html[data-theme-pack="hearth"] .zd-content code:not(pre code) {
+  border-radius: 6px;
+  border: 1px solid light-dark(oklch(0.868 0.052 82), oklch(0.34 0.042 55));
+  padding: 1px 0.38rem;
+}
+
+/* blockquote: fireside aside — italic serif on a warm cushion */
+html[data-theme-pack="hearth"] .zd-content blockquote {
+  font-family: var(--font-display);
+  font-style: italic;
+  font-size: 1.06em;
+  border-left: 3px solid var(--zd-accent);
+  border-radius: 0 12px 12px 0;
+  background: light-dark(oklch(0.938 0.034 82 / 0.7), oklch(0.252 0.03 50 / 0.6));
+  padding: 0.85rem 1.2rem 0.85rem 1.25rem;
+  color: light-dark(oklch(0.38 0.052 42), oklch(0.83 0.032 70));
+}
+
+/* admonitions: soft-cornered, warm-shadowed, hearth icon swaps on
+   the prototype's three variants (candle / coffee / fire); the other
+   four variants keep the stock icons */
+html[data-theme-pack="hearth"] [data-admonition] {
+  box-shadow: 0 8px 18px -14px light-dark(oklch(0.42 0.09 45 / 0.2), oklch(0.05 0.01 45 / 0.6));
+}
+html[data-theme-pack="hearth"] [data-admonition="note"] .admonition-title::before {
+  content: "🕯️ ";
+}
+html[data-theme-pack="hearth"] [data-admonition="tip"] .admonition-title::before {
+  content: "☕ ";
+}
+html[data-theme-pack="hearth"] [data-admonition="warning"] .admonition-title::before {
+  content: "🔥 ";
+}
+
+/* table: brick Fraunces header over an accent rule, warm row hover */
+html[data-theme-pack="hearth"] .zd-content th {
+  font-family: var(--font-display);
+  font-weight: 600;
+  color: var(--zd-accent);
+  border-bottom-color: color-mix(in oklch, var(--zd-accent) 65%, transparent);
+}
+html[data-theme-pack="hearth"] .zd-content td {
+  border-bottom-color: light-dark(oklch(0.85 0.042 76), oklch(0.335 0.034 48));
+}
+html[data-theme-pack="hearth"] .zd-content tbody tr:hover {
+  background: light-dark(oklch(0.932 0.034 82 / 0.6), oklch(0.262 0.03 50 / 0.55));
+}
+
+/* hr: a fading ember line */
+html[data-theme-pack="hearth"] .zd-content hr {
+  border: none;
+  height: 2px;
+  border-radius: 2px;
+  background: linear-gradient(
+    to right,
+    transparent,
+    color-mix(in oklch, var(--zd-accent) 70%, transparent) 30%,
+    color-mix(in oklch, var(--zd-warning) 70%, transparent) 70%,
+    transparent
+  );
+}
+
+/* pager: cushioned cards that lift toward the fire. DocPager carries the
+   stable data-doc-pager hook. */
+html[data-theme-pack="hearth"] .zd-content > nav[data-doc-pager] a {
+  background: var(--zd-surface);
+  border-radius: 12px;
+  border-color: light-dark(oklch(0.85 0.042 76), oklch(0.335 0.034 48));
+  box-shadow: 0 5px 16px -12px light-dark(oklch(0.42 0.09 45 / 0.2), oklch(0.05 0.01 45 / 0.6));
+  transition:
+    box-shadow 0.18s ease,
+    border-color 0.18s ease,
+    transform 0.18s ease;
+}
+html[data-theme-pack="hearth"] .zd-content > nav[data-doc-pager] a:hover {
+  border-color: color-mix(in oklch, var(--zd-accent) 60%, transparent);
+  box-shadow: 0 12px 26px -14px light-dark(oklch(0.42 0.09 45 / 0.2), oklch(0.05 0.01 45 / 0.6));
+  transform: translateY(-1px);
+}
+
+/* TOC: brick pill for the active entry. The real DOM marks it with
+   aria-current="true" (toc/toc.tsx). The pill pulls left within the
+   ul's padding (the rail-side overflow clips at the padding edge —
+   see the foundry note), and reads cream-on-brick in daylight,
+   dark-roast-on-terracotta after sundown. */
+html[data-theme-pack="hearth"] nav[data-zd-toc] ul {
+  border-left-color: light-dark(oklch(0.85 0.042 76), oklch(0.335 0.034 48));
+}
+html[data-theme-pack="hearth"] nav[data-zd-toc] a:hover {
+  color: var(--zd-accent);
+}
+html[data-theme-pack="hearth"] nav[data-zd-toc] a[aria-current="true"] {
+  background: var(--zd-accent);
+  color: light-dark(oklch(0.968 0.016 85), oklch(0.19 0.02 45));
+  border-radius: 7px;
+  padding-left: 0.4rem;
+  margin-left: -0.4rem;
+  padding-right: 0.4rem;
+  box-shadow: 0 3px 10px -4px light-dark(oklch(0.42 0.09 45 / 0.2), oklch(0.05 0.01 45 / 0.6));
+}
+
+/* breadcrumb + footer warmth (footer carries the stable data-footer hook) */
+html[data-theme-pack="hearth"] main nav[aria-label="Breadcrumb"] a:hover {
+  color: var(--zd-accent);
+}
+html[data-theme-pack="hearth"] footer[data-footer] {
+  background-color: light-dark(oklch(0.936 0.026 80), oklch(0.196 0.02 45));
+  border-top-color: light-dark(oklch(0.85 0.042 76), oklch(0.335 0.034 48));
+}

package/dist/theme-packs/hollow/fonts/OFL.txt

@@ -0,0 +1,94 @@
+Copyright 2020 The Space Grotesk Project Authors (https://github.com/floriankarsten/space-grotesk)
+Copyright 2016 Google Inc. All Rights Reserved. Space Mono (https://github.com/googlefonts/spacemono)
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+https://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded, 
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/dist/theme-packs/hollow/meta.json

@@ -0,0 +1,37 @@
+{
+  "schemaVersion": 1,
+  "slug": "hollow",
+  "name": "Hollow",
+  "description": "Dark violet space — neon pink headings, violet links, a quiet starfield, and razor-square midnight chrome.",
+  "mode": "dark",
+  "version": "1.0.1",
+  "fonts": {
+    "sans": "Space Grotesk",
+    "mono": "Space Mono",
+    "loaded": ["Space Grotesk", "Space Mono"]
+  },
+  "preview": {
+    "light": {
+      "bg": "oklch(0.962 0.012 300)",
+      "fg": "oklch(0.24 0.045 295)",
+      "accent": "oklch(0.45 0.17 300)",
+      "syntax": {
+        "keyword": "oklch(0.53 0.2 348)",
+        "string": "oklch(0.45 0.1 195)",
+        "comment": "oklch(0.51 0.035 292)",
+        "callable": "oklch(0.46 0.16 300)"
+      }
+    },
+    "dark": {
+      "bg": "oklch(0.155 0.035 295)",
+      "fg": "oklch(0.93 0.015 295)",
+      "accent": "oklch(0.74 0.14 300)",
+      "syntax": {
+        "keyword": "oklch(0.76 0.17 347)",
+        "string": "oklch(0.83 0.1 190)",
+        "comment": "oklch(0.62 0.045 292)",
+        "callable": "oklch(0.76 0.13 300)"
+      }
+    }
+  }
+}