@leed-ai/cli 0.0.0-stage → 6.19.0

package/dist/static/tailwind/docs/layouts/bravo.css

@@ -0,0 +1,218 @@
+.docs-layout-bravo {
+  #docs-header-wrapper {
+    @apply w-full fixed top-0 z-40;
+
+    &:has(.document-search-modal-wrapper[aria-hidden="false"]) {
+      @apply z-[999999];
+    }
+  }
+
+  #docs-sidebar-nav {
+    @apply fixed top-0 lg:top-[calc(var(--height-header)+51px)] lg:left-5 left-0 w-[234px] px-0 lg:h-[calc(100vh-var(--height-header)-67px)] h-full z-[99999] lg:z-99;
+  }
+
+  #docs-header-container {
+    @apply w-full mx-auto px-4 md:py-0 relative;
+
+    #docs-menu-container {
+      @apply z-50;
+    }
+    #docs-navigation-button-wrapper {
+      @apply z-40;
+    }
+
+    #docs-navigation-button-wrapper ul[role="menu"] {
+      @apply border-0;
+
+      > li > a {
+        @apply flex py-3 h-full items-center text-sm font-medium border-b-0 border-transparent text-gray-600 dark:text-gray-400 hover:text-gray-800 dark:hover:text-gray-300;
+      }
+    }
+  }
+
+  #docs-container {
+    @apply fixed px-[0.5rem] pb-[0.5rem];
+  }
+
+  #docs-content-wrapper {
+    @apply flex-1 mx-2 mb-4 pr-6 pl-6 lg:mr-0 lg:ml-64 overflow-y-auto bg-white dark:bg-white/[0.02] border border-gray-200/70 dark:border-white/[0.07] rounded-2xl overflow-y-auto min-h-0;
+  }
+
+  .docs-sidebar {
+    @apply border-0 w-72 pr-8 z-[20] bg-(--component-bg-color) md:bg-transparent;
+
+    /* `pb-4` rather than `py-4`: below `lg` this panel is the open drawer and
+       its own scrollport, and #docs-nav-filter sticks against it. A top padding
+       there would put a strip above the sticky box for menu rows to scroll
+       through, and the box already supplies that 1rem itself with `pt-4`.
+       See components/navigation.css. */
+    #docs-navigation {
+      @apply px-0 pb-4 md:px-4 lg:p-0;
+
+      /* Three corrections to the shared #docs-nav-filter for this layout.
+
+         `px-3` below `md`: this panel is `px-0` there and menu rows are inset
+         by `.leed-menu__item--wrapper`'s own `px-3`, so the box would otherwise
+         run edge to edge past every row beneath it. `md:px-0` hands the job
+         back to `md:px-4` above.
+
+         The background matches the backdrop rather than following
+         `.docs-sidebar` into transparency — see the `color-mix` note below.
+         The shared rule paints `--component-bg-color` at every width, which
+         reads as a differently colored panel around the input once the bar
+         behind it has gone transparent at `md`.
+
+         `lg:w-[226px]` matches the RENDERED search button above this nav, not
+         the `lg:w-[230px]` on its `.header-search-button` wrapper (line 190):
+         `#document-search-container` (line 165) carries `md:ml-1`, so the
+         button itself measures 230px - 4px = 226px. Match the control the
+         reader sees, not the box around it. The filter would otherwise be
+         202px — the 234px `#docs-sidebar-nav` less `.docs-sidebar`'s `pr-8` —
+         so the two stacked controls rendered at visibly different widths.
+
+         `pt-2` and no negative offsets below `lg`: the shared rule's
+         `-top-4 -mt-4` cancel a 1rem top padding on the scrollport, and this
+         layout's `pb-4` deliberately does not have one. With nothing to cancel
+         they over-pull, and the box's own `pt-4` then reads as too much space
+         above the input. */
+      #docs-nav-filter {
+        @apply px-3 pt-2 mt-0 top-0 md:px-0 lg:-top-4 lg:-mt-4 lg:pt-4 lg:w-[226px];
+
+        /* Opaque, and the exact color of what sits behind the nav — the box is
+           sticky, so menu rows pass underneath it and a transparent or merely
+           approximate fill lets their text show through. `.docs-sidebar` is
+           `md:bg-transparent` (line 42) — but `#docs-navigation` sits between
+           that and this box, and `components/navigation.css:42` paints it
+           `bg-(--component-bg-color) lg:bg-transparent`. So the page only
+           becomes the backdrop at `lg`, not at `md`: below `lg` the shared
+           rule's `--component-bg-color` already matches the panel exactly, and
+           gating this at `md` mismatched the whole 768-1023px band. From `lg`
+           the backdrop is `--docs-bg-color` with `#fixed-bg` (line 166) laying
+           3% of `--component-fixed-body-bg-color` over it; `color-mix`
+           reproduces that composite as one opaque color rather than guessing
+           at it — a plain `--docs-bg-color` would be 3% too light. */
+        @media (width >= 64rem) {
+          background-color: color-mix(in srgb, var(--component-fixed-body-bg-color) 3%, var(--docs-bg-color));
+        }
+      }
+    }
+  }
+
+  #documentation {
+    @apply px-0 flex flex-col;
+
+    &:has(#docs-mini-bar) {
+      @apply pt-0;
+    }
+
+    nav#docs-pagination {
+      /* Empty grid cells to maintain layout */
+      &::before,
+      &::after {
+        @apply content-[""] block;
+      }
+
+      .docs-pagination__link {
+        @apply py-3 pb-4 px-4 rounded-xl border border-(--component-border-color)/20 hover:border-(--component-border-color)/40;
+      }
+
+      .docs-pagination__link--prev,
+      .docs-pagination__link--next {
+        @apply w-full;
+      }
+    }
+  }
+
+  #leed-toc {
+    @apply top-0 px-0!;
+
+    .leed-nav-toc {
+      @apply border-0 p-0 mt-2;
+
+      ol ol {
+        @apply ml-0;
+      }
+
+      li a {
+        @apply py-1 pl-4 my-0 border-l border-gray-950/5 dark:border-white/10 hover:border-gray-950/20 dark:hover:border-white/20;
+      }
+      li a[aria-current="location"] {
+        @apply border-l-(--component-primary-color);
+      }
+      li li a {
+        @apply pl-8;
+      }
+    }
+  }
+
+  .leed-breadcrumbs {
+    @apply mt-0 lg:mt-6;
+    & .leed-breadcrumbs__crumb {
+      a {
+        @apply text-(--component-text-color) hover:text-(--component-body-link-color) font-normal transition-colors duration-300;
+      }
+
+      /* Current page styling */
+      a[aria-current="location"] {
+        @apply text-(--component-text-color) font-medium pointer-events-none;
+      }
+    }
+  }
+  #docs-mini-bar + .leed-breadcrumbs {
+    @apply mt-4;
+  }
+
+  #docs-footer-wrapper {
+    @apply mx-0 xl:mx-[4rem];
+  }
+  #docs-footer {
+    @apply xl:max-w-5xl mx-auto px-4 md:px-0;
+  }
+  a.docs-heading-anchor {
+    @apply text-(--component-text-color)/70;
+    &:hover {
+      @apply text-(--component-text-color);
+    }
+  }
+  .divide-every-children {
+    :where(& > :not(:last-child)) {
+      @apply border-b border-(--component-step-light-color);
+    }
+  }
+
+  #fixed-bg {
+    @apply fixed inset-0 -z-10 bg-(--component-fixed-body-bg-color)/3;
+  }
+
+  #docs-layout {
+    @apply h-[calc(100vh-var(--height-header))] lg:h-[calc(100vh-4.5rem)] w-full;
+  }
+  #document-search-container {
+    @apply sticky top-0 z-10 md:ml-1;
+
+    .search-trigger-button {
+      @apply lg:bg-white dark:bg-(--component-bg-color) rounded-xl;
+    }
+  }
+  #docs-content {
+    @apply w-full max-w-5xl;
+  }
+  .api-layout .api-sidebar-column {
+    @apply top-18 h-auto;
+  }
+
+  #docs-mini-bar {
+    @apply top-0 -ml-6 pl-6 pr-6 w-[calc(100%+48px)];
+    & #docs-mini-bar-buttons {
+      button.mini-menu {
+        @apply p-0 ml-0 shadow-none;
+      }
+      button.mini-toc {
+        @apply mr-0;
+      }
+    }
+  }
+  .header-search-button {
+    @apply static lg:absolute left-0 top-[calc(var(--height-header)+9px)] lg:w-[230px];
+  }
+}

