@keenmate/pure-admin-core 1.0.0-rc01

package/src/scss/core-components/layout/_navbar-elements.scss

@@ -0,0 +1,238 @@
+/* ========================================
+   Navbar/Header Elements
+   Burger menu, brand, navigation, title, profile button, theme switcher
+   ======================================== */
+@use '../../variables' as *;
+
+// Navbar elements (using pa-header__ prefix for backward compatibility with existing partials)
+.pa-header {
+  &__burger {
+    flex-shrink: 0;
+    margin-left: $burger-menu-margin-left;
+  }
+
+  &__brand {
+    flex-shrink: 0;
+    padding-left: $header-brand-padding-left;
+
+    h1 {
+      margin: 0;
+      font-size: $font-size-lg;
+      font-weight: $font-weight-semibold;
+      color: var(--pa-header-text);
+      white-space: nowrap;
+    }
+  }
+
+  &__nav {
+    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(--pa-header-text-secondary);
+          font-weight: $font-weight-medium;
+          padding: $spacing-xs $spacing-sm;
+          border-radius: $border-radius;
+          transition: all $transition-fast $easing-snappy;
+          font-size: $font-size-sm;
+          display: flex;
+          align-items: center;
+
+          &:hover {
+            color: var(--pa-accent);
+            background-color: var(--pa-accent-hover);
+          }
+        }
+      }
+    }
+
+    &--left {
+      margin-right: auto;
+    }
+
+    &--right {
+      margin-left: auto;
+    }
+  }
+
+  // Dropdown navigation items
+  &__nav-item {
+    &--has-dropdown {
+      position: static; // Position dropdown relative to header, not this item
+
+      &:hover > .pa-header__dropdown {
+        display: block !important; // Override the !important hide
+      }
+    }
+  }
+
+  &__nav-link {
+    display: flex;
+    align-items: center;
+    gap: $spacing-xs;
+  }
+
+  // Dropdown menus
+  &__dropdown {
+    display: none !important; // Force hide by default
+    position: absolute;
+    top: 100%;
+    left: 0;
+    min-width: 19.2rem;
+    background-color: var(--pa-card-bg);
+    border: $border-width-base solid var(--pa-border-color);
+    border-radius: $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)
+      &.pa-header__nav-item--has-dropdown::after {
+        content: '';
+        position: absolute;
+        top: 0;
+        left: 100%;
+        width: 6.4px; // Small invisible bridge
+        height: 100%;
+        z-index: 1099;
+      }
+
+      // Show nested dropdown on hover
+      &:hover > .pa-header__dropdown {
+        display: block !important;
+      }
+
+      a {
+        display: block;
+        padding: $spacing-sm $spacing-base;
+        color: var(--pa-text-primary);
+        border-radius: 0;
+        white-space: nowrap;
+        text-decoration: none;
+        font-weight: $font-weight-medium;
+        font-size: $font-size-sm;
+
+        &:hover {
+          background-color: var(--pa-accent-light);
+          color: var(--pa-accent);
+        }
+      }
+    }
+
+    // Level 2 dropdown (nested)
+    &--level2 {
+      top: 0;
+      left: 100%;
+      margin-top: 0;
+      margin-left: 0; // Remove gap to prevent dropdown from disappearing
+    }
+  }
+
+  &__title {
+    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(--pa-header-text);
+      white-space: nowrap;
+      overflow: hidden;
+      text-overflow: ellipsis;
+    }
+  }
+
+  &__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(--pa-header-text);
+    border-radius: $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);
+    }
+  }
+
+  &:hover span {
+    background-color: var(--pa-accent);
+  }
+}
+
+// Theme switcher styling
+.theme-switcher {
+  display: flex;
+  align-items: center;
+  gap: $spacing-sm;
+
+  label {
+    color: var(--pa-header-text-secondary);
+    font-size: $font-size-sm;
+  }
+
+  select {
+    padding: $spacing-xs $spacing-sm;
+    border: $border-width-base solid var(--pa-border-color);
+    border-radius: $border-radius;
+    background-color: var(--pa-header-bg);
+    color: var(--pa-header-text);
+    font-size: $font-size-sm;
+
+    &:focus {
+      outline: none;
+      border-color: var(--pa-accent);
+    }
+  }
+}

package/src/scss/core-components/layout/_navbar.scss

