@reliability-design/web 1.0.6 → 1.2.0

package/dist/components/rel-topbar/rel-topbar.ts

@@ -0,0 +1,438 @@
+import { LitElement, html, css } from "lit";
+import { customElement, property, state } from "lit/decorators.js";
+import "../../styles/vars-v2.css";
+import "@reliability-design/icons/rel-icon";
+import "./rel-topbar-brand";
+import "./rel-topbar-actions";
+import "./rel-topbar-utilities";
+import "./rel-topbar-mobile-panel";
+import "./rel-topbar-dropdown";
+import "./rel-topbar-dropdown-item";
+
+export type TopbarVariant = "customer" | "carrier";
+export type TopbarForceLayout = "auto" | "desktop" | "tablet" | "mobile";
+
+/**
+ * `rel-topbar` — Application-level top navigation / header shell.
+ *
+ * Slots:
+ *   brand        — Logo / wordmark region (left)
+ *   (default)    — Primary nav items (rel-topbar-item elements)
+ *   actions      — CTA / action buttons (customer) or dark-pill area (carrier)
+ *   utilities    — Utility icon buttons (notifications, search, etc.)
+ *   profile      — rel-topbar-profile tile
+ *   mobile-panel — Collapsed nav panel shown when mobileOpen is true
+ *
+ * Events:
+ *   rel-menu-toggle        — fired when hamburger is clicked  { open: boolean }
+ *   rel-mobile-open-change — alias of rel-menu-toggle for convenience
+ *   rel-nav-select         — bubbled from child rel-topbar-item  { value, label }
+ */
+@customElement("rel-topbar")
+export class RelTopbar extends LitElement {
+  /** Visual variant — affects action/profile region styling */
+  @property({ type: String, reflect: true }) variant: TopbarVariant = "customer";
+
+  /** Whether the mobile nav panel is currently open */
+  @property({ type: Boolean, reflect: true }) mobileOpen = false;
+
+  /** Whether to render the hamburger / close toggle button */
+  @property({ type: Boolean, reflect: true }) showMenuToggle = false;
+
+  /** Reduce height to compact (48 px) mode */
+  @property({ type: Boolean, reflect: true }) compact = false;
+
+  /** Stick topbar to top of viewport while scrolling */
+  @property({ type: Boolean, reflect: true }) sticky = false;
+
+  /**
+   * Override the responsive layout for demos / storybook.
+   * 'auto' respects CSS media queries.
+   */
+  @property({ type: String }) forceLayout: TopbarForceLayout = "auto";
+
+  private _overflowItems: Element[] = [];
+  @state() private _overflowCount: number = 0;
+  @state() private _overflowItemsData: Array<{ label: string; href: string; disabled: boolean }> = [];
+  private _resizeObserver?: ResizeObserver;
+  private _resizeTimer?: number;
+  private _measuring = false;
+  private _lastNavWidth = 0;
+
+  static styles = css`
+    /* ─── Component tokens ─────────────────────────────────────────── */
+    :host {
+      --rel-topbar-height: 64px;
+      --rel-topbar-height-compact: 48px;
+      --rel-topbar-bg: var(--rel-color-bg-primary);
+      --rel-topbar-border-color: var(--rel-border-default, #ddd);
+      --rel-topbar-item-color: var(--rel-color-text-primary);
+      --rel-topbar-item-active-color: var(--rel-colors-green-tertiary, #00a86b);
+      --rel-topbar-item-active-indicator: var(--rel-colors-green-primary, #00f49c);
+      --rel-topbar-item-hover-bg: var(--rel-color-bg-secondary);
+      --rel-topbar-divider-color: var(--rel-border-divider, #bdbdbd);
+      --rel-topbar-carrier-action-bg: var(--rel-color-text-primary);
+      --rel-topbar-carrier-action-color: var(--rel-color-bg-primary);
+      --rel-topbar-z: 100;
+
+      display: block;
+      width: 100%;
+      font-family: var(--rel-fontFamilies-primary, Poppins, sans-serif);
+    }
+
+    /* ─── Sticky host ───────────────────────────────────────────────── */
+    :host([sticky]) {
+      position: sticky;
+      top: 0;
+      z-index: var(--rel-topbar-z);
+    }
+
+    /* ─── Bar shell ─────────────────────────────────────────────────── */
+    .topbar {
+      display: flex;
+      align-items: center;
+      height: var(--rel-topbar-height);
+      background: var(--rel-topbar-bg);
+      border-bottom: var(--rel-borders-width-stroke-100, 1px) solid var(--rel-topbar-border-color);
+      padding: 0 var(--rel-spacing-space-xl, 24px);
+      box-sizing: border-box;
+      gap: var(--rel-spacing-space-md, 16px);
+    }
+
+    :host([compact]) .topbar {
+      height: var(--rel-topbar-height-compact);
+    }
+
+    /* ─── Brand ─────────────────────────────────────────────────────── */
+    .brand-region {
+      display: flex;
+      align-items: center;
+      flex-shrink: 0;
+    }
+
+    /* ─── Nav (primary, desktop) ────────────────────────────────────── */
+    .nav-region {
+      display: flex;
+      align-items: center;
+      flex: 1 1 0;
+      gap: var(--rel-spacing-space-2xs, 4px);
+      min-width: 0;
+    }
+
+    /* ─── Right side cluster ────────────────────────────────────────── */
+    .right-region {
+      display: flex;
+      align-items: center;
+      flex-shrink: 0;
+      margin-left: auto;
+      gap: var(--rel-spacing-space-xs, 8px);
+    }
+
+    .actions-region,
+    .utilities-region,
+    .profile-region {
+      display: contents;
+    }
+
+    /* Vertical divider between util/profile when both are populated */
+    .divider {
+      width: var(--rel-borders-width-stroke-100, 1px);
+      height: 24px;
+      background: var(--rel-topbar-divider-color);
+      flex-shrink: 0;
+    }
+
+    /* ─── Carrier action pill wrapper ───────────────────────────────── */
+    :host([variant="carrier"]) .actions-region ::slotted(*) {
+      display: flex;
+      align-items: center;
+      gap: var(--rel-spacing-space-xs, 8px);
+      background: var(--rel-topbar-carrier-action-bg);
+      color: var(--rel-topbar-carrier-action-color);
+      padding: var(--rel-spacing-space-2xs, 4px) var(--rel-spacing-space-sm, 12px);
+      border-radius: var(--rel-borders-radius-border-radius-500, 1000px);
+    }
+
+    /* ─── Mobile toggle button ──────────────────────────────────────── */
+    .menu-toggle {
+      display: none;
+      align-items: center;
+      justify-content: center;
+      width: 40px;
+      height: 40px;
+      padding: 0;
+      border: none;
+      background: transparent;
+      border-radius: var(--rel-borders-radius-border-radius-200, 8px);
+      cursor: pointer;
+      color: var(--rel-topbar-item-color);
+      flex-shrink: 0;
+    }
+
+    .menu-toggle:focus-visible {
+      outline: 2px solid var(--rel-topbar-item-active-indicator);
+      outline-offset: 2px;
+    }
+
+    .menu-toggle:hover {
+      background: var(--rel-topbar-item-hover-bg);
+    }
+
+    .menu-toggle svg {
+      display: block;
+    }
+
+    /* ─── Mobile panel ──────────────────────────────────────────────── */
+    .mobile-panel {
+      display: none;
+      background: var(--rel-topbar-bg);
+      border-bottom: var(--rel-borders-width-stroke-100, 1px) solid var(--rel-topbar-border-color);
+    }
+
+    .mobile-panel.open {
+      display: block;
+    }
+
+    .mobile-overflow-nav {
+      display: flex;
+      flex-direction: column;
+      padding: var(--rel-spacing-space-xs, 8px) 0;
+      border-top: 1px solid var(--rel-topbar-border-color);
+    }
+
+    .mobile-overflow-item {
+      display: block;
+      padding: var(--rel-spacing-space-xs, 8px) var(--rel-spacing-space-xl, 24px);
+      color: var(--rel-topbar-item-color);
+      font-family: var(--rel-fontFamilies-primary, Poppins, sans-serif);
+      font-size: var(--rel-fontSizes-md, 14px);
+      font-weight: var(--rel-fontWeights-medium, 500);
+      text-decoration: none;
+    }
+
+    .mobile-overflow-item:hover {
+      background: var(--rel-topbar-item-hover-bg);
+    }
+
+    .mobile-overflow-item.disabled {
+      opacity: 0.45;
+      pointer-events: none;
+    }
+
+    /* ─── Responsive: auto mode (CSS media queries) ─────────────────── */
+    @media (max-width: 768px) {
+      .topbar:not(.force-desktop) .nav-region {
+        display: none;
+      }
+
+      .topbar:not(.force-desktop) .menu-toggle {
+        display: flex;
+      }
+    }
+
+    @media (min-width: 769px) {
+      .topbar:not(.force-mobile):not(.force-tablet) .menu-toggle {
+        display: none;
+      }
+    }
+
+    /* ─── forceLayout overrides ─────────────────────────────────────── */
+    .topbar.force-mobile .nav-region,
+    .topbar.force-tablet .nav-region {
+      display: none;
+    }
+
+    .topbar.force-mobile .menu-toggle,
+    .topbar.force-tablet .menu-toggle {
+      display: flex;
+    }
+
+    .topbar.force-desktop .nav-region {
+      display: flex;
+    }
+
+    .topbar.force-desktop .menu-toggle {
+      display: none;
+    }
+  `;
+
+  override firstUpdated() {
+    const navRegion = this.renderRoot.querySelector(".nav-region") as HTMLElement;
+    if (navRegion) {
+      this._resizeObserver = new ResizeObserver(() => {
+        clearTimeout(this._resizeTimer);
+        this._resizeTimer = window.setTimeout(() => this._measureNav(), 150);
+      });
+      this._resizeObserver.observe(navRegion);
+    }
+    requestAnimationFrame(() => this._measureNav());
+  }
+
+  override disconnectedCallback() {
+    super.disconnectedCallback();
+    this._resizeObserver?.disconnect();
+    clearTimeout(this._resizeTimer);
+  }
+
+  private _measureNav() {
+    if (this._measuring) return;
+    this._measuring = true;
+    const navRegion = this.renderRoot.querySelector(".nav-region") as HTMLElement;
+    if (!navRegion) return;
+    const navSlot = this.renderRoot.querySelector('slot[name="nav"]') as HTMLSlotElement;
+    if (!navSlot) return;
+    const items = Array.from(navSlot.assignedElements()).filter(
+      el => el.tagName.toLowerCase() !== "rel-topbar-item" || !el.hasAttribute("data-more")
+    );
+    const navWidth = navRegion.getBoundingClientRect().width;
+    if (Math.abs(navWidth - this._lastNavWidth) < 2) return;
+    this._lastNavWidth = navWidth;
+    const available = navWidth - 120;
+
+    let accumulated = 0;
+    let firstOverflowIndex = items.length;
+    for (let i = 0; i < items.length; i++) {
+      accumulated += items[i].getBoundingClientRect().width;
+      if (accumulated > available) {
+        firstOverflowIndex = i;
+        break;
+      }
+    }
+
+    const overflowingElements = Array.from(items).slice(firstOverflowIndex);
+    this._overflowItems = overflowingElements;
+    this._overflowCount = overflowingElements.length;
+    this._overflowItemsData = overflowingElements.map(el => ({
+      label: el.getAttribute("label") ?? "",
+      href: el.getAttribute("href") ?? "",
+      disabled: el.hasAttribute("disabled"),
+    }));
+
+    for (const el of items) {
+      if (overflowingElements.includes(el)) {
+        el.setAttribute("hidden", "");
+      } else {
+        el.removeAttribute("hidden");
+      }
+    }
+
+    this._measuring = false;
+  }
+
+  private onRouterSlotChange(e: Event) {
+    const slot = e.target as HTMLSlotElement;
+    for (const el of slot.assignedElements({ flatten: true })) {
+      const tag = (el as HTMLElement).tagName.toLowerCase();
+      const targetSlot =
+        tag === "rel-topbar-brand" ? "brand" :
+        tag === "rel-topbar-actions" ? "actions" :
+        tag === "rel-topbar-utilities" ? "utilities" :
+        tag === "rel-topbar-profile" ? "profile" :
+        tag === "rel-topbar-mobile-panel" ? "mobile-panel" :
+        "nav";
+      if ((el as HTMLElement).slot !== targetSlot) {
+        (el as HTMLElement).slot = targetSlot;
+      }
+    }
+  }
+
+  private get layoutClass(): string {
+    if (this.forceLayout === "auto") return "";
+    return `force-${this.forceLayout}`;
+  }
+
+  private handleMenuToggle() {
+    this.mobileOpen = !this.mobileOpen;
+    const detail = { open: this.mobileOpen };
+    this.dispatchEvent(
+      new CustomEvent("rel-menu-toggle", { detail, bubbles: true, composed: true })
+    );
+    this.dispatchEvent(
+      new CustomEvent("rel-mobile-open-change", { detail, bubbles: true, composed: true })
+    );
+  }
+
+  render() {
+    const topbarClass = ["topbar", this.layoutClass].filter(Boolean).join(" ");
+    const menuLabel = this.mobileOpen ? "Close menu" : "Open menu";
+
+    return html`
+      <!-- router: auto-assigns slot names by tagName; stays empty after redistribution -->
+      <slot style="display:none" @slotchange=${this.onRouterSlotChange}></slot>
+
+      <header>
+        <div class=${topbarClass} role="banner">
+          <div class="brand-region">
+            <slot name="brand"></slot>
+          </div>
+
+          <nav class="nav-region" aria-label="Primary">
+            <slot name="nav" @slotchange=${this._measureNav}></slot>
+            ${this._overflowCount > 0 ? html`
+              <rel-topbar-item label="More" expandable data-more>
+                <rel-topbar-dropdown slot="dropdown">
+                  ${this._overflowItemsData.map(item => html`
+                    <rel-topbar-dropdown-item
+                      label=${item.label}
+                      href=${item.href}
+                      ?disabled=${item.disabled}
+                    ></rel-topbar-dropdown-item>
+                  `)}
+                </rel-topbar-dropdown>
+              </rel-topbar-item>
+            ` : null}
+          </nav>
+
+          <div class="right-region">
+            <div class="actions-region">
+              <slot name="actions"></slot>
+            </div>
+            <div class="utilities-region">
+              <slot name="utilities"></slot>
+            </div>
+            <div class="profile-region">
+              <slot name="profile"></slot>
+            </div>
+
+            ${this.showMenuToggle
+              ? html`
+                  <button
+                    class="menu-toggle"
+                    aria-label=${menuLabel}
+                    aria-expanded=${this.mobileOpen}
+                    aria-controls="mobile-panel"
+                    @click=${this.handleMenuToggle}
+                  >
+                    ${this.mobileOpen
+                      ? html`<rel-icon name="close" size="md"></rel-icon>`
+                      : html`<rel-icon name="hamburger" size="md"></rel-icon>`}
+                  </button>
+                `
+              : null}
+          </div>
+        </div>
+      </header>
+
+      <div
+        class="mobile-panel ${this.mobileOpen ? "open" : ""}"
+        id="mobile-panel"
+        role="region"
+        aria-label="Mobile navigation"
+      >
+        <slot name="mobile-panel"></slot>
+        ${this._overflowItemsData.length > 0 ? html`
+          <div class="mobile-overflow-nav">
+            ${this._overflowItemsData.map(item => html`
+              <a
+                class="mobile-overflow-item ${item.disabled ? "disabled" : ""}"
+                href=${item.href}
+                ?aria-disabled=${item.disabled}
+              >${item.label}</a>
+            `)}
+          </div>
+        ` : null}
+      </div>
+    `;
+  }
+}
+