package/dist/static/tailwind/docs/layouts/charlie.css

@@ -0,0 +1,105 @@
+.docs-layout-charlie {
+  #docs-header-wrapper {
+    @apply w-full fixed top-0 z-99999 bg-(--component-bg-color);
+    /* md:bg-transparent; */
+
+    &:after {
+      @apply bg-(--component-header-bg-color) border-b border-(--component-header-border-color)/20 dark:border-(--component-header-border-color)/10;
+    }
+  }
+
+  #docs-container {
+    @apply relative;
+  }
+
+  .docs-sidebar {
+    @apply border-r border-(--component-header-border-color)/20 dark:border-(--component-header-border-color)/10;
+
+    #docs-navigation {
+      /* `lg:pt-0` cancels the base rule's `lg:py-4`, and it is what keeps the
+         sticky filter still. `.docs-sidebar` is the desktop scrollport and
+         carries `pt-4`; the base `#docs-navigation` adds a second `lg:py-4`
+         inside it. #docs-nav-filter's `-mt-4` cancels one 1rem, so with two
+         above it the box rests 1rem lower than it sticks and visibly slides
+         that far on the first scroll. alpha and bravo never had the bug —
+         both already replace the base padding with `lg:p-0`. Charlie was the
+         only layout that let it through.
+         Bottom padding is deliberately left alone: `.docs-sidebar` is `pb-0`,
+         so `lg:py-4`'s lower half is the only gap under the last menu row. */
+      @apply px-3 lg:px-0 lg:pt-0;
+      /* The three transparent grounds below are DEFAULTS a site is expected to
+         override. Each selector already outranks everything that paints these
+         rows (`#docs-navigation a:hover` and the `[aria-current]` wrapper rule),
+         so `!` bought nothing except making a customer sidebar hover/current
+         ground impossible without an unlayered `!important` file.
+         Do not reinstate the `!`. */
+      [aria-current="page"] > .leed-menu__item--wrapper {
+        @apply bg-transparent;
+      }
+      & .leed-menu__item--wrapper {
+        @apply w-full lg:w-fit;
+        &:hover {
+          @apply bg-transparent;
+        }
+        &.leed-menu__item--no-link {
+          @apply hover:bg-transparent;
+        }
+      }
+    }
+  }
+
+  #documentation {
+    @apply w-full;
+
+    nav#docs-pagination {
+      .docs-pagination__link {
+        @apply py-3 pb-4 px-4 rounded-xl border border-(--component-border-color)/20 hover:border-(--component-border-color)/40;
+      }
+
+      .docs-pagination__link--prev,
+      .docs-pagination__link--next {
+        @apply w-full;
+      }
+    }
+  }
+
+  #leed-toc {
+    .leed-nav-toc {
+      @apply border-0 p-0;
+    }
+  }
+
+  #docs-footer-wrapper {
+    @apply border-t border-(--component-border-color)/5 bg-(--component-header-bg-color);
+
+    #docs-footer {
+      @apply max-w-5xl mx-auto px-8 py-10;
+    }
+  }
+
+  .divide-every-children {
+    :where(& > :not(:last-child)) {
+      @apply border-b border-(--component-step-light-color);
+    }
+  }
+
+  #docs-content {
+    @apply w-full max-w-5xl;
+  }
+
+  #docs-mini-bar {
+    @apply px-0 md:px-8;
+  }
+
+  #docs-footer-wrapper {
+    @apply mt-0;
+  }
+
+  /* `bg-transparent` here is a DEFAULT ground, not a reset: nothing else paints
+     #docs-content-wrapper under charlie (bravo's `bg-white` sits on the
+     mutually-exclusive `.docs-layout-bravo`). A site must be able to give the
+     content column a ground at normal specificity. Do not reinstate the `!`. */
+  #docs-content-wrapper {
+    @apply bg-transparent flex-1 mx-auto flex flex-col min-w-0 max-w-5xl;
+  }
+}

