@repobit/dex-system-design 0.23.15 → 0.23.16

package/src/components/anchor/anchor-nav.js

@@ -1,15 +1,13 @@
-import { LitElement, html, nothing } from "lit";
+import { LitElement, html, nothing } from "lit";
 import { tokens } from "../../tokens/tokens.js";
 import { anchorNavStyles } from "./anchor-nav.css.js";
 
-/** Parse token length from computed style (e.g. `8rem` → px). */
 function parseLengthToPx(value) {
   const s = (value || "").trim();
   if (!s) return 0;
   if (s.endsWith("px")) return parseFloat(s);
   if (s.endsWith("rem")) {
-    const root =
-      parseFloat(getComputedStyle(document.documentElement).fontSize) || 16;
+    const root = parseFloat(getComputedStyle(document.documentElement).fontSize) || 16;
     return parseFloat(s) * root;
   }
   return parseFloat(s) || 0;
@@ -20,45 +18,41 @@ class BdAnchorNavItem extends HTMLElement {
     super();
     this.attachShadow({ mode: "open" });
   }
-
-  connectedCallback() {
-    this.render();
-  }
-
-  render() {
-    this.shadowRoot.innerHTML = `<slot></slot>`;
-  }
+  connectedCallback() { this.render(); }
+  render() { this.shadowRoot.innerHTML = `<slot></slot>`; }
 }
 
 class BdAnchorNav extends LitElement {
   static properties = {
     activeId          : { type: String, state: true },
-    /** Landmark label for the outer `<nav>` (screen readers). */
     navLabel          : { type: String, attribute: "aria-label" },
-    /** Mobile dropdown open state */
     _dropdownOpen     : { type: Boolean, state: true },
-    /** Mobile: show Buy now only after first anchor section has been scrolled past */
-    _mobileCtaRevealed: { type: Boolean, state: true }
+    _mobileCtaRevealed: { type: Boolean, state: true },
+    ctaLabel          : { type: String, attribute: "cta-label" },
+    ctaHref           : { type: String, attribute: "cta-href" },
+    items             : { type: Array }
   };
 
   static styles = [tokens, anchorNavStyles];
 
   constructor() {
     super();
-    this.activeId = "";
-    this.navLabel = "Section navigation";
-    this._dropdownOpen = false;
-    this._mobileCtaRevealed = false;
-    this._panelId = `bd-anchor-nav-panel-${Math.random().toString(36)
+    this.activeId                    = "";
+    this.navLabel                    = "Section navigation";
+    this._dropdownOpen               = false;
+    this._mobileCtaRevealed          = false;
+    this.ctaLabel                    = "Buy now";
+    this.ctaHref                     = "";
+    this.items                       = null;
+    this._panelId                    = `bd-anchor-nav-panel-${Math.random().toString(36)
       .slice(2, 11)}`;
-    this._onScrollSpy = this._onScrollSpy.bind(this);
-    this._onDocumentPointerDown = this._onDocumentPointerDown.bind(this);
-    this._onKeydown = this._onKeydown.bind(this);
-    this._scrollPending = false;
-    /** While set, scrollspy must not overwrite activeId during smooth scroll to a clicked section */
+    this._onScrollSpy                = this._onScrollSpy.bind(this);
+    this._onDocumentPointerDown      = this._onDocumentPointerDown.bind(this);
+    this._onKeydown                  = this._onKeydown.bind(this);
+    this._scrollPending              = false;
     this._programmaticScrollTargetId = null;
-    this._unlockScrollSpyTimer = null;
-    this._scrollEndUnlockHandler = null;
+    this._unlockScrollSpyTimer       = null;
+    this._scrollEndUnlockHandler     = null;
   }
 
   connectedCallback() {
@@ -90,7 +84,6 @@ class BdAnchorNav extends LitElement {
     }
   }
 
-  /** After in-nav navigation, ignore scrollspy until scroll finishes (avoids flashing 2→3→4). */
   _scheduleScrollSpyUnlock() {
     this._cancelScrollSpyUnlock();
     const onScrollEnd = () => {
@@ -99,7 +92,7 @@ class BdAnchorNav extends LitElement {
         this._unlockScrollSpyTimer = null;
       }
       window.removeEventListener("scrollend", onScrollEnd);
-      this._scrollEndUnlockHandler = null;
+      this._scrollEndUnlockHandler     = null;
       this._programmaticScrollTargetId = null;
       this._runScrollSpy();
     };
@@ -142,48 +135,58 @@ class BdAnchorNav extends LitElement {
     });
   }
 
+  _resolvedItems() {
+    if (this.items && this.items.length) {
+      return this.items.map((item, i) => ({
+        title: item.title,
+        href : item.href || `#anchor-${i + 1}-section`,
+        id   : `anchor-${i + 1}`
+      }));
+    }
+    return Array.from(this.children)
+      .filter((el) => el.tagName === "BD-ANCHOR-NAV-ITEM")
+      .map((el, i) => ({
+        title: el.getAttribute("title"),
+        href : el.getAttribute("href") || `#anchor-${i + 1}-section`,
+        id   : `anchor-${i + 1}`
+      }));
+  }
+
   _runScrollSpy() {
-    const count = this._navItemCount();
-    let next = this.activeId;
+    const resolved = this._resolvedItems();
+    const count    = resolved.length;
+    let next       = this.activeId;
+
     if (count && !this._programmaticScrollTargetId) {
       const y = window.scrollY + this._stickyOffsetPx() + 2;
       next = "anchor-1";
       for (let i = 0; i < count; i++) {
-        const el = document.getElementById(`anchor-${i + 1}-section`);
+        const sectionId = resolved[i].href.replace(/^#/, "") || `anchor-${i + 1}-section`;
+        const el        = document.getElementById(sectionId);
         if (!el) continue;
         const top = el.getBoundingClientRect().top + window.scrollY;
         if (top <= y) next = `anchor-${i + 1}`;
       }
     }
 
-    const isMobile = window.matchMedia("(max-width: 768px)").matches;
-    const first = document.getElementById("anchor-1-section");
+    const isMobile  = window.matchMedia("(max-width: 768px)").matches;
+    const firstHref = resolved[0]?.href.replace(/^#/, "") || "anchor-1-section";
+    const first     = document.getElementById(firstHref);
     let nextCta;
-    if (!isMobile) {
-      nextCta = true;
-    } else if (!first) {
-      nextCta = true;
-    } else {
-      /* Show only while first section is fully scrolled past; hide again when it scrolls back into view */
-      nextCta = first.getBoundingClientRect().bottom <= 0;
-    }
+    if (!isMobile)   nextCta = true;
+    else if (!first) nextCta = true;
+    else             nextCta = first.getBoundingClientRect().bottom <= 0;
 
     if (this.activeId !== next || this._mobileCtaRevealed !== nextCta) {
-      this.activeId = next;
+      this.activeId           = next;
       this._mobileCtaRevealed = nextCta;
       this.requestUpdate();
     }
   }
 
-  _navItemCount() {
-    return Array.from(this.children).filter(
-      (el) => el.tagName === "BD-ANCHOR-NAV-ITEM"
-    ).length;
-  }
-
   firstUpdated() {
-    const n = this._navItemCount();
-    if (n) {
+    const resolved = this._resolvedItems();
+    if (resolved.length) {
       this.activeId = "anchor-1";
       this.requestUpdate();
     }
@@ -199,7 +202,6 @@ class BdAnchorNav extends LitElement {
     queueMicrotask(() => this._playMobileDropdownLabelSwap());
   }
 
-  /** Mobile dropdown title: subtle fade + slide when scrollspy (or tap) changes section. */
   _playMobileDropdownLabelSwap() {
     if (typeof window === "undefined") return;
     if (window.matchMedia("(prefers-reduced-motion: reduce)").matches) return;
@@ -216,15 +218,11 @@ class BdAnchorNav extends LitElement {
     );
   }
 
-  /**
-   * Scroll clearance = actual sticky bar height + small inset (not a fixed 128px token).
-   * Matches best practice: target headings sit just under the bar, not with extra dead space.
-   */
   _stickyOffsetPx() {
-    const barPx = this.offsetHeight;
+    const barPx    = this.offsetHeight;
     const insetRaw = getComputedStyle(this).getPropertyValue("--spacing-8")
       .trim();
-    const insetPx = parseLengthToPx(insetRaw) || 8;
+    const insetPx  = parseLengthToPx(insetRaw) || 8;
     if (barPx > 0) return barPx + insetPx;
     const fallback = getComputedStyle(this).getPropertyValue("--spacing-128")
       .trim();
@@ -235,33 +233,28 @@ class BdAnchorNav extends LitElement {
     if (event?.preventDefault) event.preventDefault();
     const el = getTarget();
     if (!el) return;
-    const offset = this._stickyOffsetPx();
-    const rect = el.getBoundingClientRect();
-    const scrollTop = window.scrollY ?? window.pageYOffset;
-    const elementY = rect.top + scrollTop;
-    const prefersReduced =
-      typeof window !== "undefined" &&
+    const offset         = this._stickyOffsetPx();
+    const rect           = el.getBoundingClientRect();
+    const scrollTop      = window.scrollY ?? window.pageYOffset;
+    const elementY       = rect.top + scrollTop;
+    const prefersReduced = typeof window !== "undefined" &&
       window.matchMedia("(prefers-reduced-motion: reduce)").matches;
-    window.scrollTo({
-      top     : elementY - offset,
-      behavior: prefersReduced ? "auto" : "smooth"
-    });
+    window.scrollTo({ top: elementY - offset, behavior: prefersReduced ? "auto" : "smooth" });
   }
 
-  handleClick(event, id) {
+  handleClick(event, id, href) {
     event.preventDefault();
     this._cancelScrollSpyUnlock();
     this._programmaticScrollTargetId = id;
-    this.activeId = id;
-
-    const sectionEl = document.getElementById(`${id}-section`);
+    this.activeId                    = id;
+    const sectionId = (href || "").replace(/^#/, "") || `${id}-section`;
+    const sectionEl = document.getElementById(sectionId);
     if (sectionEl) {
       this._scrollToY(event, () => sectionEl);
       this._scheduleScrollSpyUnlock();
     } else {
       this._programmaticScrollTargetId = null;
     }
-
     this.requestUpdate();
   }
 
@@ -272,49 +265,39 @@ class BdAnchorNav extends LitElement {
     this.requestUpdate();
   }
 
-  _selectFromDropdown(e, id) {
-    this.handleClick(e, id);
+  _selectFromDropdown(e, id, href) {
+    this.handleClick(e, id, href);
     this._dropdownOpen = false;
     this.requestUpdate();
   }
 
-  scrollToPricing(event) {
-    this._scrollToY(event, () => document.getElementById("section-pricing"));
-  }
-
-  _activeLabel(items) {
-    const m = /^anchor-(\d+)$/.exec(this.activeId || "");
-    const n = m ? parseInt(m[1], 10) : 1;
-    const idx = Math.min(Math.max(n - 1, 0), Math.max(0, items.length - 1));
-    return items[idx]?.getAttribute("title") || items[0]?.getAttribute("title") || "Section";
+  _activeLabel(resolved) {
+    const m   = /^anchor-(\d+)$/.exec(this.activeId || "");
+    const n   = m ? parseInt(m[1], 10) : 1;
+    const idx = Math.min(Math.max(n - 1, 0), Math.max(0, resolved.length - 1));
+    return resolved[idx]?.title || resolved[0]?.title || "Section";
   }
 
   render() {
-    const items = Array.from(this.children).filter(
-      (el) => el.tagName === "BD-ANCHOR-NAV-ITEM"
-    );
+    const resolved      = this._resolvedItems();
+    const dropdownLabel = this._activeLabel(resolved);
 
     const linkRow = (cls) => html`
       <div class="${cls}">
-        ${items.map((item, index) => {
-          const id = `anchor-${index + 1}`;
+        ${resolved.map(({ id, title, href }) => {
           const isActive = this.activeId === id;
           return html`
             <a
-              href="#${id}-section"
+              href="${href}"
               class="${isActive ? "active" : ""}"
               aria-current=${isActive ? "true" : nothing}
-              @click=${(e) => this.handleClick(e, id)}
-            >
-              ${item.getAttribute("title")}
-            </a>
+              @click=${(e) => this.handleClick(e, id, href)}
+            >${title}</a>
           `;
         })}
       </div>
     `;
 
-    const dropdownLabel = this._activeLabel(items);
-
     return html`
       <nav aria-label=${this.navLabel}>
         <div
@@ -336,13 +319,7 @@ class BdAnchorNav extends LitElement {
               <span class="bd-anchor-nav__dropdown-label">${dropdownLabel}</span>
               <span class="bd-anchor-nav__dropdown-chevron" aria-hidden="true">
                 <svg width="20" height="20" viewBox="0 0 20 20" fill="none">
-                  <path
-                    d="M5 8l5 5 5-5"
-                    stroke="currentColor"
-                    stroke-width="2"
-                    stroke-linecap="round"
-                    stroke-linejoin="round"
-                  />
+                  <path d="M5 8l5 5 5-5" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>
                 </svg>
               </span>
             </button>
@@ -354,22 +331,17 @@ class BdAnchorNav extends LitElement {
               ?hidden=${!this._dropdownOpen}
             >
               <ul class="bd-anchor-nav__dropdown-list" role="presentation">
-                ${items.map((item, index) => {
-                  const id = `anchor-${index + 1}`;
+                ${resolved.map(({ id, title, href }) => {
                   const isActive = this.activeId === id;
                   return html`
                     <li role="presentation">
                       <button
                         type="button"
                         role="option"
-                        class="bd-anchor-nav__dropdown-option ${isActive
-                          ? "bd-anchor-nav__dropdown-option--active"
-                          : ""}"
+                        class="bd-anchor-nav__dropdown-option ${isActive ? "bd-anchor-nav__dropdown-option--active" : ""}"
                         aria-selected=${isActive ? "true" : "false"}
-                        @click=${(e) => this._selectFromDropdown(e, id)}
-                      >
-                        ${item.getAttribute("title")}
-                      </button>
+                        @click=${(e) => this._selectFromDropdown(e, id, href)}
+                      >${title}</button>
                     </li>
                   `;
                 })}
@@ -378,14 +350,11 @@ class BdAnchorNav extends LitElement {
           </div>
 
           <div class="bd-cta">
-            <button
-              type="button"
+            <a
               class="bd-anchor-nav__cta"
+              href="${this.ctaHref || "#section-pricing"}"
               part="buy-button"
-              @click=${(e) => this.scrollToPricing(e)}
-            >
-              Buy now
-            </button>
+            >${this.ctaLabel}</a>
           </div>
         </div>
       </nav>