@takazudo/zudo-doc 3.2.0 → 4.0.0

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

@@ -0,0 +1,202 @@
+/* ============================================================
+   Foundry — reference zudo-doc theme pack (ADR docs/adr/theme-packs.md)
+
+   GitHub-neutral baseline: white paper, near-black ink, Primer-blue
+   links, quiet gray rules. Restraint, perfected. Self-hosted Inter
+   (variable, weights 400-700, latin + latin-ext), system mono stack.
+
+   Every rule below is scoped under html[data-theme-pack="foundry"] —
+   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 two @font-face blocks are the sole exception
+   (at-rules can't be selector-scoped).
+
+   Prototype-selector adaptation against the REAL DOM:
+   - `.doc-pager a`     → `.zd-content > nav[data-doc-pager] > a` (the
+                          DocPager nav carries a stable data-doc-pager
+                          hook, #2873; hover wash restored in #2880)
+   ============================================================ */
+
+@font-face {
+  font-family: "Inter";
+  font-style: normal;
+  font-weight: 400 700;
+  font-display: swap;
+  src: url("./fonts/Inter-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: "Inter";
+  font-style: normal;
+  font-weight: 400 700;
+  font-display: swap;
+  src: url("./fonts/Inter-latin-ext.woff2") format("woff2");
+  unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7,
+    U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F,
+    U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C0, U+2113, U+2C60-2C7F,
+    U+A720-A7FF;
+}
+
+html[data-theme-pack="foundry"] {
+  /* Tier-2 semantic roles — GitHub Primer palette, both modes always via
+     light-dark(). Radius decision: Primer's 6px — modest rounding. */
+  --zd-bg: light-dark(#ffffff, #0d1117);
+  --zd-fg: light-dark(#1f2328, #e6edf3);
+  --zd-selection-bg: light-dark(#b6d9ff, #1b4b91);
+  --zd-selection-fg: light-dark(#1f2328, #ffffff);
+  --zd-surface: light-dark(#ffffff, #161b22);
+  --zd-muted: light-dark(#59636e, #9198a1);
+  --zd-accent: light-dark(#0969da, #4493f8);
+  --zd-accent-hover: light-dark(#0550ae, #79c0ff);
+  --zd-code-bg: light-dark(#f6f8fa, #161b22);
+  --zd-code-fg: light-dark(#1f2328, #e6edf3);
+  --zd-success: light-dark(#1a7f37, #3fb950);
+  --zd-danger: light-dark(#d1242f, #f85149);
+  --zd-warning: light-dark(#9a6700, #d29922);
+  --zd-info: light-dark(#0969da, #4493f8);
+
+  /* syntax — all 9 roles restyled, both modes (the foundry syntax-theming
+     proof). Primer's classic highlighting palette; inserted/deleted reuse
+     the success/danger hues (Primer's diff colors). */
+  --zd-syntax-comment: light-dark(#6e7781, #8b949e);
+  --zd-syntax-string: light-dark(#0a3069, #a5d6ff);
+  --zd-syntax-number: light-dark(#0550ae, #79c0ff);
+  --zd-syntax-keyword: light-dark(#cf222e, #ff7b72);
+  --zd-syntax-callable: light-dark(#8250df, #d2a8ff);
+  --zd-syntax-type: light-dark(#953800, #ffa657);
+  --zd-syntax-name: light-dark(#1f2328, #e6edf3);
+  --zd-syntax-inserted: light-dark(#1a7f37, #3fb950);
+  --zd-syntax-deleted: light-dark(#d1242f, #f85149);
+
+  /* fonts — self-hosted Inter (variable, 400-700) for body/prose; system
+     mono stack (no webfont fetched for code). */
+  --font-sans: "Inter", -apple-system, "Segoe UI", system-ui, sans-serif;
+  --font-mono: ui-monospace, "SF Mono", SFMono-Regular, Menlo, Consolas,
+    "Liberation Mono", monospace;
+
+  /* Tier-3 component seams — semibold, gently tightened Inter headings (the
+     Inter signature); bare links until hover, GitHub-style. */
+  --zdc-doc-title-weight: 600;
+  --zdc-doc-title-tracking: -0.02em;
+  --zdc-doc-h2-weight: 600;
+  --zdc-doc-h2-tracking: -0.011em;
+  --zdc-doc-link-decoration: none;
+  --zdc-admonition-radius: 0 6px 6px 0;
+  --zdc-admonition-border-width: 4px;
+  --zdc-card-radius: 6px;
+}
+
+/* ---- Foundry extras: every move is a subtraction ---- */
+
+html[data-theme-pack="foundry"] .zd-content a:hover {
+  text-decoration: underline;
+}
+/* footer: quiet links, underline only on intent. footer[data-footer] is the
+   stable hook (footer/footer.tsx) — the sole <footer> inside
+   .zd-sidebar-content-wrapper (doclayout/doc-layout.tsx). */
+html[data-theme-pack="foundry"] footer[data-footer] a {
+  text-decoration: none;
+}
+html[data-theme-pack="foundry"] footer[data-footer] a:hover {
+  text-decoration: underline;
+}
+
+/* headings: flat GitHub hairline rules instead of the default gradient bar.
+   The h2 rule needs !important to defeat the SSR-inlined
+   `style="border-image:linear-gradient(...)"` (Decision 6.6's sole
+   allowlisted carve-out). */
+html[data-theme-pack="foundry"] .zd-content h1 {
+  padding-bottom: 0.55rem;
+  border-bottom: 1px solid color-mix(in srgb, var(--zd-muted) 42%, transparent);
+}
+html[data-theme-pack="foundry"] .zd-content h2 {
+  border-image: none !important;
+  border-top-width: 1px;
+  border-top-color: color-mix(in srgb, var(--zd-muted) 42%, transparent);
+}
+
+/* inline code: neutral wash that holds up in both modes */
+html[data-theme-pack="foundry"] .zd-content code:not(pre code) {
+  background-color: color-mix(in srgb, var(--zd-muted) 18%, transparent);
+}
+
+/* header nav: pill wash on hover, never an underline */
+html[data-theme-pack="foundry"] [data-nav-item] {
+  border-radius: 6px;
+}
+html[data-theme-pack="foundry"] [data-nav-item]:hover {
+  text-decoration: none;
+  background: color-mix(in srgb, var(--zd-muted) 14%, transparent);
+}
+
+/* sidebar: gray hover wash; active item = subtle fill + Primer-blue bar */
+html[data-theme-pack="foundry"] #desktop-sidebar a:hover {
+  text-decoration: none;
+  background: color-mix(in srgb, var(--zd-muted) 14%, transparent);
+}
+html[data-theme-pack="foundry"] a[data-nav-active] {
+  background: color-mix(in srgb, var(--zd-muted) 16%, transparent);
+  color: var(--zd-fg);
+  font-weight: 600;
+  box-shadow: inset 3px 0 0 var(--zd-accent);
+  border-radius: 0 6px 6px 0;
+}
+
+/* TOC: active entry = 2px Primer-blue bar laid over the rail, ink text — no
+   pill. The real DOM marks the active entry with aria-current="true"
+   (toc/toc.tsx), not the prototype's .toc-active mock class. */
+html[data-theme-pack="foundry"] nav[data-zd-toc] a:hover {
+  text-decoration: none;
+  color: var(--zd-fg);
+}
+html[data-theme-pack="foundry"] nav[data-zd-toc] a[aria-current="true"] {
+  background: none;
+  color: var(--zd-fg);
+  font-weight: 600;
+  /* The toc <ul> carries the 1px rail + var(--spacing-hsp-lg) left padding.
+     Its overflow-y-auto makes overflow-x compute to auto too, clipping
+     descendants at the padding edge — so the bar can't paint OVER the rail;
+     pull back exactly to the padding edge instead, so the 2px blue bar sits
+     snug against the rail and stays fully visible. Text position is
+     preserved (-pad + 2px border + pad - 2px = 0). Depth-3/4 items
+     (indented via their <li>) show the bar at their own indent, same as
+     the prototype. */
+  margin-left: calc(-1 * var(--spacing-hsp-lg, 1rem));
+  padding-left: calc(var(--spacing-hsp-lg, 1rem) - 2px);
+  border-left: 2px solid var(--zd-accent);
+}
+
+/* admonitions: GitHub alert style — colored bar and title, no tinted fill.
+   With the fill gone, the default generous vertical padding reads as dead
+   air — tighten to the prototype's GitHub-alert hug. */
+html[data-theme-pack="foundry"] [data-admonition] {
+  background-color: transparent;
+  padding: 0.35rem 1rem 0.35rem;
+}
+html[data-theme-pack="foundry"] [data-admonition="note"] .admonition-title::before {
+  content: "ⓘ ";
+}
+html[data-theme-pack="foundry"] [data-admonition="tip"] .admonition-title::before {
+  content: "✦ ";
+}
+html[data-theme-pack="foundry"] [data-admonition="warning"] .admonition-title::before {
+  content: "⚠︎ ";
+}
+
+/* tables: Primer zebra striping */
+html[data-theme-pack="foundry"] .zd-content tbody tr:nth-child(even) {
+  background-color: var(--zd-code-bg);
+}
+
+/* pager cards: quiet gray hover wash under the default blue-border cue —
+   the prototype's `.doc-pager a:hover` treatment, dropped in the #2828
+   parity pass because `.zd-content > nav` over-matched NavCardGrid, and
+   restored (#2880) against the stable data-doc-pager hook (#2873). 8% muted
+   — one notch softer than the 14% nav/sidebar washes, since the pager card
+   is a much larger surface. */
+html[data-theme-pack="foundry"] .zd-content > nav[data-doc-pager] > a:hover {
+  background: color-mix(in srgb, var(--zd-muted) 8%, transparent);
+}

package/dist/theme-packs/futura-editorial/fonts/OFL.txt

@@ -0,0 +1,95 @@
+Copyright 2020 The Jost Project Authors (https://github.com/indestructible-type)
+Copyright 2022 The Noto Project Authors (https://github.com/notofonts/latin-greek-cyrillic)
+Copyright 2016 The Space Mono Project Authors (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/futura-editorial/meta.json

@@ -0,0 +1,38 @@
+{
+  "schemaVersion": 1,
+  "slug": "futura-editorial",
+  "name": "Futura Editorial",
+  "description": "Normal-weight geometric Futura headings over Noto Sans body — clean white, near-black ink, one restrained red accent.",
+  "mode": "light",
+  "version": "1.0.1",
+  "fonts": {
+    "sans": "Noto Sans",
+    "mono": "Space Mono",
+    "display": "Jost",
+    "loaded": ["Jost", "Noto Sans", "Space Mono"]
+  },
+  "preview": {
+    "light": {
+      "bg": "oklch(1 0 0)",
+      "fg": "oklch(0.17 0 0)",
+      "accent": "oklch(0.505 0.18 28)",
+      "syntax": {
+        "keyword": "oklch(0.505 0.18 28)",
+        "string": "oklch(0.47 0.09 160)",
+        "comment": "oklch(0.52 0 0)",
+        "callable": "oklch(0.45 0.1 250)"
+      }
+    },
+    "dark": {
+      "bg": "oklch(0.165 0 0)",
+      "fg": "oklch(0.935 0 0)",
+      "accent": "oklch(0.72 0.15 29)",
+      "syntax": {
+        "keyword": "oklch(0.72 0.15 29)",
+        "string": "oklch(0.76 0.1 160)",
+        "comment": "oklch(0.63 0 0)",
+        "callable": "oklch(0.73 0.095 250)"
+      }
+    }
+  }
+}

package/dist/theme-packs/futura-editorial/pack.css

@@ -0,0 +1,313 @@
+/* ============================================================
+   Geometric editorial — zudo-doc theme pack (ADR docs/adr/theme-packs.md)
+
+   Normal-weight Jost headings over a Noto Sans reading face — clean
+   white paper, near-black ink, ONE restrained editorial red. Jost is
+   the mandated OFL homage for the classic commercial geometric sans
+   this pack is named after (ADR Decision 5); the commercial name is
+   never load-bearing and never appears in this stylesheet. Signature
+   moves: weight-400 display headings with tight tracking and a red
+   tick above the h1; all radii zeroed with solid ink hairline rules
+   on masthead, h2, thead, and footer; a near-monochrome Space Mono
+   syntax palette reserving the single red for keywords; emoji
+   admonition icons swapped for uppercase typographic labels.
+
+   Every rule below is scoped under the pack's own
+   html[data-theme-pack="…"] attribute selector — 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:
+   - `.lead`         → `p[data-doc-description]` (the description
+                       paragraph DocContentHeader/DocPageShell emit —
+                       stable hook, kept anchored under the structural
+                       `.zd-content >` chain)
+   - `.sb-group > p` → the static group heads don't exist in the real
+                       SidebarTree island; not ported. The active link
+                       already renders the prototype's ink fill (the
+                       stock a[data-nav-active] ink indicator).
+   - `.toc-title`    → no desktop TOC heading exists (#1655), and the
+                       prototype's `.toc-active` ink fill IS the stock
+                       active style — the TOC needs no extras at all.
+   - `.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).
+                       The prototype's uppercase colophon line has no
+                       stable hook and is intentionally not ported.
+   - the theme-switcher flyout has stable hooks now ([data-switcher-card]
+     / [data-switcher-launcher]), but this pack styles neither — its
+     square-card print-offset shadow is intentionally NOT ported.
+
+   Fonts: latin subsets only (all three families) to stay well inside
+   the ~250 KB payload budget — a stray latin-ext glyph falls back to
+   the stack's system face.
+   ============================================================ */
+
+/* ---- Jost — display/heading face. Variable file covering 400–600:
+        weight 400 carries the headings (the signature), 500 the small
+        uppercase labels. ---- */
+
+@font-face {
+  font-family: "Jost";
+  font-style: normal;
+  font-weight: 400 600;
+  font-display: swap;
+  src: url("./fonts/Jost-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;
+}
+
+/* ---- Noto Sans — reading text. Weight-range variable file (400–700),
+        both styles — prose emphasis wants TRUE italics. ---- */
+
+@font-face {
+  font-family: "Noto Sans";
+  font-style: normal;
+  font-weight: 400 700;
+  font-display: swap;
+  src: url("./fonts/NotoSans-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: "Noto Sans";
+  font-style: italic;
+  font-weight: 400 700;
+  font-display: swap;
+  src: url("./fonts/NotoSans-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;
+}
+
+/* ---- Space Mono — code face (static 400 + 700; the 700 keeps
+        keywords genuinely bold, not smeared). ---- */
+
+@font-face {
+  font-family: "Space Mono";
+  font-style: normal;
+  font-weight: 400;
+  font-display: swap;
+  src: url("./fonts/SpaceMono-400-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: "Space Mono";
+  font-style: normal;
+  font-weight: 700;
+  font-display: swap;
+  src: url("./fonts/SpaceMono-700-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="futura-editorial"] {
+  /* Tier-2 semantic roles — ink on paper both ways: a pure-white /
+     near-black flip, the same restrained editorial red in both modes.
+     Both modes always via light-dark(). */
+  --zd-bg: light-dark(oklch(1 0 0), oklch(0.165 0 0));
+  --zd-fg: light-dark(oklch(0.17 0 0), oklch(0.935 0 0));
+  --zd-selection-bg: light-dark(oklch(0.17 0 0), oklch(0.935 0 0));
+  --zd-selection-fg: light-dark(oklch(1 0 0), oklch(0.165 0 0));
+  --zd-surface: light-dark(oklch(1 0 0), oklch(0.145 0 0));
+  --zd-muted: light-dark(oklch(0.44 0 0), oklch(0.71 0 0));
+  --zd-accent: light-dark(oklch(0.505 0.18 28), oklch(0.72 0.15 29));
+  --zd-accent-hover: light-dark(oklch(0.42 0.16 28), oklch(0.78 0.12 29));
+  --zd-code-bg: light-dark(oklch(0.965 0 0), oklch(0.215 0 0));
+  --zd-code-fg: light-dark(oklch(0.22 0 0), oklch(0.93 0 0));
+  --zd-success: light-dark(oklch(0.46 0.11 155), oklch(0.72 0.12 155));
+  --zd-danger: light-dark(oklch(0.505 0.18 28), oklch(0.7 0.16 28));
+  --zd-warning: light-dark(oklch(0.5 0.11 75), oklch(0.78 0.12 80));
+  --zd-info: light-dark(oklch(0.46 0.1 250), oklch(0.72 0.1 250));
+
+  /* syntax — all 9 roles, both modes: near-monochrome editorial ink
+     with the red reserved for keywords; strings/numbers/callables stay
+     low-chroma. inserted/deleted reuse the success/danger hues. The
+     light comment is nudged from the prototype's 0.55 gray to 0.52 to
+     clear WCAG 4.5:1 on the code background. */
+  --zd-syntax-comment: light-dark(oklch(0.52 0 0), oklch(0.63 0 0));
+  --zd-syntax-string: light-dark(oklch(0.47 0.09 160), oklch(0.76 0.1 160));
+  --zd-syntax-number: light-dark(oklch(0.5 0.1 60), oklch(0.78 0.11 75));
+  --zd-syntax-keyword: light-dark(oklch(0.505 0.18 28), oklch(0.72 0.15 29));
+  --zd-syntax-callable: light-dark(oklch(0.45 0.1 250), oklch(0.73 0.095 250));
+  --zd-syntax-type: light-dark(oklch(0.42 0.06 250), oklch(0.79 0.06 250));
+  --zd-syntax-name: light-dark(oklch(0.2 0 0), oklch(0.93 0 0));
+  --zd-syntax-inserted: light-dark(oklch(0.46 0.11 155), oklch(0.72 0.12 155));
+  --zd-syntax-deleted: light-dark(oklch(0.505 0.18 28), oklch(0.7 0.16 28));
+
+  /* fonts — Noto Sans carries the reading text, Space Mono the code,
+     Jost the display face for headings and labels. */
+  --font-sans: "Noto Sans", system-ui, sans-serif;
+  --font-mono: "Space Mono", ui-monospace, monospace;
+  --font-display: "Jost", system-ui, sans-serif;
+
+  /* Tier-3 component seams — NORMAL-weight display headings with tight
+     tracking (the signature move); square print geometry: zero radii,
+     hairline 2px admonition spines. */
+  --zdc-doc-title-font: var(--font-display);
+  --zdc-doc-title-weight: 400;
+  --zdc-doc-title-tracking: -0.02em;
+  --zdc-doc-h2-font: var(--font-display);
+  --zdc-doc-h2-weight: 400;
+  --zdc-doc-h2-tracking: -0.01em;
+  --zdc-doc-h3-weight: 500;
+  --zdc-admonition-radius: 0;
+  --zdc-admonition-border-width: 2px;
+  --zdc-card-radius: 0;
+}
+
+/* ---- extras ---- */
+
+/* masthead: geometric logotype over a solid ink rule */
+html[data-theme-pack="futura-editorial"] header[data-header] {
+  border-bottom: 1px solid var(--zd-fg);
+}
+html[data-theme-pack="futura-editorial"] [data-header-logo] {
+  font-family: var(--font-display);
+  font-weight: 400;
+  font-size: 1.05rem;
+  text-transform: uppercase;
+  letter-spacing: 0.16em;
+}
+html[data-theme-pack="futura-editorial"] [data-nav-item] {
+  font-family: var(--font-display);
+  font-weight: 500;
+  letter-spacing: 0.04em;
+}
+
+/* sidebar: the stock ink-fill active indicator already matches the
+   prototype; only its optical tracking tweak is ported */
+html[data-theme-pack="futura-editorial"] a[data-nav-active] {
+  letter-spacing: 0.01em;
+}
+
+/* title block: red tick above the h1 (signature move #1) */
+html[data-theme-pack="futura-editorial"] .zd-content h1::before {
+  content: "";
+  display: block;
+  width: 3.25rem;
+  height: 0.25rem;
+  background: var(--zd-accent);
+  margin-bottom: 1.4rem;
+}
+
+/* the deck: display-face standfirst under the headline (prototype
+   `.lead` — see the adaptation note in the header comment) */
+html[data-theme-pack="futura-editorial"] .zd-content > p[data-doc-description] {
+  font-family: var(--font-display);
+  font-weight: 400;
+  font-size: 1.3rem;
+  line-height: 1.5;
+}
+
+/* headings: full-width solid ink hairline over h2 instead of the stock
+   fade (signature move #2). The h2 rule needs !important to defeat the
+   SSR-inlined `style="border-image:linear-gradient(...)"` (Decision
+   6.6's sole allowlisted carve-out). */
+html[data-theme-pack="futura-editorial"] .zd-content h2 {
+  border-image: none !important;
+  border-top-width: 1px;
+  border-top-color: var(--zd-fg);
+}
+html[data-theme-pack="futura-editorial"] .zd-content h3 {
+  font-family: var(--font-display);
+  letter-spacing: 0.01em;
+  font-size: 1.2rem;
+}
+
+/* prose details: hairline underlines with print offset */
+html[data-theme-pack="futura-editorial"] .zd-content a {
+  text-decoration-thickness: 1px;
+  text-underline-offset: 0.2em;
+}
+html[data-theme-pack="futura-editorial"] .zd-content blockquote {
+  border-left: 2px solid var(--zd-fg);
+  color: var(--zd-fg);
+  font-family: var(--font-display);
+  font-weight: 400;
+  font-size: 1.2rem;
+  line-height: 1.5;
+  padding: 0.35rem 0 0.35rem 1.25rem;
+}
+
+/* code: Space Mono at print scale inside a quiet ink hairline frame;
+   square corners (print has none) */
+html[data-theme-pack="futura-editorial"] pre.hi-root {
+  font-size: 0.85rem;
+  border-color: color-mix(in oklch, var(--zd-fg) 20%, transparent);
+  border-radius: 0;
+}
+html[data-theme-pack="futura-editorial"] .hi-com {
+  font-style: italic;
+}
+html[data-theme-pack="futura-editorial"] .zd-content code:not(pre code) {
+  font-weight: 400;
+  border-radius: 0;
+}
+
+/* admonitions: uppercase typographic labels, em-dash ticks instead of
+   emoji across all seven variants (signature move #4) */
+html[data-theme-pack="futura-editorial"] [data-admonition] .admonition-title {
+  font-family: var(--font-display);
+  font-weight: 500;
+  text-transform: uppercase;
+  letter-spacing: 0.14em;
+  font-size: 0.8rem;
+}
+html[data-theme-pack="futura-editorial"] [data-admonition="note"] .admonition-title::before,
+html[data-theme-pack="futura-editorial"] [data-admonition="tip"] .admonition-title::before,
+html[data-theme-pack="futura-editorial"] [data-admonition="info"] .admonition-title::before,
+html[data-theme-pack="futura-editorial"] [data-admonition="warning"] .admonition-title::before,
+html[data-theme-pack="futura-editorial"] [data-admonition="danger"] .admonition-title::before,
+html[data-theme-pack="futura-editorial"] [data-admonition="important"] .admonition-title::before,
+html[data-theme-pack="futura-editorial"] [data-admonition="caution"] .admonition-title::before {
+  content: "\2014\2002";
+}
+
+/* tables: uppercase display column heads over a solid ink rule
+   (signature move #3) */
+html[data-theme-pack="futura-editorial"] .zd-content th {
+  font-family: var(--font-display);
+  font-weight: 500;
+  text-transform: uppercase;
+  letter-spacing: 0.1em;
+  font-size: 0.78rem;
+  border-bottom: 2px solid var(--zd-fg);
+}
+
+/* pager: square folio cards, ink border on hover, uppercase display
+   labels (DocPager selector — see the header adaptation note) */
+html[data-theme-pack="futura-editorial"] .zd-content > nav[data-doc-pager] a {
+  border-radius: 0;
+}
+html[data-theme-pack="futura-editorial"] .zd-content > nav[data-doc-pager] a:hover {
+  border-color: var(--zd-fg);
+}
+html[data-theme-pack="futura-editorial"] .zd-content > nav[data-doc-pager] a > div {
+  font-family: var(--font-display);
+  font-weight: 500;
+  text-transform: uppercase;
+  letter-spacing: 0.12em;
+  font-size: 0.68rem;
+}
+html[data-theme-pack="futura-editorial"] .zd-content > nav[data-doc-pager] a p {
+  font-family: var(--font-display);
+  font-weight: 500;
+}
+
+/* footer: colophon under a solid ink hairline */
+html[data-theme-pack="futura-editorial"] footer[data-footer] {
+  border-top: 1px solid var(--zd-fg);
+}