package/dist/static/tailwind/docs/layouts.css

@@ -0,0 +1,3 @@
+@import "./layouts/alpha.css";
+@import "./layouts/bravo.css";
+@import "./layouts/charlie.css";

package/dist/static/tailwind/docs/themes/amber.css

@@ -0,0 +1,113 @@
+@utility color-theme-amber {
+  /* primary colors */
+  --docs-primary-color: var(--color-amber-600);
+  --docs-primary-light: var(--color-amber-500);
+  --docs-primary-color-hover: var(--color-amber-700);
+
+  /* scroll status indicator colors */
+  --scroll-status-indicator-horizontal-start-bg: var(--docs-bg-color);
+  --scroll-status-indicator-horizontal-complete-bg: var(--docs-primary-color);
+  --scroll-status-indicator-horizontal-partial-bg: var(--color-zinc-500);
+
+  /* text colors */
+  --docs-text-color: var(--color-gray-700);
+  --docs-body-link-color: var(--docs-primary-color);
+  --docs-body-link-hover-color: var(--docs-primary-color-hover);
+
+  --docs-copied-content-text-color: var(--color-gray-100);
+  --menu-footer-header-text-color: var(--docs-text-color);
+
+  /* footer social icons colors */
+  --docs-footer-social-icons-color: var(--docs-text-color);
+  --docs-footer-social-icons-hover-color: var(--color-gray-500);
+
+  /* pagination icons colors */
+  --docs-pagination-icon-color: var(--color-gray-400);
+  --docs-pagination-icon-color-hover: var(--color-gray-900);
+
+  /* background and border colors */
+  --docs-bg-color: var(--color-white);
+  --docs-header-bg-color: var(--color-stone-100);
+  --docs-header-border-color: var(--color-gray-500);
+  --docs-sidebar-link-bg-color: var(--color-gray-100);
+  /* The row for the page you are on, in the sidebar and the mobile bar
+     (docs/components/navigation.css, docs/components/mobile-bar.css). Its text is
+     --docs-primary-color, and this is its ground; without it the chain in
+     components.css fell through to --default-current-location-bg-color, a slate
+     unrelated to any accent, so every built-in theme drew themed text on an
+     unthemed row. The accent's lightest tint keeps the pair inside one hue.
+     Light and dark are one rung apart from the ends of the ramp because the text
+     token is NOT lightened for dark mode — see the dark block below. */
+  --docs-current-location-bg-color: var(--color-amber-50);
+  --docs-code-bg-color: var(--color-stone-100);
+  --docs-code-inner-bg-color: var(--color-white);
+  --docs-code-border-color: var(--color-stone-950);
+  --docs-code-bg-color-selection: var(--color-amber-100);
+  --docs-form-border-color: var(--color-gray-300);
+  --docs-form-border-color-hover: var(--color-gray-400);
+  --form-border-color: var(--color-gray-200);
+  --form-download-spinner-text: var(--color-amber-600);
+  --docs-card-bg-color: var(--color-gray-100);
+  --docs-step-light-color: var(--color-gray-200);
+  --docs-fixed-body-bg-color: var(--color-slate-950);
+  --api-snippets-bg-color: var(--color-stone-100);
+  --docs-search-result-bg-color: var(--color-white);
+  --docs-search-button-bg-color: var(--color-white);
+  --docs-search-modal-bg-color: var(--color-white);
+
+  @media (prefers-color-scheme: dark) {
+    /* scroll status indicator colors */
+    --scroll-status-indicator-horizontal-partial-bg: var(--color-zinc-500);
+    --scroll-status-indicator-horizontal-complete-bg: var(--color-amber-800);
+
+    /* text colors */
+    --docs-text-color: var(--color-stone-400);
+    --docs-copied-content-text-color: var(--color-gray-300);
+
+    /* background and border colors */
+    --docs-bg-color: var(--color-stone-950);
+
+    --docs-form-border-color: var(--color-gray-800);
+    --docs-form-border-color-hover: var(--color-gray-700);
+    --form-border-color: var(--color-gray-600);
+    --form-download-spinner-text: var(--color-amber-400);
+    --docs-header-border-color: var(--color-white);
+    --docs-sidebar-link-bg-color: var(--color-gray-900);
+    /* Darkest rung of the same ramp, NOT a lightened accent: no theme overrides
+       --docs-primary-color for dark mode, so the row's text keeps its light-mode
+       rung here and the ground has to move to the far end to answer it. For the
+       themes whose accent already sits at 700-800 that is still a low-contrast
+       pair — the fix for those is a dark-mode --docs-primary-color, not a lighter
+       ground, which would make the row a bright slab on a near-black sidebar. */
+    --docs-current-location-bg-color: var(--color-amber-950);
+    --docs-sidebar-link-hover-bg-color: var(--color-gray-100);
+
+    --docs-footer-social-icons-hover-color: var(--color-gray-400);
+    --docs-pagination-icon-color: var(--color-gray-400);
+    --docs-pagination-icon-color-hover: var(--color-gray-200);
+
+    --docs-code-bg-color: var(--color-stone-900);
+    --docs-code-inner-bg-color: var(--color-neutral-950);
+
+    --docs-code-border-color: var(--color-white);
+    --docs-code-bg-color-selection: var(--color-amber-800);
+    --docs-card-bg-color: var(--color-stone-900);
+    --docs-step-light-color: var(--color-stone-800);
+
+    --docs-header-bg-color: var(--color-stone-900);
+
+    --docs-search-button-bg-color: var(--color-stone-950);
+    --docs-search-modal-bg-color: var(--color-stone-950);
+
+    /* Present in all 16 sibling themes and missing here — amber fell through to
+     --site-* / --default-* for these three, so a site using color-theme-amber
+     got an unthemed border and secondary button. Values mirror the siblings. */
+    --docs-border-color: var(--docs-header-border-color);
+    --docs-button-secondary-bg-color: var(--color-gray-600);
+    --docs-button-secondary-bg-hover-color: var(--color-gray-700);
+
+    --api-select-list-item-bg-color-hover: var(--color-white);
+  }
+
+  @apply docs-theme-defaults;
+}

