@reliability-design/web 1.4.3 → 1.4.5

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

@@ -1,446 +1,446 @@
-import { LitElement, html, css } from "lit";
-import { customElement, property, state } from "lit/decorators.js";
-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.
- *
- * @deprecated This component's fixed slot structure, hardcoded breakpoint,
- * and built-in overflow logic are too rigid for most real layouts. Use the
- * "App Topbar" recipe at /docs/recipes/app-topbar instead, composed from
- * rel-menu/rel-popover, rel-drawer, and rel-button. Still supported, but
- * will be removed in a future major version.
- *
- * 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 {
-      color: var(--rel-text-default);
-      --rel-topbar-height: 64px;
-      --rel-topbar-height-compact: 48px;
-      --rel-topbar-bg: var(--rel-bg-surface);
-      --rel-topbar-border-color: var(--rel-border-default);
-      --rel-topbar-item-color: var(--rel-text-default);
-      --rel-topbar-item-active-color: var(--rel-text-success);
-      --rel-topbar-item-active-indicator: var(--rel-bg-brand);
-      --rel-topbar-item-hover-bg: var(--rel-bg-surface-elevated);
-      --rel-topbar-divider-color: var(--rel-border-default);
-      --rel-topbar-carrier-action-bg: var(--rel-text-default);
-      --rel-topbar-carrier-action-color: var(--rel-bg-surface);
-      --rel-topbar-z: 100;
-
-      display: block;
-      width: 100%;
-      font-family: var(--rel-fonts-font-family, 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-stroke-sm, 1px) solid var(--rel-topbar-border-color);
-      padding: 0 var(--rel-spacing-xl, 24px);
-      box-sizing: border-box;
-      gap: var(--rel-spacing-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-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-xs, 8px);
-    }
-
-    .actions-region,
-    .utilities-region,
-    .profile-region {
-      display: contents;
-    }
-
-    /* Vertical divider between util/profile when both are populated */
-    .divider {
-      width: var(--rel-stroke-sm, 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-xs, 8px);
-      background: var(--rel-topbar-carrier-action-bg);
-      color: var(--rel-topbar-carrier-action-color);
-      padding: var(--rel-spacing-2xs, 4px) var(--rel-spacing-sm, 12px);
-      border-radius: var(--rel-border-radius-full-rounded, 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-border-radius-sm, 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-stroke-sm, 1px) solid var(--rel-topbar-border-color);
-    }
-
-    .mobile-panel.open {
-      display: block;
-    }
-
-    .mobile-overflow-nav {
-      display: flex;
-      flex-direction: column;
-      padding: var(--rel-spacing-xs, 8px) 0;
-      border-top: 1px solid var(--rel-topbar-border-color);
-    }
-
-    .mobile-overflow-item {
-      display: block;
-      padding: var(--rel-spacing-xs, 8px) var(--rel-spacing-xl, 24px);
-      color: var(--rel-topbar-item-color);
+import { LitElement, html, css } from "lit";
+import { customElement, property, state } from "lit/decorators.js";
+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.
+ *
+ * @deprecated This component's fixed slot structure, hardcoded breakpoint,
+ * and built-in overflow logic are too rigid for most real layouts. Use the
+ * "Navbar" recipe at /docs/recipes/navbar instead, composed from
+ * rel-menu/rel-popover, rel-drawer, and rel-button. Still supported, but
+ * will be removed in a future major version.
+ *
+ * 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 {
+      color: var(--rel-text-default);
+      --rel-topbar-height: 64px;
+      --rel-topbar-height-compact: 48px;
+      --rel-topbar-bg: var(--rel-bg-surface);
+      --rel-topbar-border-color: var(--rel-border-default);
+      --rel-topbar-item-color: var(--rel-text-default);
+      --rel-topbar-item-active-color: var(--rel-text-success);
+      --rel-topbar-item-active-indicator: var(--rel-bg-brand);
+      --rel-topbar-item-hover-bg: var(--rel-bg-surface-elevated);
+      --rel-topbar-divider-color: var(--rel-border-default);
+      --rel-topbar-carrier-action-bg: var(--rel-text-default);
+      --rel-topbar-carrier-action-color: var(--rel-bg-surface);
+      --rel-topbar-z: 100;
+
+      display: block;
+      width: 100%;
+      font-family: var(--rel-fonts-font-family, 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-stroke-sm, 1px) solid var(--rel-topbar-border-color);
+      padding: 0 var(--rel-spacing-xl, 24px);
+      box-sizing: border-box;
+      gap: var(--rel-spacing-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-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-xs, 8px);
+    }
+
+    .actions-region,
+    .utilities-region,
+    .profile-region {
+      display: contents;
+    }
+
+    /* Vertical divider between util/profile when both are populated */
+    .divider {
+      width: var(--rel-stroke-sm, 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-xs, 8px);
+      background: var(--rel-topbar-carrier-action-bg);
+      color: var(--rel-topbar-carrier-action-color);
+      padding: var(--rel-spacing-2xs, 4px) var(--rel-spacing-sm, 12px);
+      border-radius: var(--rel-border-radius-full-rounded, 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-border-radius-sm, 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-stroke-sm, 1px) solid var(--rel-topbar-border-color);
+    }
+
+    .mobile-panel.open {
+      display: block;
+    }
+
+    .mobile-overflow-nav {
+      display: flex;
+      flex-direction: column;
+      padding: var(--rel-spacing-xs, 8px) 0;
+      border-top: 1px solid var(--rel-topbar-border-color);
+    }
+
+    .mobile-overflow-item {
+      display: block;
+      padding: var(--rel-spacing-xs, 8px) var(--rel-spacing-xl, 24px);
+      color: var(--rel-topbar-item-color);
       text-decoration: none;
       font-family: var(--rel-body-md-medium-font-family);
       font-weight: var(--rel-body-md-medium-font-weight);
       font-size: var(--rel-body-md-medium-font-size);
       line-height: var(--rel-body-md-medium-line-height);
       letter-spacing: var(--rel-body-md-medium-letter-spacing);
-    }
-
-    .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>
-    `;
-  }
-}
-
+    }
+
+    .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>
+    `;
+  }
+}
+