@leed-ai/cli 0.0.0-stage → 6.19.0

package/dist/static/site/_includes/leed/docs/alpha/documentation.hbs

@@ -0,0 +1,7 @@
+{{> leed/docs/mini-bar toc=true }}
+
+<main id="documentation" class="docs-main">
+{{> leed/docs/doc-article footer=true }}
+</main>
+
+{{> leed/docs/toc }}

package/dist/static/site/_includes/leed/docs/api-article.hbs

@@ -0,0 +1,75 @@
+{{!--
+    The body of an API reference page: description and schema tables in the main
+    column, request/response examples from the page content in the side column.
+    Shared by every layout theme; only the pagination differs between them.
+
+    Params:
+      prevLabel / nextLabel   pagination link text
+      footer                  render the docs footer under the pagination
+--}}
+<section id="leed-docs-copy" class="min-w-0">
+    <div class="api-layout" class="min-w-0">
+        <!-- Main Content Column -->
+        <div class="api-main-column">
+            <nav class="leed-breadcrumbs mb-6 hidden lg:block">
+                {{{ breadcrumbsNav '<i class="home"></i>' }}}
+            </nav>
+            <!-- Title and Endpoint -->
+            <div class="api-section">
+                <h1 class="api-title">{{title}}</h1>
+                <div class="api-method-container">
+                    <span class="api-method-badge api-method-{{openapi.method}}">{{openapi.method}}</span>
+                    <span class="api-endpoint-path">{{openapi.endpoint}}</span>
+                </div>
+                <p class="api-description">{{description}}</p>
+            </div>
+
+            {{!-- Security/Authorization --}}
+            {{> leed/api/security security=openapi.security }}
+
+            {{!-- Path Parameters --}}
+            {{> leed/api/parameters parameters=openapi.parameters.path paramType="Path" }}
+
+            {{!-- Query Parameters --}}
+            {{> leed/api/parameters parameters=openapi.parameters.query paramType="Query" }}
+
+            {{!-- Header Parameters --}}
+            {{> leed/api/parameters parameters=openapi.parameters.header paramType="Header" }}
+
+            {{!-- Cookie Parameters --}}
+            {{> leed/api/parameters parameters=openapi.parameters.cookie paramType="Cookie" }}
+
+            {{!-- Request Body --}}
+            {{> leed/api/request-body requestBody=openapi.requestBody }}
+
+            {{!-- Response Fields --}}
+            {{> leed/api/responses responses=openapi.responses }}
+
+{{!-- Optional site-supplied call to action, directly above the prev/next links.
+      API reference pages only — documentation pages have their own
+      `docs-page-cta.hbs`. Direct file-existence check, the same mechanism as
+      `header-includes.hbs`: create `_includes/api-page-cta.hbs` and it renders.
+
+      Repeated above the second pagination copy below: this layout renders the
+      links twice, once per breakpoint, and the CTA sits with each. --}}
+{{#if (templateExists "api-page-cta.hbs") }}
+{{> api-page-cta }}
+{{/if}}
+
+{{> leed/docs/pagination wrapperClass="mt-auto hidden xl:block" prevLabel=prevLabel nextLabel=nextLabel footer=footer }}
+        </div>
+
+        {{!-- Code and Response Examples --}}
+        <div class="api-sidebar-column">
+            <div class="api-sidebar-content">
+                {{{ content }}}
+            </div>
+        </div>
+    </div>
+</section>
+
+{{#if (templateExists "api-page-cta.hbs") }}
+{{> api-page-cta }}
+{{/if}}
+
+{{> leed/docs/pagination wrapperClass="mt-auto xl:hidden" prevLabel=prevLabel nextLabel=nextLabel footer=footer }}

package/dist/static/site/_includes/leed/docs/bravo/api.hbs

@@ -0,0 +1,5 @@
+<main id="documentation" class="docs-main">
+{{> leed/docs/mini-bar toc=false breadcrumbClass="mt-0! ml-3" }}
+
+{{> leed/docs/api-article prevLabel="Previous" nextLabel="Next" }}
+</main>

package/dist/static/site/_includes/leed/docs/bravo/base.hbs

@@ -0,0 +1,31 @@
+{{!--
+    Bravo layout: full-width page with a fixed background panel behind a centered
+    content column, and a compact header that groups nav, search and CTA.
+    The footer sits at the bottom of the content wrapper.
+
+    Partial calls that lead to page content MUST start at column 0 — Handlebars
+    indents a partial's whole output by its call site, which would indent the
+    rendered code blocks.
+--}}
+{{#> leed/docs/shell header="leed/docs/header/compact" bodyGrow=true }}
+{{!-- Main docs container --}}
+<div id="docs-container" class="w-full mx-auto">
+    {{> leed/docs/sidebar }}
+
+    <div id="fixed-bg"></div>
+
+    <div id="docs-layout" class="flex">
+        {{!-- Content area (contains main content and TOC) --}}
+        <div id="docs-content-wrapper" class="fixed-content-layout">
+            <div id="docs-content" class="flex gap-x-12 justify-center mx-auto">
+{{#if openapi.endpoint}}
+{{> leed/docs/bravo/api }}
+{{else}}
+{{> leed/docs/bravo/documentation }}
+{{/if}}
+            </div>
+            {{> leed/docs/footer }}
+        </div>
+    </div>
+</div>
+{{/leed/docs/shell}}

package/dist/static/site/_includes/leed/docs/bravo/documentation.hbs

@@ -0,0 +1,7 @@
+<main id="documentation" class="docs-main">
+    {{> leed/docs/mini-bar toc=true }}
+
+{{> leed/docs/doc-article contentId="content" prevLabel="Previous" nextLabel="Next" }}
+</main>
+
+{{> leed/docs/toc }}

package/dist/static/site/_includes/leed/docs/charlie/api.hbs

@@ -0,0 +1,6 @@
+{{> leed/docs/mini-bar toc=false }}
+
+{{!-- No right padding in larger size due to extra space from sidebar --}}
+<main id="documentation" class="api-documentation docs-main">
+{{> leed/docs/api-article prevLabel="Previous" nextLabel="Next" }}
+</main>

package/dist/static/site/_includes/leed/docs/charlie/base.hbs

@@ -0,0 +1,27 @@
+{{!--
+    Charlie layout: full-width page whose content column and TOC are centered
+    together, with a centered search header. The footer spans the page below the
+    header scope.
+
+    Partial calls that lead to page content MUST start at column 0 — Handlebars
+    indents a partial's whole output by its call site, which would indent the
+    rendered code blocks.
+--}}
+{{#> leed/docs/shell header="leed/docs/header/top-search" topGrow=true siteFooter=true }}
+{{!-- Main docs container --}}
+<div id="docs-container" class="w-full mx-auto">
+    {{!-- Main 3-column layout --}}
+    <div id="docs-layout" class="flex w-full">
+        {{> leed/docs/sidebar }}
+
+        {{!-- Content area (contains main content and TOC) --}}
+        <div id="docs-content-wrapper">
+{{#if openapi.endpoint}}
+{{> leed/docs/charlie/api }}
+{{else}}
+{{> leed/docs/charlie/documentation }}
+{{/if}}
+        </div>
+    </div>
+</div>
+{{/leed/docs/shell}}

package/dist/static/site/_includes/leed/docs/charlie/documentation.hbs

@@ -0,0 +1,10 @@
+{{> leed/docs/mini-bar toc=true }}
+
+{{!-- Content and TOC are centered as a pair rather than spread across the page --}}
+<div class="flex gap-x-12 justify-center mx-auto w-full max-w-5xl">
+    <main id="documentation" class="docs-main max-w-full">
+{{> leed/docs/doc-article prevLabel="Previous" nextLabel="Next" }}
+    </main>
+
+    {{> leed/docs/toc }}
+</div>

package/dist/static/site/_includes/leed/docs/doc-article.hbs

@@ -0,0 +1,40 @@
+{{!--
+    The body of a documentation page: breadcrumbs, title and rendered content.
+    Shared by every layout theme.
+
+    Params:
+      contentId               id on the content section — bravo names its layout
+                              container `docs-content`, so it passes `content`
+                              here to keep the id unique
+      prevLabel / nextLabel   pagination link text
+      footer                  render the docs footer under the pagination
+--}}
+<nav class="leed-breadcrumbs mb-6">
+    {{{ breadcrumbsNav '<i class="home"></i>' }}}
+</nav>
+
+<section id="leed-docs-copy" class="min-w-0">
+    <h1>{{{ title }}}</h1>
+
+    <article>
+        {{!-- START DOCS CONTENT --}}
+        <section id="{{ default contentId "docs-content" }}" class="mt-8">
+            {{{ process content }}}
+        </section>
+        {{!-- END DOCS CONTENT --}}
+    </article>
+</section>
+
+{{!-- Optional site-supplied call to action, directly above the prev/next links.
+      Documentation pages only — API reference pages have their own
+      `api-page-cta.hbs`, so a site can pitch differently to a reader working
+      through a guide than to one reading an endpoint.
+
+      Direct file-existence check, the same mechanism as `header-includes.hbs`:
+      create `_includes/docs-page-cta.hbs` and it renders, with no CMS setting and
+      no `customTemplates` key. --}}
+{{#if (templateExists "docs-page-cta.hbs") }}
+{{> docs-page-cta }}
+{{/if}}
+
+{{> leed/docs/pagination wrapperClass="mt-auto" prevLabel=prevLabel nextLabel=nextLabel footer=footer }}

package/dist/static/site/_includes/leed/docs/docs-footer.hbs

@@ -0,0 +1,35 @@
+<footer id="docs-footer" class="sm:min-w-87.5 lg:px-0 text-(--site-text-color)" aria-labelledby="footer-heading">
+    <span class="sr-only">Footer</span>
+    {{#if documentationConfiguration.menus.bottom }}
+    <div class="docs-footer-content">
+        {{#isFalsey hideLogo}}
+        <div class="flex shrink-0 mb-3">
+            <a href="/" data-reason="utm_campaign=leed&utm_source=menu&utm_medium={{ docsMenuName "bottom" }}">
+                <span class="sr-only">{{ siteTitle }} Logo</span>
+                <div class="logo-footer sm:w-28 sm:h-10 w-24 h-8"></div>
+            </a>
+        </div>
+        {{/isFalsey}}
+        <div class="docs-footer-menu-container footer-layout-v1 footer-align">
+            {{> leed/menu/builder menuName=(docsMenuName "bottom") }}
+        </div>
+    </div>
+    {{/if}}
+    <div class="docs-footer-bottom-container">
+        <div class="space-y-8 flex-1 flex flex-col footer-align xl:mr-10">
+            {{> leed/docs/social-icons }}
+        </div>
+        <span class="mb-6 mt-0 copyright-text">
+        {{!-- Licensing badge: the same Starter+ gate as the custom footer above,
+                inverted. Removing the badge is what a paid plan buys, so the free
+                tier — and FAIL-CLOSED, any missing or unrecognized tier — shows it. --}}
+        {{#if (hasTier "starter") }}
+            &copy; {{ year }} {{ siteTitle }}. All rights reserved.
+        {{else}}
+            <a href="https://leed.ai" target="_blank" class="mb-6 mt-0 copyright-text">
+                Powered by Leed
+            </a>
+        {{/if}}
+        </span>
+    </div>
+</footer>

package/dist/static/site/_includes/leed/docs/docs-header.hbs

@@ -0,0 +1,59 @@
+{{!--
+    Your documentation header.
+
+    Leed keeps the positioned wrapper (`#docs-header-wrapper`) because the layout
+    is measured against it — documentation.js publishes `--height-header`, which
+    is the top margin of the page body. This partial replaces everything INSIDE
+    that wrapper, so the header's own layout is yours from here down.
+
+    One menu builder, not two: the same `<ul>` is the desktop bar and the mobile
+    drawer, and CSS decides which shape it takes. That keeps a single source of
+    navigation markup so the two cannot drift apart. Navigation comes from the
+    `header` menu, so the CMS owns the structure — do not hand-write links.
+--}}
+<header id="menu-container" class="site-header{{#if wide}} site-header--wide{{/if}}">
+
+  {{!-- Reading progress. Rendered only when a layout passes a target, so a page
+       that has not been scrolled shows nothing. --}}
+  {{#if scrollBarId}}
+  <div class="reading-progress" aria-hidden="true">
+    <div class="reading-progress-bar" data-reading-progress="{{ scrollBarId }}"></div>
+  </div>
+  {{/if}}
+
+  <div class="nav">
+
+    <a href="/" class="logo" aria-label="{{ siteTitle }}, home">
+      {{#isFalsey hideLogo}}
+      <span class="sr-only">{{ siteTitle }}</span>
+      <div class="logo-header"></div>
+      {{/isFalsey}}
+    </a>
+
+    <button type="button" class="menu-btn" data-menu-toggle aria-label="Open menu" aria-expanded="false" aria-controls="site-nav">
+      <i class="fa-solid leed-icon-menu text-xl" aria-hidden="true"></i>
+    </button>
+
+    <div class="nav-right" id="site-nav" data-menu>
+      <nav aria-label="Main">
+        {{> leed/menu/builder menuName="header" menuClass="menu-top" submenuClass="menu-top-submenu" }}
+      </nav>
+
+      {{!-- Documentation only. The trigger sets Alpine state owned by the docs
+           shell, and that shell renders the modal it opens — on a marketing page
+           there is no such scope and no index, so the control would render and
+           do nothing. `compact=true` is the icon-only variant, for a bar that is
+           already carrying menu items and a button. --}}
+      {{#if showDocsSearch}}
+      {{> leed/docs/document-search compact=true }}
+      {{/if}}
+
+      {{!-- Call to action, overridable per surface by passing ctaLabel/ctaHref. --}}
+      {{#if ctaHref}}
+      <a href="{{ ctaHref }}" class="btn btn-primary">{{ ctaLabel }}</a>
+      {{else}}
+      <a href="/" class="btn btn-primary">Get started</a>
+      {{/if}}
+    </div>
+  </div>
+</header>

package/dist/static/site/_includes/leed/docs/document-search-modal.hbs

@@ -0,0 +1,36 @@
+<!-- Fullscreen Dialog -->
+<div x-cloak x-show="headerSearchShow"
+        x-init="$watch('headerSearchShow', value => { if (value) $nextTick(() => $refs.searchInput.focus()) })"
+        {{!-- Bound here rather than on the trigger button: the shell always renders
+              this modal, so Ctrl+K still opens search when a site-supplied header
+              leaves the default trigger out. --}}
+        @keydown.window.ctrl.k.prevent="headerSearchShow = true"
+        class="document-search-modal-wrapper" :aria-hidden="headerSearchShow ? 'false' : 'true'">
+    <div id="document-search-modal">
+        <!-- Backdrop -->
+        <div class="search-modal-backdrop" @click="headerSearchShow = false"></div>
+        <!-- Dialog Content (Fullscreen Box) -->
+        <div class="search-modal-content">
+            <!-- Search Section -->
+            <div class="search-input-container">
+                <i class="search-icon"></i>
+                {{!-- maxlength mirrors MAX_QUERY_LENGTH on /api/search (#329), so a
+                      legitimate reader can never trip the server's cap — including
+                      by pasting. The endpoint enforces it independently. --}}
+                <input x-ref="searchInput"
+                    type="text"
+                    maxlength="256"
+                    placeholder="Type to search..."
+                    class="search-input-field">
+                <span class="search-escape-hint">ESC</span>
+            </div>
+            {{!-- Page-type filter chips for live docs search (#329). Populated by
+                  live-search.js from the index's page types and reconciled against
+                  the endpoint's authoritative facets; stays empty on the Lunr path. --}}
+            <div class="search-filter-chips"></div>
+            <div id="search-results" class="search-results-container">
+                <!-- Search results will be populated by the search client -->
+            </div>
+        </div>
+    </div>
+</div>

package/dist/static/site/_includes/leed/docs/document-search.hbs

@@ -0,0 +1,23 @@
+{{!--
+    The visible search trigger. A site-supplied header (docs-header.hbs) replaces
+    the default header and may include this partial to keep the search button;
+    the Ctrl+K shortcut lives on the modal instead, so it works either way.
+
+    Params:
+      compact   icon-only button, sized to its content instead of filling the
+                row — for a custom header with no room for the full control.
+                Style hook: `#document-search-container.search-compact`.
+--}}
+<div id="document-search-container"{{#if compact}} class="search-compact"{{/if}}>
+    <div id="document-search" @click="headerSearchShow = true">
+        {{!-- The label is hidden below `lg` even in the full control, so the
+              button always needs its own accessible name. --}}
+        <button type="button" class="search-trigger-button" aria-label="Search">
+            <i class="search-icon"></i>
+            {{#unless compact}}
+            <span class="hidden lg:block">Search</span>
+            <span class="search-trigger-shortcut hidden lg:block">Ctrl K</span>
+            {{/unless}}
+        </button>
+    </div>
+</div>

package/dist/static/site/_includes/leed/docs/footer.hbs

@@ -0,0 +1,12 @@
+{{!-- Start Footer Menu --}}
+<div id="docs-footer-wrapper">
+{{!-- Custom footers are Starter+: the free tier always gets the default footer
+      below, so the licensing badge cannot be replaced by overriding it. --}}
+{{#if (and (useCustomTemplate "docsFooter") (hasTier "starter")) }}
+    {{> docs-footer }}
+<!-- Using ejected footer -->
+{{else}}
+    {{> leed/docs/docs-footer }}
+{{/if}}
+</div>
+{{!-- End Footer Menu --}}

package/dist/static/site/_includes/leed/docs/header/brand.hbs

@@ -0,0 +1,19 @@
+{{!-- Mobile menu toggle plus the site logo, shared by every header variant. --}}
+<div id="docs-menu-logo">
+    <div id="docs-mobile-menu-button">
+        <button type="button" @click="topMenuOpen = !topMenuOpen"
+            class="pt-[1px] lg:hidden border-none menu-top-text-colors ring-0"
+            aria-expanded="false" aria-label="Toggle menu">
+            <span class="sr-only" x-text="topMenuOpen ? 'Close menu' : 'Open menu'"></span>
+            {{!-- Open Menu Icon --}}
+            <i x-show="!topMenuOpen" class="text-xl fa-solid leed-icon-menu"></i>
+            {{!-- Close Menu Icon --}}
+            <i x-show="topMenuOpen" class="text-xl fa-solid leed-icon-close"></i>
+        </button>
+    </div>
+    <a href="/" data-reason="utm_campaign=leed&utm_source=menu&utm_medium={{ docsMenuName "top" }}">
+        <span class="sr-only">Site Logo</span>
+        <div class="nav-logo w-28 h-10"></div>
+    </a>
+    <div class="hidden lg:flex gap-x-2"></div>
+</div>

package/dist/static/site/_includes/leed/docs/header/chrome.hbs

@@ -0,0 +1,33 @@
+{{!--
+    Shared header shell: the fixed, measured wrapper that every documentation
+    layout positions its header with, plus the runtime wiring that publishes the
+    header/TOC heights as CSS custom properties.
+
+    The wrapper stays Leed's: each layout theme styles `#docs-header-wrapper`
+    (fixed, top-0, z-index, backdrop) and documentation.js measures it to set
+    `--height-header`, which is the top margin of the page body. A site that
+    supplies `_includes/docs-header.hbs` replaces everything INSIDE the wrapper —
+    the scroll indicator and the default header markup — and owns its own layout
+    from there. See the site-builder handlebars reference for the contract.
+
+    Usage:
+      {{#> leed/docs/header/chrome }\}
+      ...default header contents...
+      {{/leed/docs/header/chrome}\}
+--}}
+<div id="docs-header-wrapper"
+    x-effect="document.documentElement.style.setProperty('--height-header', `${headerHeight}px`);
+        document.documentElement.style.setProperty('--height-toc', `${tocHeight}px`);">
+
+{{#if (and (useCustomTemplate "docsHeader") (hasTier "starter")) }}
+    {{> docs-header }}
+<!-- Using ejected header -->
+{{else}}
+    {{> leed/components/scroll-status-indicator-horizontal }}
+
+    <header id="docs-header-container" class="text-(--site-text-color) ">
+        {{> @partial-block }}
+    </header>
+{{/if}}
+</div>
+{{!-- End Top Menu --}}

package/dist/static/site/_includes/leed/docs/header/compact.hbs

@@ -0,0 +1,19 @@
+{{!--
+    Header with navigation, search and CTA grouped together on one row to the
+    right of the logo. Used by the bravo layout.
+--}}
+{{#> leed/docs/header/chrome }}
+<div id="docs-menu-container">
+    {{> leed/docs/header/brand }}
+
+    <div class="ml-auto flex gap-x-1 md:gap-x-4 lg:gap-x-6">
+        {{> leed/docs/header/nav openClass="absolute left-0 right-0 top-full border-t border-(--docs-header-border-color)/5 bg-(--docs-bg-color) border border-gray-200/70 dark:border-white/[0.07] rounded-t-2xl" }}
+
+        <div class="flex header-search-button">
+            {{> leed/docs/document-search }}
+        </div>
+
+        {{> leed/docs/header/cta wrapperClass="relative flex items-center ml-auto justify-end space-x-4" }}
+    </div>
+</div>
+{{/leed/docs/header/chrome}}

package/dist/static/site/_includes/leed/docs/header/cta.hbs

@@ -0,0 +1,15 @@
+{{!--
+    Optional call-to-action button on the right of the header, configured in the
+    CMS under documentationConfiguration.header.button.
+
+    Params:
+      wrapperClass   layout classes for the outer container
+--}}
+<div class="{{ wrapperClass }}">
+    <div class="docs-header-right-cta">
+        {{#if documentationConfiguration.header.button}}
+        <a class="docs-button-primary" href="{{documentationConfiguration.header.button.href}}"
+            data-reason="utm_campaign=leed&utm_source=menu&utm_medium={{ docsMenuName "top" }}">{{documentationConfiguration.header.button.text}}</a>
+        {{/if}}
+    </div>
+</div>

package/dist/static/site/_includes/leed/docs/header/nav.hbs

@@ -0,0 +1,18 @@
+{{!--
+    Top navigation menu. Collapses into a dropdown below the header on small
+    screens; `openClass` is the theme's styling for that open dropdown state.
+
+    Params:
+      openClass   classes applied to the wrapper while the mobile menu is open
+--}}
+<div id="docs-navigation-button-wrapper"
+    :class="{'{{ openClass }}': topMenuOpen, 'relative flex flex-grow items-center': !topMenuOpen}">
+    <nav id="menu-nav"
+        class="flex-grow whitespace-nowrap text-sm sm:text-base md:border-0 border-(--site-border-color)/5"
+        :class="[
+        isSmallerThanDesktop ? 'menu-vertical w-full border-b-0 py-0 px-4 md:px-8': 'menu-horizontal md:px-0',
+        isSmallerThanDesktop && !topMenuOpen ? 'hidden' : '']"
+        x-show="!isSmallerThanDesktop || topMenuOpen">
+        {{> leed/menu/builder menuName=(docsMenuName "top") }}
+    </nav>
+</div>

package/dist/static/site/_includes/leed/docs/header/top-search.hbs

@@ -0,0 +1,15 @@
+{{!--
+    Header with the search box centered between the logo and the CTA, and the
+    navigation on its own row underneath. Used by the alpha and charlie layouts.
+--}}
+{{#> leed/docs/header/chrome }}
+<div id="docs-menu-container">
+    {{> leed/docs/header/brand }}
+
+    {{> leed/docs/document-search }}
+
+    {{> leed/docs/header/cta wrapperClass="lg:flex-1 relative lg:flex items-center ml-auto justify-end space-x-4" }}
+</div>
+
+{{> leed/docs/header/nav openClass="absolute left-0 right-0 top-full border-y-0 border-(--site-border-color)/5 bg-(--docs-bg-color)" }}
+{{/leed/docs/header/chrome}}

package/dist/static/site/_includes/leed/docs/mini-bar.hbs

@@ -0,0 +1,53 @@
+{{!--
+    Below the `lg` breakpoint the sidebar and the table of contents are reached
+    through this bar. Documentation pages get a "Jump to" TOC dropdown; API
+    pages have no TOC, so they show breadcrumbs instead.
+
+    Params:
+      toc               render the TOC toggle and dropdown (documentation pages)
+      breadcrumbClass   extra classes on the breadcrumbs nav (API pages)
+--}}
+<div id="docs-mini-bar" class="lg:hidden z-[9999]">
+    <div x-data="{ isOpen: false, navOpen: false }" class="relative">
+        <div id="docs-mini-bar-buttons" class="flex w-full items-center">
+            <button id="sidebar-toggle-button"
+                @click="$store.sidebar.open = !$store.sidebar.open"
+                @resize.window.debounce.50ms="isOpen = false;"
+                class="mini-menu lg:hidden"
+                aria-label="Navigation menu"
+                :aria-expanded="$store.sidebar.open ? 'true' : 'false'"
+                aria-controls="docs-sidebar-nav">
+                <i :class="$store.sidebar.open ? 'rotate-90' : ''"></i>
+            </button>
+
+            {{#if toc}}
+            <button @click="isOpen = !isOpen"
+                class="mini-toc"
+                @resize.window.debounce.50ms="isOpen = false;"
+                aria-controls="docs-mini-toc"
+                aria-label="Toggle TOC">
+                {{!-- if this span has no text, the id="toc-heading" text will be put here automatically --}}
+                <span id="leed-mini-toc-button-text">Jump to</span>
+                <i :class="isOpen ? 'rotate-90' : ''"></i>
+            </button>
+
+            <div id="leed-mini-toc-current"></div>
+            {{else}}
+            <nav class="leed-breadcrumbs order-2{{#if breadcrumbClass}} {{ breadcrumbClass }}{{/if}}">
+                {{{ breadcrumbsNav '<i class="home"></i>' }}}
+            </nav>
+            {{/if}}
+        </div>
+
+        {{#if toc}}
+        <div id="docs-mini-toc"
+            class="max-h-[50vh] overflow-y-auto"
+            x-show="isOpen"
+            @click.away="isOpen = false">
+            <div id="leed-mobile-toc-container" @click="isOpen = false" class="w-full">
+                {{!-- TOC will be moved here via JavaScript  --}}
+            </div>
+        </div>
+        {{/if}}
+    </div>
+</div>

package/dist/static/site/_includes/leed/docs/pagination.hbs

@@ -0,0 +1,19 @@
+{{!--
+    Previous/next page links, optionally followed by the docs footer for themes
+    that keep the footer inside the content column.
+
+    Params:
+      wrapperClass   layout classes for the outer container
+      prevLabel      text for the previous link (themes use "" or "Previous")
+      nextLabel      text for the next link
+      footer         render the docs footer under the links
+--}}
+<div class="{{ wrapperClass }}">
+    <nav id="docs-pagination" class="mt-8">
+        {{{ previousPageNav (default prevLabel "") }}}
+        {{{ nextPageNav (default nextLabel "") }}}
+    </nav>
+    {{#if footer}}
+    {{> leed/docs/footer hideLogo=true }}
+    {{/if}}
+</div>

package/dist/static/site/_includes/leed/docs/shell.hbs

@@ -0,0 +1,56 @@
+{{!--
+    The complete documentation page: every tag this file opens, it also closes.
+    Layout themes (alpha/bravo/charlie) supply only their own containers as the
+    block body and never see the <html>/<body>/header scope.
+
+    Params:
+      header      partial name for the top header
+                  ("leed/docs/header/top-search" | "leed/docs/header/compact")
+      topGrow     put `grow` on the header scope wrapper
+      bodyGrow    put `grow` on the body content wrapper
+      siteFooter  render the docs footer at body level, outside the header scope
+
+    Usage:
+      {{#> leed/docs/shell header="leed/docs/header/top-search" }\}
+      ...containers...
+      {{/leed/docs/shell}\}
+
+    DO NOT INDENT `{{> @partial-block }\}`. Handlebars indents a partial's entire
+    output by the indentation of its call site, which would indent the rendered
+    <pre><code> blocks and break code rendering.
+--}}
+<!DOCTYPE html>
+<html lang="en" class="scroll-smooth js-focus-visible leed-documentation {{ leedConfiguredCSS }}">
+
+<head>
+    <title>{{ title }} | {{ siteTitle }}</title>
+
+    <meta name="viewport" content="width=device-width">
+
+    {{> leed/head }}
+</head>
+
+<body x-data class="flex flex-col h-screen antialiased">
+    <div {{#if topGrow }}class="grow"{{/if}}
+        x-data="documentationHeaderComponent({scrollBarId: 'documentation'})"
+        @resize.window.debounce.50ms="handleResize();"
+        @keydown.escape.window="headerSearchShow = false">
+
+        {{> (lookup . "header") }}
+
+        {{!-- Top margin is applied at runtime because it tracks the header height --}}
+        <div class="{{#if bodyGrow }}grow {{/if}}mt-(--height-header)">
+{{!-- START BODY CONTENT --}}
+{{> @partial-block }}
+{{!-- END BODY CONTENT --}}
+        </div>
+
+        {{!-- Lives at the end of the header scope so every trigger shares one modal --}}
+        {{> leed/docs/document-search-modal }}
+    </div>
+
+{{#if siteFooter }}
+    {{> leed/docs/footer }}
+{{/if}}
+</body>
+</html>