@keenmate/pure-css 1.0.0-rc03 → 1.0.0-rc05

package/src/scss/_navbar-elements.scss

@@ -0,0 +1,419 @@
+@use 'variables/index' as *;
+/* ========================================
+   Navbar/Header Elements
+   Burger menu, brand, navigation, title, profile button, theme switcher
+   ======================================== */
+
+// Fit engine (navbar-fit.js): the class it toggles to remove a slot or an
+// inactive step from the row. `!important` beats component display rules (e.g.
+// `.pc-navbar-search { display: flex }`) that would otherwise defeat it; using a
+// class (not inline display) means "show" simply reverts to the element's own
+// stylesheet display. Author non-first steps with this class too, so before JS
+// runs only the largest variant shows (no stacked-variants flash, no-JS-safe).
+.pc-fit-hidden {
+  display: none !important;
+}
+
+// --- App identity: brand wordmark + version tag -------------------------------
+// The brand container. In markup: <div class="pc-app-header"><h1>…</h1></div>.
+.pc-app-header {
+  flex-shrink: 0;
+  // No brand padding: the .pc-navbar__start flex `gap` (see _navbar.scss) is the
+  // single separator between the burger and the brand.
+
+  h1 {
+    margin: 0;
+    font-size: $font-size-lg;
+    font-weight: $font-weight-semibold;
+    color: var(--pc-navbar-text);
+    white-space: nowrap;
+  }
+
+  // Version tag beside the wordmark (e.g. "Pure Admin v2.9.0"). Smaller and
+  // muted so it reads as metadata rather than part of the product name.
+  &__version {
+    margin-inline-start: $spacing-xs;
+    font-size: $font-size-xs;
+    font-weight: $font-weight-normal;
+    color: var(--pc-navbar-text-secondary);
+  }
+}
+
+// --- Burger (fixed navbar anchor, never degrades) -----------------------------
+.pc-navbar__burger {
+  flex-shrink: 0;
+  margin-inline-start: $burger-menu-margin-left; // RTL: flips to margin-right
+}
+
+// --- Navbar menu: horizontal nav + dropdowns + collapse "More" ----------------
+// Its own block (reused in both the start and end navbar zones).
+.pc-navmenu {
+  flex-shrink: 0;
+
+  // Only style the direct child ul (main navigation)
+  > ul {
+    list-style: none;
+    margin: 0;
+    padding: 0;
+    display: flex;
+    gap: $spacing-md;
+
+    > li {
+      margin: 0; // Disable base margins from _base.scss
+      position: relative; // For dropdown positioning
+      display: flex;
+      align-items: center;
+
+      > a {
+        text-decoration: none;
+        color: var(--pc-navbar-text-secondary);
+        font-weight: $font-weight-medium;
+        padding: $spacing-xs $spacing-sm;
+        border-radius: var(--pc-border-radius);
+        transition: all $transition-fast $easing-snappy;
+        font-size: $font-size-sm;
+        display: flex;
+        align-items: center;
+
+        // Hover/active derive their pill background from `currentColor` — a
+        // translucent tint of the link's OWN rendered text colour — not the
+        // content-area --pc-accent. The navbar sits on --pc-navbar-bg, which
+        // several themes set dark or to the accent colour itself (e.g. NATO's
+        // navy bar) and then force the nav text light with !important while
+        // leaving --pc-navbar-text at its default dark value. A currentColor
+        // tint tracks the actual text colour (light there, dark on light
+        // bars), so the pill contrasts the bar on every theme; an accent
+        // or --pc-navbar-text tint would be dark-on-dark and vanish. Text
+        // brightens to --pc-navbar-text, which those themes override to match.
+        &:hover {
+          color: var(--pc-navbar-text);
+          background-color: color-mix(in srgb, currentColor 12%, transparent);
+        }
+      }
+
+      // Active top-level item — the current section. Held state = a stronger
+      // currentColor pill + semibold, reading clearly above the hover tint on
+      // any bar. Modifier goes on the <li> (.pc-navmenu__item--active);
+      // scoped through the nav > ul > li chain so it outweighs the base
+      // `> li > a` colour.
+      &.pc-navmenu__item--active > a {
+        &,
+        &:hover {
+          color: var(--pc-navbar-text);
+          background-color: color-mix(in srgb, currentColor 22%, transparent);
+          font-weight: $font-weight-semibold;
+        }
+      }
+    }
+  }
+
+  // Dropdown navigation items
+  &__item {
+    &--has-dropdown {
+      position: static; // Position dropdown relative to navbar, not this item
+
+      // Hover-reveal only where hover exists. On touch it never fires (and
+      // sticky-hover would fight the JS), so it's gated out and the `.is-open`
+      // class below — toggled by navbar-dropdown.js on tap — drives the menu.
+      @media (hover: hover) {
+        &:hover > .pc-navmenu__dropdown {
+          display: block !important; // Override the !important hide
+        }
+      }
+
+      // Touch open state (first-tap-opens; navbar-dropdown.js). Works on all
+      // devices, so the same class also drives keyboard/JS opens if wired.
+      &.is-open > .pc-navmenu__dropdown {
+        display: block !important;
+      }
+    }
+  }
+
+  &__link {
+    display: flex;
+    align-items: center;
+    gap: $spacing-xs;
+  }
+
+  // Dropdown menus
+  &__dropdown {
+    display: none !important; // Force hide by default
+    position: absolute;
+    top: 100%;
+    inset-inline-start: 0; // RTL: flips to right: 0
+    min-width: 19.2rem;
+    background-color: var(--pc-card-bg);
+    border: $border-width-base solid var(--pc-border-color);
+    border-radius: var(--pc-border-radius);
+    box-shadow: $shadow-lg;
+    z-index: 1100;
+    padding: $spacing-xs 0;
+    margin-top: 0;
+    list-style: none;
+    flex-direction: column; // Override any flex from parent
+
+    li {
+      margin: 0; // Disable base margins from _base.scss
+      display: block;
+      position: relative;
+
+      // Create invisible bridge for nested dropdowns (horizontal)
+      &.pc-navmenu__item--has-dropdown::after {
+        content: '';
+        position: absolute;
+        top: 0;
+        inset-inline-start: 100%; // RTL: flips to right: 100%
+        width: 6.4px; // Small invisible bridge
+        height: 100%;
+        z-index: 1099;
+      }
+
+      // Show nested dropdown on hover (hover devices only — see above).
+      @media (hover: hover) {
+        &:hover > .pc-navmenu__dropdown {
+          display: block !important;
+        }
+      }
+
+      // Touch open state for nested submenus (navbar-dropdown.js).
+      &.is-open > .pc-navmenu__dropdown {
+        display: block !important;
+      }
+
+      a {
+        display: block;
+        padding: $spacing-sm $spacing-base;
+        color: var(--pc-text-color-1);
+        border-radius: 0;
+        white-space: nowrap;
+        text-decoration: none;
+        font-weight: $font-weight-medium;
+        font-size: $font-size-sm;
+
+        &:hover {
+          background-color: var(--pc-accent-light);
+          color: var(--pc-accent);
+        }
+      }
+    }
+
+    // Level 2 dropdown (nested)
+    &--level2 {
+      top: 0;
+      inset-inline-start: 100%; // RTL: flips to right: 100%
+      margin-top: 0;
+      margin-inline-start: 0; // RTL: flips to margin-right
+    }
+  }
+
+  // On touch, a nested submenu can't be a sideways flyout — `inset-inline-start:
+  // 100%` runs it straight off narrow screens (nowhere to fly). So on
+  // `(hover: none)` nested dropdowns stack INLINE (accordion) inside the level-1
+  // panel: static box, indented items, no shadow/border — the same shape the
+  // flattened "More" panel uses, but toggled open per-branch by the `.is-open`
+  // class (navbar-dropdown.js) rather than shown all at once. The level-1 panel
+  // itself stays an absolute drop below the bar.
+  @media (hover: none) {
+    &__dropdown &__dropdown {
+      position: static;
+      inset: auto;
+      min-width: 0;
+      margin: 0;
+      border: none;
+      box-shadow: none;
+      padding: 0;
+
+      li a {
+        padding-inline-start: $spacing-xl; // indent under the group header
+      }
+    }
+  }
+
+  // --- Responsive collapse (driven by fit.js, data-pc-fit-nav) -----------
+  // A nav opted into progressive collapse must be able to shrink BELOW its
+  // content so fit.js's bbox-sum vs clientWidth overflow test becomes truthful.
+  // Make the nav shrinkable, and (via :has) let the enclosing start section
+  // shrink too — it's flex-shrink:0 by default — so the nav absorbs the squeeze
+  // while the burger and brand (also flex-shrink:0) keep their size.
+  &[data-pc-fit-nav] {
+    flex-shrink: 1;
+    min-width: 0;
+    // No overflow:hidden here — it would clip the nav items' OWN hover
+    // dropdowns (they drop below the bar, and any ancestor overflow:hidden
+    // cuts them off). Items stay at natural width (flex-shrink:0) and
+    // fit.js detects overflow by summing item widths, so clipping
+    // isn't needed to measure it.
+
+    > ul > li {
+      flex-shrink: 0;
+    }
+  }
+
+  // The generated "More" trigger. Its panel is parented to <body> (to escape
+  // the nav's overflow:hidden) and positioned by fit.js, so there's
+  // no inline anchoring to do here — just the trigger's own affordance.
+  &__item--more {
+    position: relative;
+  }
+
+  &__more-chevron {
+    display: inline-block;
+    margin-inline-start: $spacing-xs;
+    font-size: $font-size-xs;
+    transition: transform $transition-fast $easing-snappy;
+  }
+
+  // Chevron points down while the panel is open (click-toggled).
+  &__item--more.is-open &__more-chevron {
+    transform: rotate(90deg);
+  }
+
+  // The More panel is parented to <body> (escapes the nav's overflow:hidden)
+  // and positioned by JS; fit.js toggles --open to reveal it. The
+  // compound selector outweighs the base `.pc-navmenu__dropdown { display:none }`.
+  &__more-menu {
+    z-index: $z-index-navbar + 10; // above the fixed navbar
+
+    &.pc-navmenu__more-menu--open {
+      display: block !important;
+    }
+  }
+
+  // Flatten — the answer to "what about multi-level menus" in menu mode.
+  // Inside the More panel, a collapsed item that had its own dropdown renders
+  // that submenu INLINE (indented, static) instead of a hover flyout, so the
+  // whole thing is one scrollable panel with no cascading menus, at any depth.
+  &__more-menu {
+    .pc-navmenu__dropdown {
+      display: block !important; // always shown; overrides the hover-reveal
+      position: static;
+      min-width: 0;
+      border: none;
+      box-shadow: none;
+      padding: 0;
+      margin: 0;
+
+      li a {
+        padding-inline-start: $spacing-xl; // indent under the group header
+      }
+    }
+
+    // A parent link that owns a submenu reads as a group header.
+    .pc-navmenu__item--has-dropdown > a {
+      font-weight: $font-weight-semibold;
+    }
+
+    // No flyout bridge inside the flattened panel.
+    .pc-navmenu__item--has-dropdown::after {
+      content: none;
+    }
+  }
+}
+
+// The navbar start zone must shrink when it hosts a collapsible menu, so the
+// nav can absorb the squeeze (see the collapse note above). It's flex-shrink:0
+// by default in _navbar.scss; :has() opts it back into shrinking only when a
+// collapsible menu is present, leaving the burger and brand at their size.
+.pc-navbar__start:has(.pc-navmenu[data-pc-fit-nav]) {
+  flex-shrink: 1;
+  min-width: 0;
+}
+
+// --- Page title (the center zone's page header) -------------------------------
+.pc-page-header {
+  flex: 1;
+  min-width: 0;  // Enable ellipsis
+  text-align: center;
+
+  h2 {
+    margin: 0;
+    font-size: $font-size-lg;
+    font-weight: $font-weight-semibold;
+    color: var(--pc-navbar-text);
+    white-space: nowrap;
+    overflow: hidden;
+    text-overflow: ellipsis;
+  }
+}
+
+// --- Profile trigger (navbar end zone) ----------------------------------------
+.pc-navbar__profile-btn {
+  flex-shrink: 0;
+}
+
+// Burger menu button
+.burger-menu {
+  display: flex;
+  flex-direction: column;
+  justify-content: space-around;
+  width: $burger-width;
+  height: $burger-height;
+  background: transparent;
+  border: none;
+  cursor: pointer;
+  padding: 0;
+
+  span {
+    width: 100%;
+    height: $burger-bar-height;
+    background-color: var(--pc-navbar-text);
+    border-radius: var(--pc-border-radius);
+    transition: all $transition-normal $easing-snappy;
+    transform-origin: center;
+  }
+
+  &.active {
+    span:nth-child(1) {
+      transform: rotate(45deg) translate($burger-transform-offset, $burger-transform-offset);
+    }
+
+    span:nth-child(2) {
+      opacity: 0;
+    }
+
+    span:nth-child(3) {
+      transform: rotate(-45deg) translate($burger-transform-offset, -$burger-transform-offset);
+    }
+  }
+
+  // RTL: reverse X translation direction
+  [dir="rtl"] &.active {
+    span:nth-child(1) {
+      transform: rotate(45deg) translate(-$burger-transform-offset, $burger-transform-offset);
+    }
+
+    span:nth-child(3) {
+      transform: rotate(-45deg) translate(-$burger-transform-offset, -$burger-transform-offset);
+    }
+  }
+
+  &:hover span {
+    background-color: var(--pc-accent);
+  }
+}
+
+// Theme switcher styling
+.theme-switcher {
+  display: flex;
+  align-items: center;
+  gap: $spacing-sm;
+
+  label {
+    color: var(--pc-navbar-text-secondary);
+    font-size: $font-size-sm;
+  }
+
+  select {
+    padding: $spacing-xs $spacing-sm;
+    border: $border-width-base solid var(--pc-border-color);
+    border-radius: var(--pc-border-radius);
+    background-color: var(--pc-navbar-bg);
+    color: var(--pc-navbar-text);
+    font-size: $font-size-sm;
+
+    &:focus {
+      outline: none;
+      border-color: var(--pc-accent);
+    }
+  }
+}