package/dist/static/tailwind/docs/themes/blue.css

@@ -0,0 +1,94 @@
+@utility color-theme-blue {
+  --scroll-status-indicator-horizontal-start-bg: var(--docs-bg-color);
+  --scroll-status-indicator-horizontal-complete-bg: var(--color-blue-500);
+  --scroll-status-indicator-horizontal-partial-bg: var(--color-zinc-500);
+  --docs-primary-color: var(--color-blue-500);
+  --docs-primary-light: var(--color-blue-400);
+  --docs-primary-color-hover: var(--color-blue-600);
+  --docs-text-color: var(--color-gray-700);
+  --docs-body-link-color: var(--docs-primary-color);
+  --docs-body-link-hover-color: var(--docs-primary-color-hover);
+  --docs-bg-color: var(--color-white);
+  --docs-header-border-color: var(--color-slate-500);
+  --docs-sidebar-link-bg-color: var(--color-slate-100);
+  /* The row for the page you are on, in the sidebar and the mobile bar
+     (docs/components/navigation.css, docs/components/mobile-bar.css). Its text is
+     --docs-primary-color, and this is its ground; without it the chain in
+     components.css fell through to --default-current-location-bg-color, a slate
+     unrelated to any accent, so every built-in theme drew themed text on an
+     unthemed row. The accent's lightest tint keeps the pair inside one hue.
+     Light and dark are one rung apart from the ends of the ramp because the text
+     token is NOT lightened for dark mode — see the dark block below. */
+  --docs-current-location-bg-color: var(--color-blue-50);
+  --docs-code-bg-color: var(--color-slate-100);
+  --docs-code-inner-bg-color: var(--color-white);
+  --docs-copied-content-text-color: var(--color-slate-100);
+  --docs-code-border-color: var(--color-slate-950);
+  --docs-code-bg-color-selection: var(--color-blue-100);
+  --docs-footer-social-icons-color: var(--docs-text-color);
+  --docs-footer-social-icons-hover-color: var(--color-slate-500);
+  --docs-form-border-color: var(--color-slate-300);
+  --docs-form-border-color-hover: var(--color-slate-400);
+  --form-border-color: var(--color-slate-200);
+  --form-download-spinner-text: var(--color-blue-600);
+  --docs-pagination-icon-color: var(--color-slate-400);
+  --docs-pagination-icon-color-hover: var(--color-slate-900);
+  --docs-card-bg-color: var(--color-slate-100);
+  --docs-step-light-color: var(--color-slate-200);
+  --menu-footer-header-text-color: var(--docs-text-color);
+  --docs-fixed-body-bg-color: var(--color-slate-950);
+
+  --api-snippets-bg-color: var(--color-slate-100);
+  --docs-search-result-bg-color: var(--color-slate-100);
+  --docs-header-bg-color: var(--color-stone-100);
+  --docs-search-modal-bg-color: var(--color-white);
+  --docs-search-button-bg-color: var(--color-white);
+
+  --docs-border-color: var(--docs-header-border-color);
+  --api-select-list-item-bg-color-hover: var(--color-neutral-100);
+  --docs-button-secondary-bg-color: var(--color-gray-600);
+  --docs-button-secondary-bg-hover-color: var(--color-gray-700);
+
+  @media (prefers-color-scheme: dark) {
+    --scroll-status-indicator-horizontal-partial-bg: var(--color-zinc-500);
+    --scroll-status-indicator-horizontal-complete-bg: var(--color-blue-600);
+
+    --docs-text-color: var(--color-gray-400);
+    --docs-bg-color: var(--color-slate-950);
+    --docs-form-border-color: var(--color-slate-800);
+    --docs-form-border-color-hover: var(--color-slate-700);
+    --form-border-color: var(--color-slate-600);
+    --form-download-spinner-text: var(--color-blue-400);
+    --docs-header-border-color: var(--color-slate-200);
+    --docs-sidebar-link-bg-color: var(--color-slate-900);
+    /* Darkest rung of the same ramp, NOT a lightened accent: no theme overrides
+       --docs-primary-color for dark mode, so the row's text keeps its light-mode
+       rung here and the ground has to move to the far end to answer it. For the
+       themes whose accent already sits at 700-800 that is still a low-contrast
+       pair — the fix for those is a dark-mode --docs-primary-color, not a lighter
+       ground, which would make the row a bright slab on a near-black sidebar. */
+    --docs-current-location-bg-color: var(--color-blue-950);
+    --docs-sidebar-link-hover-bg-color: var(--color-slate-100);
+
+    --docs-footer-social-icons-hover-color: var(--color-slate-500);
+
+    --docs-pagination-icon-color: var(--color-slate-400);
+    --docs-pagination-icon-color-hover: var(--color-slate-200);
+
+    --docs-code-bg-color: var(--color-slate-900);
+    --docs-code-inner-bg-color: var(--color-slate-950);
+    --docs-copied-content-text-color: var(--color-slate-300);
+    --docs-code-border-color: var(--color-white);
+    --docs-code-bg-color-selection: var(--color-blue-800);
+    --docs-card-bg-color: var(--color-slate-900);
+    --docs-step-light-color: var(--color-slate-800);
+
+    --docs-header-bg-color: var(--color-slate-900);
+    --docs-search-modal-bg-color: var(--color-slate-950);
+    --docs-search-button-bg-color: var(--color-slate-950);
+
+    --api-select-list-item-bg-color-hover: var(--color-white);
+  }
+
+  @apply docs-theme-defaults;
+}