@@ -0,0 +1,71 @@
+/* ========================================
+   Navbar Component
+   Fixed navbar and constrained container widths
+   ======================================== */
+@use '../../variables' as *;
+
+// Navbar - Fixed at top, full width by default
+.pa-navbar {
+  position: fixed;
+  top: 0;
+  left: 0;
+  right: 0;
+  height: $header-height;
+  background-color: var(--pa-header-bg);
+  border-bottom: $border-width-base solid var(--pa-header-border-color);
+  z-index: $z-index-header; // 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.pa-container-sm .pa-navbar {
+  max-width: $layout-container-sm;
+  left: 0;
+  right: 0;
+  margin-left: auto;
+  margin-right: auto;
+}
+
+body.pa-container-md .pa-navbar {
+  max-width: $layout-container-md;
+  left: 0;
+  right: 0;
+  margin-left: auto;
+  margin-right: auto;
+}
+
+body.pa-container-lg .pa-navbar {
+  max-width: $layout-container-lg;
+  left: 0;
+  right: 0;
+  margin-left: auto;
+  margin-right: auto;
+}
+
+body.pa-container-xl .pa-navbar {
+  max-width: $layout-container-xl;
+  left: 0;
+  right: 0;
+  margin-left: auto;
+  margin-right: auto;
+}
+
+body.pa-container-2xl .pa-navbar {
+  max-width: $layout-container-2xl;
+  left: 0;
+  right: 0;
+  margin-left: auto;
+  margin-right: auto;
+}
+
+// Navbar inner content
+.pa-navbar__inner {
+  width: 100%;
+  padding: 0 $spacing-base;
+  display: flex;
+  align-items: center;
+  gap: $spacing-base;
+}

package/src/scss/core-components/layout/_sidebar-states.scss