package/src/scss/_navbar.scss

@@ -0,0 +1,120 @@
+@use 'variables/index' as *;
+/* ========================================
+   Navbar Component
+   Fixed navbar and constrained container widths
+   ======================================== */
+
+// Width the centre slot reserves when it hosts a command-palette search pill
+// (see .pc-navbar__center below). A floor, not a fixed width — the slot still
+// grows via flex:1; this just stops it collapsing to a sliver.
+$navbar-search-reserve-width: 18rem !default;
+
+// Navbar - Fixed at top, full width by default
+.pc-navbar {
+  position: fixed;
+  top: 0;
+  inset-inline: 0; // RTL: works for both LTR and RTL
+  height: $navbar-height;
+  background-color: var(--pc-navbar-bg);
+  border-bottom: $border-width-base solid var(--pc-navbar-border-color);
+  z-index: $z-index-navbar; // 2000
+  display: flex;
+  align-items: center;
+  justify-content: center; // Center for constrained mode
+}
+
+// Constrained navbar - limit navbar width to match container
+// Body class is just a marker, no width styles on body itself
+body.pc-container-sm .pc-navbar {
+  max-width: $layout-container-sm;
+  inset-inline: 0; // RTL: works for both LTR and RTL
+  margin-inline: auto; // RTL: centers in both directions
+}
+
+body.pc-container-md .pc-navbar {
+  max-width: $layout-container-md;
+  inset-inline: 0;
+  margin-inline: auto;
+}
+
+body.pc-container-lg .pc-navbar {
+  max-width: $layout-container-lg;
+  inset-inline: 0;
+  margin-inline: auto;
+}
+
+body.pc-container-xl .pc-navbar {
+  max-width: $layout-container-xl;
+  inset-inline: 0;
+  margin-inline: auto;
+}
+
+body.pc-container-2xl .pc-navbar {
+  max-width: $layout-container-2xl;
+  inset-inline: 0;
+  margin-inline: auto;
+}
+
+// Navbar inner content. Its direct children are a FIXED burger anchor
+// (.pc-navbar__burger — always visible, never in the fit engine) followed by
+// the three degradable zones (.pc-navbar__start / __center / __end). The burger
+// is a SIBLING of the zones, not inside start, so it stays put while the zones
+// collapse. Its `gap` here is the single burger→start separator (same
+// $spacing-base as .pc-navbar__start's own gap). navbar-fit.js measures these
+// direct children.
+.pc-navbar__inner {
+  width: 100%;
+  padding: 0 $spacing-base;
+  display: flex;
+  align-items: center;
+  gap: $spacing-base;
+}
+
+// Header sections - Start/Center/End layout
+.pc-navbar__start {
+  display: flex;
+  align-items: center;
+  gap: $spacing-base;
+  flex-shrink: 0;
+}
+
+.pc-navbar__center {
+  flex: 1;
+  min-width: 0; // Allow shrinking for ellipsis
+  display: flex;
+  align-items: center;
+  justify-content: center;
+
+  // When the centre slot holds a command-palette search pill, reserve real
+  // width for it. The search's min-width lives on a *child* (.pc-navbar-search),
+  // which flexbox ignores — so this slot (min-width:0) would collapse to a
+  // sliver, letting the pill overflow onto the start/end slots. Worse: that
+  // deficit never shrinks the NAV's own slot, so fit.js — which
+  // measures nav.clientWidth — never sees it and stops folding while items still
+  // overlap. Reserving a floor here forces the squeeze onto the shrinkable
+  // .pc-navbar__start (see the :has rule in _navbar-elements.scss) instead, so
+  // the nav narrows and the collapse loop fires honestly.
+  &:has(.pc-navbar-search) {
+    min-width: $navbar-search-reserve-width;
+
+    // Let the reserved slot's DIRECT flex child shrink, whatever it is. The
+    // shrink flexbox needs (min-width:0) has to land on the flex item itself —
+    // not on the pill by name. Consumers (svelte-pure-admin etc.) wrap the pill
+    // in their own element; a descendant selector shrank the pill but left the
+    // wrapper at min-width:auto, so it refused to collapse and overflowed onto
+    // the start/end slots. Targeting `> *` is position-agnostic: pill-as-child
+    // and pill-in-wrapper both shrink. Guarded by :has(.pc-navbar-search) so it
+    // only touches the slot when it actually hosts a search.
+    > * {
+      min-width: 0;
+    }
+  }
+}
+
+.pc-navbar__end {
+  display: flex;
+  align-items: center;
+  gap: $spacing-base;
+  flex-shrink: 0;
+  margin-inline-start: auto;
+}