package/dist/static/tailwind/docs/themes/cyan.css

@@ -0,0 +1,111 @@
+@utility color-theme-cyan {
+  /* primary colors */
+  --docs-primary-color: var(--color-cyan-700);
+  --docs-primary-light: var(--color-cyan-600);
+  --docs-primary-color-hover: var(--color-cyan-800);
+
+  /* scroll status indicator colors */
+  --scroll-status-indicator-horizontal-start-bg: var(--docs-bg-color);
+  --scroll-status-indicator-horizontal-complete-bg: var(--docs-primary-color);
+  --scroll-status-indicator-horizontal-partial-bg: var(--color-zinc-500);
+
+  /* text colors */
+  --docs-text-color: var(--color-gray-700);
+  --docs-body-link-color: var(--docs-primary-color);
+  --docs-body-link-hover-color: var(--docs-primary-color-hover);
+
+  --docs-copied-content-text-color: var(--color-slate-100);
+  --menu-footer-header-text-color: var(--docs-text-color);
+
+  /* footer social icons colors */
+  --docs-footer-social-icons-color: var(--docs-text-color);
+  --docs-footer-social-icons-hover-color: var(--color-slate-500);
+
+  /* pagination icons colors */
+  --docs-pagination-icon-color: var(--color-gray-400);
+  --docs-pagination-icon-color-hover: var(--color-gray-900);
+
+  /* background and border colors */
+  --docs-bg-color: var(--color-white);
+  --docs-header-bg-color: var(--color-stone-100);
+  --docs-header-border-color: var(--color-slate-500);
+  --docs-sidebar-link-bg-color: var(--color-slate-100);
+  /* The row for the page you are on, in the sidebar and the mobile bar
+     (docs/components/navigation.css, docs/components/mobile-bar.css). Its text is
+     --docs-primary-color, and this is its ground; without it the chain in
+     components.css fell through to --default-current-location-bg-color, a slate
+     unrelated to any accent, so every built-in theme drew themed text on an
+     unthemed row. The accent's lightest tint keeps the pair inside one hue.
+     Light and dark are one rung apart from the ends of the ramp because the text
+     token is NOT lightened for dark mode — see the dark block below. */
+  --docs-current-location-bg-color: var(--color-cyan-50);
+  --docs-code-bg-color: var(--color-slate-100);
+  --docs-code-inner-bg-color: var(--color-white);
+  --docs-code-border-color: var(--color-stone-950);
+  --docs-code-bg-color-selection: var(--color-cyan-100);
+  --docs-form-border-color: var(--color-slate-300);
+  --docs-form-border-color-hover: var(--color-slate-400);
+  --form-border-color: var(--color-gray-200);
+  --form-download-spinner-text: var(--color-cyan-700);
+  --docs-card-bg-color: var(--color-slate-100);
+  --docs-step-light-color: var(--color-slate-200);
+  --docs-fixed-body-bg-color: var(--color-slate-950);
+  --api-snippets-bg-color: var(--color-stone-100);
+  --docs-search-result-bg-color: var(--color-white);
+  --docs-search-button-bg-color: var(--color-white);
+  --docs-search-modal-bg-color: var(--color-white);
+
+  --docs-border-color: var(--docs-header-border-color);
+  --api-select-list-item-bg-color-hover: var(--color-neutral-100);
+  --docs-button-secondary-bg-color: var(--color-gray-600);
+  --docs-button-secondary-bg-hover-color: var(--color-gray-700);
+
+  @media (prefers-color-scheme: dark) {
+    /* scroll status indicator colors */
+    --scroll-status-indicator-horizontal-partial-bg: var(--color-zinc-500);
+    --scroll-status-indicator-horizontal-complete-bg: var(--color-cyan-800);
+
+    /* text colors */
+    --docs-text-color: var(--color-gray-400);
+    --docs-copied-content-text-color: var(--color-slate-300);
+
+    /* background and border colors */
+    --docs-bg-color: var(--color-slate-950);
+
+    --docs-form-border-color: var(--color-slate-800);
+    --docs-form-border-color-hover: var(--color-slate-700);
+    --form-border-color: var(--color-gray-600);
+    --form-download-spinner-text: var(--color-cyan-400);
+    --docs-header-border-color: var(--color-white);
+    --docs-sidebar-link-bg-color: var(--color-slate-900);
+    /* Darkest rung of the same ramp, NOT a lightened accent: no theme overrides
+       --docs-primary-color for dark mode, so the row's text keeps its light-mode
+       rung here and the ground has to move to the far end to answer it. For the
+       themes whose accent already sits at 700-800 that is still a low-contrast
+       pair — the fix for those is a dark-mode --docs-primary-color, not a lighter
+       ground, which would make the row a bright slab on a near-black sidebar. */
+    --docs-current-location-bg-color: var(--color-cyan-950);
+    --docs-sidebar-link-hover-bg-color: var(--color-slate-100);
+
+    --docs-footer-social-icons-hover-color: var(--color-slate-400);
+    --docs-pagination-icon-color: var(--color-slate-400);
+    --docs-pagination-icon-color-hover: var(--color-slate-200);
+
+    --docs-code-bg-color: var(--color-slate-900);
+    --docs-code-inner-bg-color: var(--color-slate-950);
+
+    --docs-code-border-color: var(--color-white);
+    --docs-code-bg-color-selection: var(--color-cyan-800);
+    --docs-card-bg-color: var(--color-slate-900);
+    --docs-step-light-color: var(--color-slate-800);
+
+    --docs-header-bg-color: var(--color-slate-900);
+
+    --docs-search-button-bg-color: var(--color-slate-950);
+    --docs-search-modal-bg-color: var(--color-slate-950);
+
+    --api-select-list-item-bg-color-hover: var(--color-white);
+  }
+
+  @apply docs-theme-defaults;
+}