@@ -0,0 +1,228 @@
+/* ========================================
+   Sidebar States
+   Hidden, icon-collapse, and expanded states
+   ======================================== */
+@use '../../variables' as *;
+
+// Sidebar hidden state
+.sidebar-hidden {
+  .pa-layout__sidebar {
+    width: 0;
+    opacity: 0;
+    overflow: hidden;
+    border-right: none;
+  }
+
+  // Icon-collapse mode: show narrow icon-only bar when hidden
+  .pa-layout__sidebar--icon-collapse {
+    width: $sidebar-collapsed-width;
+    opacity: 1; // Override parent opacity: 0 to make icons visible
+    overflow: visible !important; // Allow flyout to show outside sidebar
+    z-index: 1050; // Higher than content area (950) for flyouts
+    border-right: $border-width-base solid $border-color; // Restore border
+
+    // Enable positioning for flyouts
+    .pa-sidebar__item {
+      position: relative;
+    }
+
+    // Hide text labels
+    .pa-sidebar__label {
+      opacity: 0;
+      width: 0;
+      overflow: hidden;
+    }
+
+    // Hide chevron indicators
+    .pa-sidebar__chevron {
+      display: none;
+    }
+
+    // Hide submenus when collapsed (but allow hover override)
+    .pa-sidebar__submenu {
+      display: none;
+    }
+
+    // Icon stays in same position (no changes needed - already fixed width)
+    // The icon container maintains its $sidebar-icon-size width and position
+
+    // Keep EXACTLY the same padding as expanded state - icon must not move
+    .pa-sidebar__link,
+    .pa-sidebar__toggle {
+      padding: $sidebar-padding; // Same as expanded: 0.5rem 1rem (8px 16px)
+      position: relative; // For flyout positioning
+    }
+
+    // Flyout label on hover
+    .pa-sidebar__link:hover,
+    .pa-sidebar__toggle:hover {
+      overflow: visible;
+      z-index: 1000; // Elevate parent above content area
+
+      .pa-sidebar__label {
+        opacity: 1;
+        width: auto;
+        overflow: visible; // Remove overflow hidden
+        position: absolute;
+        left: 100%;
+        top: 0;
+        bottom: 0;
+        padding: $spacing-sm $spacing-base;
+        background-color: var(--pa-sidebar-bg);
+        border: $border-width-base solid var(--pa-border-color);
+        border-left: none;
+        border-radius: 0 $border-radius $border-radius 0;
+        box-shadow: $shadow-md;
+        white-space: nowrap;
+        z-index: 10; // Relative to parent
+        display: flex;
+        align-items: center;
+      }
+    }
+
+    // Show submenu flyout on hover (for items with submenus)
+    .pa-sidebar__item:hover > .pa-sidebar__submenu,
+    .pa-sidebar__submenu:hover {
+      display: block !important;
+      max-height: none !important;
+      overflow: visible !important;
+      position: absolute;
+      left: 100%;
+      top: 0;
+      min-width: 12rem;
+      margin: 0;
+      padding: 0;
+      list-style: none;
+      background-color: var(--pa-sidebar-submenu-bg);
+      border: $border-width-base solid var(--pa-border-color);
+      border-left: none;
+      border-radius: 0 $border-radius $border-radius 0;
+      box-shadow: $shadow-md;
+      z-index: 1001; // Higher than parent
+
+      // Reset submenu styling for flyout
+      .pa-sidebar__item {
+        position: relative; // For nested flyouts
+      }
+
+      .pa-sidebar__link,
+      .pa-sidebar__toggle {
+        padding: $spacing-sm $spacing-base;
+        justify-content: flex-start;
+        gap: $sidebar-item-gap;
+        font-size: $font-size-sm;
+        width: 100%;
+
+        &:hover {
+          background-color: var(--pa-sidebar-submenu-hover-bg);
+        }
+
+        &--active {
+          background-color: var(--pa-sidebar-submenu-active-bg);
+        }
+      }
+
+      .pa-sidebar__icon {
+        width: $sidebar-icon-size;
+        min-width: $sidebar-icon-size;
+        justify-content: center;
+      }
+
+      .pa-sidebar__label {
+        position: static;
+        opacity: 1;
+        width: auto;
+        padding: 0;
+        background: none;
+        border: none;
+        box-shadow: none;
+      }
+
+      .pa-sidebar__chevron {
+        display: inline;
+        margin-left: auto;
+        transform: none !important; // Always point right in flyout menus (never rotate down)
+      }
+
+      // Nested submenu flyout (level 3)
+      .pa-sidebar__submenu {
+        display: none;
+      }
+
+      .pa-sidebar__item:hover > .pa-sidebar__submenu,
+      .pa-sidebar__submenu .pa-sidebar__submenu:hover {
+        display: block !important;
+        max-height: none !important;
+        overflow: visible !important;
+        position: absolute;
+        left: 100%;
+        top: 0;
+        min-width: 19.2rem;
+        margin: 0;
+        padding: 0;
+        list-style: none;
+        background-color: var(--pa-sidebar-submenu-bg);
+        border: $border-width-base solid var(--pa-border-color);
+        border-left: none;
+        border-radius: 0 $border-radius $border-radius 0;
+        box-shadow: $shadow-md;
+        z-index: 1002; // Higher than parent submenu
+
+        .pa-sidebar__link,
+        .pa-sidebar__toggle {
+          font-size: $font-size-xs;
+        }
+
+        .pa-sidebar__chevron {
+          transform: none !important; // Always point right in nested flyout menus
+        }
+      }
+    }
+  }
+}
+
+// Sidebar expanded state (when not hidden) - ensure icon-collapse mode shows full width
+body:not(.sidebar-hidden) {
+  .pa-layout__sidebar--icon-collapse {
+    width: $sidebar-width;
+
+    // Show labels when expanded
+    .pa-sidebar__label {
+      opacity: 1;
+      width: auto;
+    }
+
+    // Show chevron when expanded
+    .pa-sidebar__chevron {
+      display: inline;
+    }
+
+    // Restore normal padding for level 1 items only
+    .pa-sidebar__link,
+    .pa-sidebar__toggle {
+      padding: $sidebar-padding;
+      justify-content: flex-start;
+      gap: $sidebar-item-gap; // Restore gap when expanded
+    }
+
+    // Submenus controlled by --open class (no forced display)
+
+    // Restore submenu indentation for level 2
+    .pa-sidebar__submenu > .pa-sidebar__item > .pa-sidebar__link,
+    .pa-sidebar__submenu > .pa-sidebar__item > .pa-sidebar__toggle {
+      padding-left: $sidebar-submenu-indent;
+    }
+
+    // Restore submenu indentation for level 3
+    .pa-sidebar__submenu .pa-sidebar__submenu > .pa-sidebar__item > .pa-sidebar__link,
+    .pa-sidebar__submenu .pa-sidebar__submenu > .pa-sidebar__item > .pa-sidebar__toggle {
+      padding-left: calc($sidebar-submenu-indent * $sidebar-submenu-indent-multiplier);
+    }
+
+    // Icon maintains same position in both states
+    .pa-sidebar__icon {
+      width: $sidebar-icon-size;
+      // No justify-content needed - parent flex container handles alignment
+    }
+  }
+}

package/src/scss/core-components/layout/_sidebar.scss

