@takazudo/zudo-doc 3.3.0 → 4.0.0

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

@@ -0,0 +1,95 @@
+Copyright 2015 The Cormorant Project Authors (https://github.com/CatharsisFonts/Cormorant)
+Copyright 2020 The Jost Project Authors (https://github.com/indestructible-type)
+Copyright 2017 IBM Corp. with Reserved Font Name "Plex" (https://github.com/IBM/plex)
+
+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/onyx/meta.json

@@ -0,0 +1,38 @@
+{
+  "schemaVersion": 1,
+  "slug": "onyx",
+  "name": "Onyx",
+  "description": "Luxury noir — jet black, champagne serif headings, and a single gold hairline accent. Watch-brand restraint.",
+  "mode": "dark",
+  "version": "1.0.2",
+  "fonts": {
+    "sans": "Jost",
+    "mono": "IBM Plex Mono",
+    "display": "Cormorant Garamond",
+    "loaded": ["Cormorant Garamond", "Jost", "IBM Plex Mono"]
+  },
+  "preview": {
+    "light": {
+      "bg": "oklch(0.972 0.005 85)",
+      "fg": "oklch(0.22 0.012 80)",
+      "accent": "oklch(0.5 0.105 80)",
+      "syntax": {
+        "keyword": "oklch(0.51 0.105 82)",
+        "string": "oklch(0.47 0.07 155)",
+        "comment": "oklch(0.5 0.015 85)",
+        "callable": "oklch(0.45 0.045 250)"
+      }
+    },
+    "dark": {
+      "bg": "oklch(0.145 0.003 80)",
+      "fg": "oklch(0.92 0.022 88)",
+      "accent": "oklch(0.79 0.115 88)",
+      "syntax": {
+        "keyword": "oklch(0.8 0.115 88)",
+        "string": "oklch(0.78 0.07 155)",
+        "comment": "oklch(0.62 0.02 85)",
+        "callable": "oklch(0.82 0.04 250)"
+      }
+    }
+  }
+}

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

@@ -0,0 +1,497 @@
+/* ============================================================
+   Onyx — zudo-doc theme pack (ADR docs/adr/theme-packs.md)
+
+   Luxury noir. Jet black case, champagne dial, one gold hairline.
+   Dark mode is the hero (the boutique at night); light mode is the
+   same watch on an ivory tray in daylight — porcelain paper, ink
+   text, antique gold. Shape language: SQUARE — every radius goes
+   to 0; the only circle on the page is the switcher launcher, the
+   crown, ringed in gold. Cormorant Garamond carries the serif
+   voice (headings, lead, blockquote, pager titles, footer line);
+   Jost carries the wide-tracked uppercase labels; IBM Plex Mono
+   keeps the code quiet.
+
+   Every rule below is scoped under html[data-theme-pack="onyx"] —
+   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).
+
+   Font policy note (Decision 5): the prototype's commercial
+   geometric-sans / Didone fallbacks appear NOWHERE here — Jost is
+   the designated OFL geometric substitute, Cormorant Garamond the
+   Garamond/Didone voice, with bare generics closing every stack.
+
+   Prototype-selector adaptations against the REAL DOM (tokens-dump
+   §6 + component sources), noted inline where they matter:
+   - `.lead`      → `p[data-doc-description]` (#2873 stable hook on
+                    the description paragraph DocContentHeader emits;
+                    only present when the page has a frontmatter
+                    description — no longer falls back onto the first
+                    BODY paragraph)
+   - `.sb-group > p` gold group plaques → no stable hook exists for
+     sidebar group headers in the real SidebarTree island; the gold
+     treatment moves onto a[data-nav-active] (transparent ground,
+     gold text, a 1px gold spine via inset box-shadow — the
+     swissgrid idiom, no layout shift)
+   - `.doc-pager` → `.zd-content > nav[data-doc-pager] > a` (#2873
+     stable hook on the DocPager nav — replaces the batch-2
+     `:last-of-type:not([aria-label])` positional idiom)
+   - `.toc-title` / `a.toc-active` → no stable hooks (the real TOC
+     renders no title element; the active entry is utility-classed).
+     The TOC keeps its default fg-on-bg active treatment; only the
+     spine border (a stable `nav[data-zd-toc] ul` hook) is tuned.
+   - `footer .footer-copy` → `footer[data-footer] > div >
+     div:last-child:not(:first-child)` (#2873 stable hook; the
+     wrapper-descendant form is no longer needed)
+   - the flyout and launcher DO have stable hooks in the real
+     switcher island — `div[data-switcher-card]` and
+     `button[data-switcher-launcher]` (#2873) — the double gold frame
+     and the gold-ringed crown are ported.
+   ============================================================ */
+
+/* ---- Cormorant Garamond — the champagne serif: display headings,
+        lead, blockquotes, pager titles, footer engraving. Variable
+        latin subsets: 500–700 upright, 500–600 italic. ---- */
+
+@font-face {
+  font-family: "Cormorant Garamond";
+  font-style: normal;
+  font-weight: 500 700;
+  font-display: swap;
+  src: url("./fonts/CormorantGaramond-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: "Cormorant Garamond";
+  font-style: italic;
+  font-weight: 500 600;
+  font-display: swap;
+  src: url("./fonts/CormorantGaramond-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;
+}
+
+/* ---- Jost — the geometric label hand (variable 400–600, latin).
+        Body prose plus every wide-tracked uppercase plaque. ---- */
+
+@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;
+}
+
+/* ---- IBM Plex Mono — the code face (400/500, latin + latin-ext) ---- */
+
+@font-face {
+  font-family: "IBM Plex Mono";
+  font-style: normal;
+  font-weight: 400;
+  font-display: swap;
+  src: url("./fonts/IBMPlexMono-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: "IBM Plex Mono";
+  font-style: normal;
+  font-weight: 400;
+  font-display: swap;
+  src: url("./fonts/IBMPlexMono-400-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;
+}
+
+@font-face {
+  font-family: "IBM Plex Mono";
+  font-style: normal;
+  font-weight: 500;
+  font-display: swap;
+  src: url("./fonts/IBMPlexMono-500-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: "IBM Plex Mono";
+  font-style: normal;
+  font-weight: 500;
+  font-display: swap;
+  src: url("./fonts/IBMPlexMono-500-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="onyx"] {
+  /* Tier-2 semantic roles — jet black / porcelain ivory, one gold.
+     Both modes always via light-dark(). */
+  --zd-bg: light-dark(oklch(0.972 0.005 85), oklch(0.145 0.003 80));
+  --zd-fg: light-dark(oklch(0.22 0.012 80), oklch(0.92 0.022 88));
+  --zd-surface: light-dark(oklch(0.984 0.004 85), oklch(0.168 0.004 80));
+  --zd-muted: light-dark(oklch(0.465 0.02 82), oklch(0.665 0.025 85));
+
+  /* the single gold */
+  --zd-accent: light-dark(oklch(0.5 0.105 80), oklch(0.79 0.115 88));
+  --zd-accent-hover: light-dark(oklch(0.42 0.1 78), oklch(0.865 0.1 90));
+
+  /* selection: a gold foil press */
+  --zd-selection-bg: light-dark(oklch(0.855 0.095 88), oklch(0.79 0.115 88));
+  --zd-selection-fg: light-dark(oklch(0.18 0.01 80), oklch(0.145 0.003 80));
+
+  --zd-code-bg: light-dark(oklch(0.94 0.008 88), oklch(0.182 0.006 82));
+  --zd-code-fg: light-dark(oklch(0.24 0.012 80), oklch(0.9 0.02 88));
+
+  /* statuses, desaturated to boutique volume */
+  --zd-success: light-dark(oklch(0.46 0.085 150), oklch(0.72 0.09 150));
+  --zd-danger: light-dark(oklch(0.48 0.13 25), oklch(0.66 0.12 25));
+  /* light branch sits below the prototype's .52 so warning admonition
+     titles clear 4.5:1 over the 12% warning tint (review) */
+  --zd-warning: light-dark(oklch(0.49 0.11 65), oklch(0.75 0.12 70));
+  --zd-info: light-dark(oklch(0.46 0.07 250), oklch(0.74 0.06 250));
+
+  /* syntax — all 9 roles, both modes: champagne, jade, copper,
+     platinum — jewel tones at whisper level. inserted/deleted (not
+     in the prototype's 7) follow the same register: a jade wash in,
+     a muted ruby out. */
+  /* both branches pushed past the prototype's values so comments clear
+     4.5:1 on the code slab in each mode (review) */
+  --zd-syntax-comment: light-dark(oklch(0.5 0.015 85), oklch(0.62 0.02 85));
+  --zd-syntax-string: light-dark(oklch(0.47 0.07 155), oklch(0.78 0.07 155));
+  --zd-syntax-number: light-dark(oklch(0.49 0.1 55), oklch(0.76 0.1 60));
+  --zd-syntax-keyword: light-dark(oklch(0.51 0.105 82), oklch(0.8 0.115 88));
+  --zd-syntax-callable: light-dark(oklch(0.45 0.045 250), oklch(0.82 0.04 250));
+  --zd-syntax-type: light-dark(oklch(0.5 0.06 85), oklch(0.84 0.06 90));
+  --zd-syntax-name: light-dark(oklch(0.25 0.012 80), oklch(0.9 0.018 86));
+  --zd-syntax-inserted: light-dark(oklch(0.47 0.085 150), oklch(0.74 0.09 150));
+  --zd-syntax-deleted: light-dark(oklch(0.5 0.12 25), oklch(0.7 0.11 25));
+
+  /* faces: Jost (the geometric-sans hand), Cormorant Garamond
+     (the Garamond blood), quiet Plex mono. Bare generics close
+     every stack — no commercial names anywhere (Decision 5). */
+  --font-sans: "Jost", system-ui, sans-serif;
+  --font-mono: "IBM Plex Mono", ui-monospace, SFMono-Regular, Menlo, monospace;
+  --font-display: "Cormorant Garamond", Georgia, serif;
+
+  /* Tier-3 component seams — serif display headings, square case:
+     every radius 0, admonition borders thinned to a gold hairline. */
+  --zdc-doc-title-font: var(--font-display);
+  --zdc-doc-title-weight: 600;
+  --zdc-doc-title-tracking: 0.005em;
+  --zdc-doc-h2-font: var(--font-display);
+  --zdc-doc-h2-weight: 600;
+  --zdc-doc-h2-tracking: 0.015em;
+  --zdc-admonition-radius: 0;
+  --zdc-admonition-border-width: 1px; /* gold hairline, not a paint stripe */
+  --zdc-card-radius: 0;
+  --zdc-nav-active-weight: 500;
+}
+
+/* ---- Onyx extras ---- */
+
+/* faint champagne glow from above — a vitrine spotlight */
+html[data-theme-pack="onyx"] body {
+  background-image: radial-gradient(
+    120% 70% at 50% -10%,
+    color-mix(in oklch, var(--zd-accent) 5%, transparent),
+    transparent 62%
+  );
+  background-attachment: fixed;
+  letter-spacing: 0.005em;
+}
+
+/* header: engraved nameplate over a gold hairline */
+html[data-theme-pack="onyx"] header[data-header] {
+  border-bottom: 1px solid color-mix(in oklch, var(--zd-accent) 38%, transparent);
+}
+html[data-theme-pack="onyx"] [data-header-logo] {
+  font-family: var(--font-display);
+  font-weight: 600;
+  font-size: 1.35rem;
+  letter-spacing: 0.04em;
+}
+html[data-theme-pack="onyx"] [data-nav-item] {
+  font-size: 0.72rem;
+  font-weight: 500;
+  text-transform: uppercase;
+  letter-spacing: 0.18em;
+}
+/* `:not([aria-current="page"])` keeps the active item's fg-on-bg pill
+   readable — gold text on the fg ground would fail contrast (review) */
+html[data-theme-pack="onyx"] [data-nav-item]:not([aria-current="page"]):hover {
+  text-decoration: none;
+  color: var(--zd-accent);
+}
+
+/* sidebar: the boutique index behind its own gold hairline edge */
+html[data-theme-pack="onyx"] #desktop-sidebar {
+  border-right-color: color-mix(in oklch, var(--zd-accent) 22%, transparent);
+}
+
+/* the active page: no filled bar — a 1px gold spine and gold text
+   (transparent ground; inset shadow avoids any layout shift) */
+html[data-theme-pack="onyx"] a[data-nav-active] {
+  background: transparent;
+  color: var(--zd-accent);
+  border-radius: 0;
+  box-shadow: inset 1px 0 0 0 var(--zd-accent);
+}
+
+/* h1: serif display over a short gold rule */
+html[data-theme-pack="onyx"] .zd-content h1::after {
+  content: "";
+  display: block;
+  width: 4.5rem;
+  border-top: 1px solid var(--zd-accent);
+  margin-top: 1rem;
+}
+
+/* the lead: a maison line in serif italic. Targets the
+   `data-doc-description` hook (#2873) — see adaptation note. */
+html[data-theme-pack="onyx"] .zd-content > p[data-doc-description] {
+  font-family: var(--font-display);
+  font-style: italic;
+  font-size: 1.4rem;
+  line-height: 1.5;
+}
+
+/* h2: serif upper-roman numerals (a watch dial) over a gold 1px rule.
+   The !important defeats the SSR-inlined
+   `style="border-image:linear-gradient(...)"` (Decision 6.6's sole
+   allowlisted carve-out); the border-top shorthand thins the 3px
+   transparent rule to the gold hairline. */
+html[data-theme-pack="onyx"] .zd-content {
+  counter-reset: onyx-section;
+}
+html[data-theme-pack="onyx"] .zd-content h2 {
+  border-image: none !important;
+  border-top: 1px solid color-mix(in oklch, var(--zd-accent) 55%, transparent);
+  padding-top: 1.25rem;
+}
+html[data-theme-pack="onyx"] .zd-content h2::before {
+  counter-increment: onyx-section;
+  content: counter(onyx-section, upper-roman);
+  font-family: var(--font-display);
+  font-weight: 500;
+  font-size: 0.72em;
+  color: var(--zd-accent);
+  margin-right: 0.75rem;
+  letter-spacing: 0.08em;
+}
+
+/* h3: the caseback engraving — wide-tracked uppercase label with a
+   short gold dash */
+html[data-theme-pack="onyx"] .zd-content h3 {
+  font-family: var(--font-sans);
+  font-size: 0.82rem;
+  font-weight: 500;
+  text-transform: uppercase;
+  letter-spacing: 0.22em;
+  color: var(--zd-fg);
+}
+html[data-theme-pack="onyx"] .zd-content h3::before {
+  content: "— ";
+  color: var(--zd-accent);
+  letter-spacing: 0;
+}
+
+/* links: hairline gold underline */
+html[data-theme-pack="onyx"] .zd-content a {
+  text-decoration-thickness: 1px;
+  text-underline-offset: 3px;
+  text-decoration-color: color-mix(in oklch, var(--zd-accent) 55%, transparent);
+}
+html[data-theme-pack="onyx"] .zd-content a:hover {
+  text-decoration-color: var(--zd-accent-hover);
+}
+
+/* blockquote: a maison maxim in serif italic behind a gold hairline */
+html[data-theme-pack="onyx"] .zd-content blockquote {
+  border-left: 1px solid var(--zd-accent);
+  padding: 0.35rem 0 0.35rem 1.35rem;
+  font-family: var(--font-display);
+  font-style: italic;
+  font-size: 1.3rem;
+  line-height: 1.5;
+  color: color-mix(in oklch, var(--zd-fg) 82%, var(--zd-muted));
+}
+
+/* hr: a short centered gold rule */
+html[data-theme-pack="onyx"] .zd-content hr {
+  border-top: 1px solid var(--zd-accent);
+  width: 4.5rem;
+  margin: 2.75rem auto;
+  opacity: 0.85;
+}
+
+/* inline code: square, hairline-cased */
+html[data-theme-pack="onyx"] .zd-content code:not(pre code) {
+  border: 1px solid color-mix(in oklch, var(--zd-muted) 28%, transparent);
+  border-radius: 0;
+  font-weight: 400;
+}
+
+/* code block: the black velvet tray under a gold-tinted hairline */
+html[data-theme-pack="onyx"] pre.hi-root {
+  border-radius: 0;
+  border-color: color-mix(in oklch, var(--zd-accent) 26%, transparent);
+  box-shadow: inset 0 1px 0 color-mix(in oklch, var(--zd-accent) 14%, transparent);
+  line-height: 1.7;
+}
+html[data-theme-pack="onyx"] .hi-kw {
+  font-weight: 500;
+}
+
+/* table: the specification sheet — letterspaced headers over a gold
+   hairline, oldstyle table figures */
+html[data-theme-pack="onyx"] .zd-content th {
+  font-size: 0.68rem;
+  font-weight: 500;
+  text-transform: uppercase;
+  letter-spacing: 0.18em;
+  color: var(--zd-muted);
+  border-bottom: 1px solid color-mix(in oklch, var(--zd-accent) 50%, transparent);
+}
+html[data-theme-pack="onyx"] .zd-content td {
+  font-variant-numeric: oldstyle-nums;
+}
+
+/* admonitions: hairline plaques (1px via the seam token), engraved
+   uppercase titles, quiet lapidary glyphs across all seven variants */
+html[data-theme-pack="onyx"] [data-admonition] {
+  padding: 1.1rem 1.25rem 0.9rem;
+}
+html[data-theme-pack="onyx"] [data-admonition] .admonition-title {
+  font-size: 0.68rem;
+  font-weight: 500;
+  text-transform: uppercase;
+  letter-spacing: 0.22em;
+  margin-bottom: 0.5rem;
+}
+html[data-theme-pack="onyx"] [data-admonition="note"] .admonition-title::before {
+  content: "✦\2002";
+}
+html[data-theme-pack="onyx"] [data-admonition="tip"] .admonition-title::before {
+  content: "◇\2002";
+}
+html[data-theme-pack="onyx"] [data-admonition="info"] .admonition-title::before {
+  content: "✧\2002";
+}
+html[data-theme-pack="onyx"] [data-admonition="warning"] .admonition-title::before {
+  content: "▲\2002";
+}
+html[data-theme-pack="onyx"] [data-admonition="danger"] .admonition-title::before {
+  content: "◆\2002";
+}
+html[data-theme-pack="onyx"] [data-admonition="important"] .admonition-title::before {
+  content: "✱\2002";
+}
+html[data-theme-pack="onyx"] [data-admonition="caution"] .admonition-title::before {
+  content: "△\2002";
+}
+
+/* pager: two presentation cards — square, gold inset ring on hover,
+   uppercase labels, serif titles. Targets the DocPager's
+   `data-doc-pager` hook (#2873) directly. */
+html[data-theme-pack="onyx"] .zd-content > nav[data-doc-pager] > a {
+  border-radius: 0;
+  padding: 1rem 1.2rem;
+}
+html[data-theme-pack="onyx"] .zd-content > nav[data-doc-pager] > a:hover {
+  box-shadow: inset 0 0 0 1px var(--zd-accent);
+}
+html[data-theme-pack="onyx"] .zd-content > nav[data-doc-pager] > a div {
+  font-size: 0.62rem;
+  text-transform: uppercase;
+  letter-spacing: 0.22em;
+}
+html[data-theme-pack="onyx"] .zd-content > nav[data-doc-pager] > a p {
+  font-family: var(--font-display);
+  font-size: 1.25rem;
+  font-weight: 600;
+  letter-spacing: 0.01em;
+}
+
+/* TOC: a quieter spine (active entry keeps the default fg-on-bg
+   treatment — no stable hook exists for it) */
+html[data-theme-pack="onyx"] nav[data-zd-toc] ul {
+  border-left: 1px solid color-mix(in oklch, var(--zd-muted) 32%, transparent);
+}
+
+/* footer: an engraved copyright line under the closing gold hairline.
+   Targets the `data-footer` hook (#2873) directly. */
+html[data-theme-pack="onyx"] footer[data-footer] {
+  border-top: 1px solid color-mix(in oklch, var(--zd-accent) 30%, transparent);
+}
+/* italicize the copyright line only when it coexists with link/tag
+   columns (the ledger idiom — `:not(:first-child)` keeps a columns-only
+   footer's grid out of this positional rule) */
+html[data-theme-pack="onyx"] footer[data-footer] > div > div:last-child:not(:first-child) {
+  font-family: var(--font-display);
+  font-style: italic;
+  font-size: 0.95rem;
+  letter-spacing: 0.05em;
+}
+
+/* flyout: the jewelry box — double gold frame, serif title. Targets
+   the `data-switcher-card` hook (#2873). */
+html[data-theme-pack="onyx"] div[data-switcher-card] {
+  border: 1px solid color-mix(in oklch, var(--zd-accent) 55%, transparent);
+  border-radius: 0;
+  box-shadow: 0 18px 44px -10px rgb(0 0 0 / 0.55);
+}
+/* decorative gold rule only while NOT keyboard-focused — an unconditional
+   outline would beat the layered focus-visible utility and hide the focus
+   ring (#2883) */
+html[data-theme-pack="onyx"] div[data-switcher-card]:not(:focus-visible) {
+  outline: 1px solid color-mix(in oklch, var(--zd-accent) 22%, transparent);
+  outline-offset: 4px;
+}
+html[data-theme-pack="onyx"] div[data-switcher-card] p[aria-live="polite"] {
+  font-family: var(--font-display);
+  font-size: 1.45rem;
+  font-weight: 600;
+  letter-spacing: 0.03em;
+}
+
+/* browse-all dialog: the same jewelry-box framing at cabinet size —
+   square case, double gold frame, square card buttons (the flyout's
+   role/aria-label hook doesn't match this <dialog>) */
+html[data-theme-pack="onyx"] dialog[aria-labelledby="zd-theme-pack-dialog-title"] {
+  border: 1px solid color-mix(in oklch, var(--zd-accent) 55%, transparent);
+  border-radius: 0;
+  box-shadow: 0 18px 44px -10px rgb(0 0 0 / 0.55);
+}
+/* same focus-visible gate as the flyout card (#2883) */
+html[data-theme-pack="onyx"]
+  dialog[aria-labelledby="zd-theme-pack-dialog-title"]:not(:focus-visible) {
+  outline: 1px solid color-mix(in oklch, var(--zd-accent) 22%, transparent);
+  outline-offset: 4px;
+}
+html[data-theme-pack="onyx"] dialog[aria-labelledby="zd-theme-pack-dialog-title"] button {
+  border-radius: 0;
+}
+
+/* launcher: the crown — the page's only circle, gold-ringed. Targets
+   the `data-switcher-launcher` hook (#2873). */
+html[data-theme-pack="onyx"] button[data-switcher-launcher] {
+  border-color: color-mix(in oklch, var(--zd-accent) 60%, transparent);
+  box-shadow:
+    0 4px 14px -4px rgb(0 0 0 / 0.45),
+    0 0 0 4px color-mix(in oklch, var(--zd-accent) 10%, transparent);
+}