@@ -0,0 +1,177 @@
+/* ========================================
+   Sidebar Component
+   Sidebar navigation with nested submenus
+   ======================================== */
+@use '../../variables' as *;
+
+// Sidebar layout element
+.pa-layout__sidebar {
+  width: $sidebar-width;
+  background-color: var(--pa-sidebar-bg);
+  border-right: $border-width-base solid var(--pa-border-color);
+  flex-shrink: 0;
+}
+
+// Sticky mode - sidebar scrolls
+body.pa-layout--sticky .pa-layout__sidebar {
+  overflow-y: auto;
+  overflow-x: visible; // Allow tooltips to escape right
+}
+
+// Sidebar component (separate BEM block)
+.pa-sidebar {
+  &__nav {
+    padding: $spacing-base 0;
+
+    ul {
+      list-style: none;
+      margin: 0;
+      padding: 0;
+    }
+  }
+
+  &__item {
+    // Base styles for all sidebar items (regular links and submenu toggles)
+  }
+
+  &__link {
+    display: flex;
+    align-items: center;
+    gap: $sidebar-item-gap;
+    padding: $sidebar-padding;
+    color: var(--pa-sidebar-text-secondary);
+    text-decoration: none;
+    font-weight: $font-weight-medium;
+    border-right: $border-width-thick solid transparent; // Reserve space to prevent shift on active
+
+    body.loaded & {
+      transition: all $transition-fast $easing-snappy;
+    }
+
+    &:hover {
+      color: var(--pa-sidebar-text);
+      background-color: var(--pa-accent-light);
+    }
+
+    &--active {
+      color: var(--pa-sidebar-text);
+      background-color: var(--pa-accent-hover);
+      border-right-color: var(--pa-accent); // Only change color, not width
+      font-weight: $font-weight-semibold; // Make active item bolder
+    }
+  }
+
+  &__toggle {
+    // For submenu toggle buttons (non-link items)
+    display: flex;
+    align-items: center;
+    gap: $sidebar-item-gap;
+    padding: $sidebar-padding;
+    color: var(--pa-sidebar-text-secondary);
+    background: none;
+    border: none;
+    width: 100%;
+    text-align: left;
+    font-weight: $font-weight-medium;
+    cursor: pointer;
+
+    body.loaded & {
+      transition: all $transition-fast $easing-snappy;
+    }
+
+    &:hover {
+      color: var(--pa-sidebar-text);
+      background-color: var(--pa-accent-light);
+    }
+
+    &--active {
+      color: var(--pa-sidebar-text);
+      background-color: var(--pa-accent-hover);
+    }
+  }
+
+  // Icon and label styles
+  &__icon {
+    width: $sidebar-icon-size;
+    min-width: $sidebar-icon-size;
+    height: $sidebar-icon-size;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    flex-shrink: 0;
+    font-size: $font-size-base;
+    text-align: center;
+    line-height: 1; // Prevent emoji baseline shift
+  }
+
+  &__label {
+    flex: 1;
+    overflow: hidden;
+    text-overflow: ellipsis;
+    white-space: nowrap;
+
+    body.loaded & {
+      transition: opacity $transition-normal $easing-snappy, width $transition-normal $easing-snappy;
+    }
+  }
+
+  // Submenu styles - Level 2
+  &__submenu {
+    list-style: none;
+    margin: 0;
+    padding: 0;
+    display: none;
+    background-color: var(--pa-sidebar-submenu-bg);
+
+    &--open {
+      display: block;
+    }
+  }
+
+  // Level 2 submenu links
+  &__submenu > &__item > &__link {
+    padding-left: $sidebar-submenu-indent;
+    font-size: $font-size-md;
+    border-right: $border-width-medium solid transparent; // Reserve space to prevent shift on active
+
+    &:hover {
+      background-color: var(--pa-sidebar-submenu-hover-bg);
+    }
+
+    &--active {
+      background-color: var(--pa-sidebar-submenu-active-bg);
+      border-right-color: var(--pa-accent); // Only change color, not width
+    }
+  }
+
+  // Level 2 submenu toggles (for third level)
+  &__submenu > &__item > &__toggle {
+    padding-left: $sidebar-submenu-indent;
+    font-size: $font-size-md;
+  }
+
+  // Level 3 submenu links
+  &__submenu &__submenu > &__item > &__link {
+    padding-left: calc($sidebar-submenu-indent * $sidebar-submenu-indent-multiplier);
+    font-size: $font-size-sm;
+    border-right: $border-width-base solid transparent; // Reserve space to prevent shift on active
+
+    &--active {
+      border-right-color: var(--pa-accent); // Only change color, not width
+    }
+  }
+
+  // Chevron icon for toggle buttons
+  &__chevron {
+    margin-left: auto;
+    font-size: $font-size-xs;
+
+    body.loaded & {
+      transition: transform $transition-fast $easing-snappy;
+    }
+
+    .pa-sidebar__item--open & {
+      transform: rotate(90deg);
+    }
+  }
+}

package/src/scss/main.scss

@@ -0,0 +1,7 @@
+/* Pure Admin Visual Framework - Main Entry Point */
+
+// Utilities (spacing, etc.)
+@use "utilities" as *;
+
+// Core framework (includes variables and all core-components)
+@use 'core' as *;