@keenmate/pure-admin-core 2.3.1 → 2.3.3

package/src/scss/core-components/_command-palette.scss

@@ -1,509 +1,518 @@
-/* ========================================
-   Command Palette Component
-   macOS Spotlight-style search with context switching
-   ======================================== */
-@use '../variables' as *;
-
-.pa-command-palette {
-  position: fixed;
-  inset: 0; // RTL: full screen works in both directions
-  z-index: $z-index-command-palette;
-  display: none;
-  align-items: flex-start;
-  justify-content: center;
-  padding-top: $command-palette-offset-top;
-
-  &--active {
-    display: flex;
-  }
-
-  // Backdrop overlay
-  &__backdrop {
-    position: absolute;
-    inset: 0; // RTL: full screen works in both directions
-    background-color: var(--pa-command-palette-backdrop-bg);
-    backdrop-filter: blur($command-palette-backdrop-blur);
-    animation: fadeIn $transition-normal $easing-smooth;
-  }
-
-  // Main container
-  &__container {
-    position: relative;
-    width: 100%;
-    max-width: $command-palette-width;
-    background-color: var(--pa-modal-content-bg);
-    border-radius: $command-palette-border-radius;
-    box-shadow: $command-palette-shadow;
-    animation: slideDown $transition-normal $easing-smooth;
-    overflow: hidden;
-  }
-
-  // Search input wrapper
-  &__search {
-    position: relative;
-    border-bottom: $border-width-base solid var(--pa-border-color);
-    padding: $spacing-sm;
-  }
-
-  // Tokens container (resolved query fragments)
-  &__tokens {
-    display: flex;
-    flex-wrap: wrap;
-    gap: $spacing-xs;
-    align-items: center;
-
-    .pa-badge {
-      display: inline-flex;
-      align-items: center;
-      margin: 0;
-
-      // Remove button inside badge
-      &__remove {
-        margin-inline-start: $spacing-xs; // RTL: flips to margin-right
-        padding: 0 $spacing-xs;
-        border: none;
-        background: transparent;
-        color: inherit;
-        cursor: pointer;
-        font-size: 1.2em;
-        line-height: 1;
-        opacity: 0.7;
-        transition: opacity $transition-fast $easing-smooth;
-
-        &:hover {
-          opacity: 1;
-        }
-      }
-    }
-  }
-
-  &__input {
-    width: 100%;
-    height: $command-palette-input-height;
-    padding: $command-palette-input-padding-v $command-palette-input-padding-h;
-    font-size: $command-palette-input-font-size;
-    border: $border-width-base solid var(--pa-border-color);
-    border-radius: $border-radius;
-    background-color: var(--pa-input-bg);
-    color: var(--pa-text-color-1);
-    outline: none;
-    transition: border-color $transition-fast $easing-snappy;
-
-    &:focus {
-      border-color: $input-focus-border-color;
-      box-shadow: 0 0 0 $focus-ring-width $accent-light;
-    }
-
-    &::placeholder {
-      color: var(--pa-text-color-2);
-      opacity: $opacity-muted;
-    }
-  }
-
-  // Context label (e.g., "Searching in Products")
-  &__context {
-    position: absolute;
-    inset-inline-end: calc(#{$spacing-sm} + #{$command-palette-input-padding-h}); // RTL: flips to left
-    top: 50%;
-    transform: translateY(-50%);
-    font-size: $font-size-xs;
-    color: var(--pa-accent);
-    font-weight: $font-weight-medium;
-    padding: $spacing-xs $spacing-sm;
-    background-color: var(--pa-accent-light);
-    border-radius: $border-radius-sm;
-    opacity: 0;
-    transition: opacity $transition-fast $easing-smooth;
-
-    &--visible {
-      opacity: 1;
-    }
-  }
-
-  // Results container
-  &__results {
-    max-height: $command-palette-results-max-height;
-    overflow-y: auto;
-    padding: $spacing-sm 0;
-    position: relative;
-
-    // Loading state - show subtle opacity overlay
-    &--loading {
-      &::after {
-        content: '';
-        position: absolute;
-        inset: 0; // RTL: full overlay works in both directions
-        background-color: rgba($modal-content-bg, 0.7);
-        pointer-events: none;
-        z-index: 1;
-      }
-    }
-  }
-
-  // Empty state
-  &__empty {
-    padding: $command-palette-empty-padding-v $command-palette-input-padding-h;
-    text-align: center;
-    color: var(--pa-text-color-2);
-    font-size: $font-size-sm;
-  }
-
-  // Loader
-  &__loader {
-    padding: $command-palette-empty-padding-v $command-palette-input-padding-h;
-    display: flex;
-    align-items: center;
-    justify-content: center;
-    gap: $spacing-sm;
-    color: var(--pa-text-color-2);
-    font-size: $font-size-sm;
-
-    .pa-spinner {
-      width: $spacing-base;
-      height: $spacing-base;
-    }
-  }
-
-  // Result item
-  &__item {
-    padding: $command-palette-item-padding-v $command-palette-input-padding-h;
-    cursor: pointer;
-    transition: background-color $transition-fast $easing-smooth;
-    display: flex;
-    align-items: center;
-    gap: $spacing-sm;
-
-    &:hover {
-      background-color: var(--pa-command-palette-item-hover-bg);
-    }
-
-    &--active {
-      background-color: var(--pa-command-palette-item-active-bg);
-    }
-  }
-
-  // Item icon
-  &__item-icon {
-    flex-shrink: 0;
-    width: $command-palette-item-icon-size;
-    height: $command-palette-item-icon-size;
-    display: flex;
-    align-items: center;
-    justify-content: center;
-    background-color: var(--pa-accent-light);
-    color: var(--pa-accent);
-    border-radius: $border-radius-sm;
-    font-size: $font-size-sm;
-  }
-
-  // Item content
-  &__item-content {
-    flex: 1;
-    min-width: 0;
-  }
-
-  &__item-title {
-    font-size: $font-size-sm;
-    font-weight: $font-weight-medium;
-    color: var(--pa-text-color-1);
-    margin: 0;
-    white-space: nowrap;
-    overflow: hidden;
-    text-overflow: ellipsis;
-
-    mark {
-      background-color: var(--pa-command-palette-highlight-bg);
-      color: var(--pa-command-palette-highlight-text);
-      font-weight: $font-weight-semibold;
-      padding: 0 2px;
-      border-radius: 2px;
-    }
-  }
-
-  &__item-meta {
-    font-size: $font-size-xs;
-    color: var(--pa-text-color-2);
-    margin: 0;
-    margin-top: 2px;
-    white-space: nowrap;
-    overflow: hidden;
-    text-overflow: ellipsis;
-  }
-
-  // Item badge (e.g., category, status)
-  &__item-badge {
-    flex-shrink: 0;
-    font-size: $font-size-xs;
-    padding: 2px $spacing-xs;
-    background-color: $secondary-light-bg;
-    color: var(--pa-text-color-2);
-    border-radius: $border-radius-sm;
-  }
-
-  // Footer with keyboard hints
-  &__footer {
-    border-top: $border-width-base solid var(--pa-border-color);
-    padding: $spacing-sm $command-palette-input-padding-h;
-    display: flex;
-    gap: $spacing-base;
-    font-size: $font-size-xs;
-    color: var(--pa-text-color-2);
-  }
-
-  &__hint {
-    display: flex;
-    align-items: center;
-    gap: $spacing-xs;
-  }
-
-  &__key {
-    padding: 2px $spacing-xs;
-    background-color: $secondary-light-bg;
-    border: $border-width-base solid var(--pa-border-color);
-    border-radius: $border-radius-sm;
-    font-family: $body-font-family;
-    font-weight: $font-weight-medium;
-    font-size: $font-size-2xs;
-    line-height: 1;
-  }
-
-  // Section headers (for grouping results)
-  &__section {
-    padding: $spacing-sm $command-palette-input-padding-h $spacing-xs;
-    font-size: $font-size-xs;
-    font-weight: $font-weight-semibold;
-    color: var(--pa-text-color-2);
-    text-transform: uppercase;
-    letter-spacing: 0.5px;
-  }
-
-  // Pagination indicator
-  &__pagination {
-    padding: $spacing-xs $command-palette-input-padding-h;
-    text-align: center;
-    font-size: $font-size-xs;
-    color: var(--pa-text-color-2);
-    border-top: $border-width-base solid var(--pa-border-color);
-  }
-}
-
-// Animations
-@keyframes fadeIn {
-  from {
-    opacity: 0;
-  }
-  to {
-    opacity: 1;
-  }
-}
-
-@keyframes slideDown {
-  from {
-    opacity: 0;
-    transform: translateY(-20px);
-  }
-  to {
-    opacity: 1;
-    transform: translateY(0);
-  }
-}
-
-// Responsive
-@media (max-width: $mobile-breakpoint) {
-  .pa-command-palette {
-    padding-top: $spacing-base;
-
-    &__container {
-      max-width: calc(100% - #{$spacing-base * 2});
-    }
-
-    &__results {
-      max-height: 60vh;
-    }
-  }
-}
-
-/* ========================================
-   Navbar Search Trigger
-   Button that opens the command palette
-   ======================================== */
-
-.pa-navbar-search {
-  display: flex;
-  align-items: center;
-  gap: $spacing-sm;
-  padding: $input-padding-v $input-padding-h;
-  background-color: var(--pa-input-bg);
-  border: $border-width-base solid var(--pa-border-color);
-  border-radius: $border-radius;
-  cursor: pointer;
-  transition: border-color $transition-fast $easing-snappy;
-
-  &:hover {
-    border-color: $input-focus-border-color;
-  }
-
-  &:focus {
-    outline: none;
-    border-color: $input-focus-border-color;
-    box-shadow: 0 0 0 $focus-ring-width $accent-light;
-  }
-
-  // Size modifiers (matching input sizes)
-  &--xs {
-    height: #{$base-input-size-xs-height}rem;
-    font-size: $font-size-xs;
-  }
-
-  &--sm {
-    height: #{$base-input-size-sm-height}rem;
-    font-size: $font-size-xs;
-  }
-
-  &--md {
-    height: #{$base-input-size-md-height}rem;
-    font-size: $font-size-sm;
-  }
-
-  &--lg {
-    height: #{$base-input-size-lg-height}rem;
-    font-size: $font-size-base;
-  }
-
-  &--xl {
-    height: #{$base-input-size-xl-height}rem;
-    font-size: $font-size-lg;
-  }
-
-  &__icon {
-    flex-shrink: 0;
-    opacity: $opacity-muted;
-  }
-
-  &__placeholder {
-    flex: 1;
-    color: var(--pa-text-color-2);
-    white-space: nowrap;
-    overflow: hidden;
-    text-overflow: ellipsis;
-  }
-
-  &__shortcut {
-    display: flex;
-    align-items: center;
-    gap: 2px;
-    flex-shrink: 0;
-
-    kbd {
-      display: inline-flex;
-      align-items: center;
-      justify-content: center;
-      min-width: 2rem;
-      height: 2rem;
-      padding: 0 $spacing-xs;
-      font-family: $body-font-family;
-      font-size: $font-size-2xs;
-      font-weight: $font-weight-medium;
-      color: var(--pa-text-color-2);
-      background-color: $secondary-light-bg;
-      border: $border-width-base solid var(--pa-border-color);
-      border-radius: $border-radius-sm;
-      box-shadow: 0 1px 1px rgba(0, 0, 0, 0.05);
-    }
-  }
-}
-
-// Responsive: hide shortcut on small screens
-@media (max-width: $mobile-breakpoint) {
-  .pa-navbar-search {
-    &__placeholder {
-      display: none;
-    }
-
-    &__shortcut {
-      display: none;
-    }
-  }
-}
-
-/* ========================================
-   Shortcut Help Dialog
-   Modal content for displaying keyboard shortcuts
-   ======================================== */
-
-.pa-shortcut-help {
-  display: flex;
-  flex-direction: column;
-  gap: $spacing-base;
-}
-
-.pa-shortcut-help__category {
-  display: flex;
-  flex-direction: column;
-  gap: $spacing-xs;
-}
-
-.pa-shortcut-help__category-title {
-  font-size: $font-size-xs;
-  font-weight: $font-weight-semibold;
-  text-transform: uppercase;
-  letter-spacing: 0.5px;
-  color: var(--pa-text-color-2);
-  margin: 0;
-  padding-bottom: $spacing-xs;
-  border-bottom: $border-width-base solid var(--pa-border-color);
-}
-
-.pa-shortcut-help__list {
-  display: flex;
-  flex-direction: column;
-  gap: $spacing-xs;
-}
-
-.pa-shortcut-help__item {
-  display: flex;
-  align-items: center;
-  justify-content: space-between;
-  gap: $spacing-base;
-  padding: $spacing-xs 0;
-}
-
-.pa-shortcut-help__keys {
-  display: flex;
-  align-items: center;
-  gap: $spacing-xs;
-  flex-shrink: 0;
-}
-
-.pa-shortcut-help__key {
-  display: inline-flex;
-  align-items: center;
-  justify-content: center;
-  min-width: $spacing-lg;
-  height: $spacing-lg;
-  padding: 0 $spacing-xs;
-  font-family: $body-font-family;
-  font-size: $font-size-2xs;
-  font-weight: $font-weight-medium;
-  color: var(--pa-text-color-1);
-  background-color: $secondary-light-bg;
-  border: $border-width-base solid var(--pa-border-color);
-  border-radius: $border-radius-sm;
-  box-shadow: 0 1px 1px rgba(0, 0, 0, 0.05);
-}
-
-.pa-shortcut-help__separator {
-  color: var(--pa-text-color-2);
-  font-size: $font-size-xs;
-}
-
-.pa-shortcut-help__description {
-  color: var(--pa-text-color-1);
-  font-size: $font-size-sm;
-}
-
-.pa-shortcut-help__empty {
-  text-align: center;
-  color: var(--pa-text-color-2);
-  padding: $spacing-xl;
-}
+/* ========================================
+   Command Palette Component
+   macOS Spotlight-style search with context switching
+   ======================================== */
+@use '../variables' as *;
+
+.pa-command-palette {
+  position: fixed;
+  inset: 0; // RTL: full screen works in both directions
+  z-index: $z-index-command-palette;
+  display: none;
+  align-items: flex-start;
+  justify-content: center;
+  padding-top: $command-palette-offset-top;
+
+  &--active {
+    display: flex;
+  }
+
+  // Backdrop overlay
+  &__backdrop {
+    position: absolute;
+    inset: 0; // RTL: full screen works in both directions
+    background-color: var(--pa-command-palette-backdrop-bg);
+    backdrop-filter: blur($command-palette-backdrop-blur);
+    animation: fadeIn $transition-normal $easing-smooth;
+  }
+
+  // Main container
+  &__container {
+    position: relative;
+    width: 100%;
+    max-width: $command-palette-width;
+    background-color: var(--pa-modal-content-bg);
+    border-radius: var(--pa-border-radius);
+    box-shadow: $command-palette-shadow;
+    animation: slideDown $transition-normal $easing-smooth;
+    overflow: hidden;
+  }
+
+  // Search input wrapper
+  &__search {
+    position: relative;
+    border-bottom: $border-width-base solid var(--pa-border-color);
+    padding: $spacing-sm;
+  }
+
+  // Tokens container (resolved query fragments)
+  &__tokens {
+    display: flex;
+    flex-wrap: wrap;
+    gap: $spacing-xs;
+    align-items: center;
+    margin-bottom: $spacing-sm;
+
+    &:empty {
+      display: none;
+      margin-bottom: 0;
+    }
+
+    .pa-badge {
+      display: inline-flex;
+      align-items: center;
+      margin: 0;
+
+      // Remove button inside badge
+      &__remove {
+        margin-inline-start: $spacing-xs; // RTL: flips to margin-right
+        padding: 0 $spacing-xs;
+        border: none;
+        background: transparent;
+        color: inherit;
+        cursor: pointer;
+        font-size: 1.2em;
+        line-height: 1;
+        opacity: 0.7;
+        transition: opacity $transition-fast $easing-smooth;
+
+        &:hover {
+          opacity: 1;
+        }
+      }
+    }
+  }
+
+  &__token-prompt {
+    font-size: $font-size-xs;
+    color: var(--pa-text-color-2);
+    font-style: italic;
+  }
+
+  &__input-wrapper {
+    position: relative;
+  }
+
+  &__input {
+    width: 100%;
+    height: $command-palette-input-height;
+    padding: $command-palette-input-padding-v $command-palette-input-padding-h;
+    font-size: $command-palette-input-font-size;
+    border: $border-width-base solid var(--pa-border-color);
+    border-radius: var(--pa-border-radius);
+    background-color: var(--pa-input-bg);
+    color: var(--pa-text-color-1);
+    outline: none;
+    transition: border-color $transition-fast $easing-snappy;
+
+    &:focus {
+      border-color: $input-focus-border-color;
+      box-shadow: 0 0 0 $focus-ring-width $accent-light;
+    }
+
+    &::placeholder {
+      color: var(--pa-text-color-2);
+      opacity: $opacity-muted;
+    }
+  }
+
+  // Context label (e.g., "Searching in Products") — positioned relative to input-wrapper
+  &__context {
+    position: absolute;
+    inset-inline-end: $command-palette-input-padding-h; // RTL: flips to left
+    top: 50%;
+    transform: translateY(-50%);
+    font-size: $font-size-xs;
+    color: var(--pa-accent);
+    font-weight: $font-weight-medium;
+    padding: $spacing-xs $spacing-sm;
+    background-color: var(--pa-accent-light);
+    border-radius: var(--pa-border-radius-sm);
+    opacity: 0;
+    transition: opacity $transition-fast $easing-smooth;
+
+    &--visible {
+      opacity: 1;
+    }
+  }
+
+  // Results container
+  &__results {
+    max-height: $command-palette-results-max-height;
+    overflow-y: auto;
+    padding: $spacing-sm 0;
+    position: relative;
+
+    // Loading state - show subtle opacity overlay
+    &--loading {
+      &::after {
+        content: '';
+        position: absolute;
+        inset: 0; // RTL: full overlay works in both directions
+        background-color: color-mix(in srgb, var(--pa-modal-content-bg) 70%, transparent);
+        pointer-events: none;
+        z-index: 1;
+      }
+    }
+  }
+
+  // Empty state
+  &__empty {
+    padding: $command-palette-empty-padding-v $command-palette-input-padding-h;
+    text-align: center;
+    color: var(--pa-text-color-2);
+    font-size: $font-size-sm;
+  }
+
+  // Loader
+  &__loader {
+    padding: $command-palette-empty-padding-v $command-palette-input-padding-h;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    gap: $spacing-sm;
+    color: var(--pa-text-color-2);
+    font-size: $font-size-sm;
+
+    .pa-spinner {
+      width: $spacing-base;
+      height: $spacing-base;
+    }
+  }
+
+  // Result item
+  &__item {
+    padding: $command-palette-item-padding-v $command-palette-input-padding-h;
+    cursor: pointer;
+    transition: background-color $transition-fast $easing-smooth;
+    display: flex;
+    align-items: center;
+    gap: $spacing-sm;
+
+    &:hover {
+      background-color: var(--pa-command-palette-item-hover-bg);
+    }
+
+    &--active {
+      background-color: var(--pa-command-palette-item-active-bg);
+    }
+  }
+
+  // Item icon
+  &__item-icon {
+    flex-shrink: 0;
+    width: $command-palette-item-icon-size;
+    height: $command-palette-item-icon-size;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    background-color: var(--pa-accent-light);
+    color: var(--pa-accent);
+    border-radius: var(--pa-border-radius-sm);
+    font-size: $font-size-sm;
+  }
+
+  // Item content
+  &__item-content {
+    flex: 1;
+    min-width: 0;
+  }
+
+  &__item-title {
+    font-size: $font-size-sm;
+    font-weight: $font-weight-medium;
+    color: var(--pa-text-color-1);
+    margin: 0;
+    white-space: nowrap;
+    overflow: hidden;
+    text-overflow: ellipsis;
+
+    mark {
+      background-color: var(--pa-command-palette-highlight-bg);
+      color: var(--pa-command-palette-highlight-text);
+      font-weight: $font-weight-semibold;
+      padding: 0 2px;
+      border-radius: var(--pa-border-radius-sm);
+    }
+  }
+
+  &__item-meta {
+    font-size: $font-size-xs;
+    color: var(--pa-text-color-2);
+    margin: 0;
+    margin-top: 2px;
+    white-space: nowrap;
+    overflow: hidden;
+    text-overflow: ellipsis;
+  }
+
+  // Item badge (e.g., category, status)
+
+  // Footer with keyboard hints
+  &__footer {
+    border-top: $border-width-base solid var(--pa-border-color);
+    padding: $spacing-sm $command-palette-input-padding-h;
+    display: flex;
+    gap: $spacing-base;
+    font-size: $font-size-xs;
+    color: var(--pa-text-color-2);
+  }
+
+  &__hint {
+    display: flex;
+    align-items: center;
+    gap: $spacing-xs;
+  }
+
+  &__key {
+    padding: 2px $spacing-xs;
+    background-color: var(--pa-command-palette-key-bg);
+    color: var(--pa-command-palette-key-text);
+    border: $border-width-base solid var(--pa-border-color);
+    border-radius: var(--pa-border-radius-sm);
+    font-family: $body-font-family;
+    font-weight: $font-weight-medium;
+    font-size: $font-size-2xs;
+    line-height: 1;
+  }
+
+  // Section headers (for grouping results)
+  &__section {
+    padding: $spacing-sm $command-palette-input-padding-h $spacing-xs;
+    font-size: $font-size-xs;
+    font-weight: $font-weight-semibold;
+    color: var(--pa-text-color-2);
+    text-transform: uppercase;
+    letter-spacing: 0.5px;
+  }
+
+  // Pagination indicator
+  &__pagination {
+    padding: $spacing-xs $command-palette-input-padding-h;
+    text-align: center;
+    font-size: $font-size-xs;
+    color: var(--pa-text-color-2);
+    border-top: $border-width-base solid var(--pa-border-color);
+  }
+}
+
+// Animations
+@keyframes fadeIn {
+  from {
+    opacity: 0;
+  }
+  to {
+    opacity: 1;
+  }
+}
+
+@keyframes slideDown {
+  from {
+    opacity: 0;
+    transform: translateY(-20px);
+  }
+  to {
+    opacity: 1;
+    transform: translateY(0);
+  }
+}
+
+// Responsive
+@media (max-width: $mobile-breakpoint) {
+  .pa-command-palette {
+    padding-top: $spacing-base;
+
+    &__container {
+      max-width: calc(100% - #{$spacing-base * 2});
+    }
+
+    &__results {
+      max-height: 60vh;
+    }
+  }
+}
+
+/* ========================================
+   Navbar Search Trigger
+   Button that opens the command palette
+   ======================================== */
+
+.pa-navbar-search {
+  display: flex;
+  align-items: center;
+  gap: $spacing-sm;
+  padding: $input-padding-v $input-padding-h;
+  background-color: var(--pa-input-bg);
+  border: $border-width-base solid var(--pa-border-color);
+  border-radius: var(--pa-border-radius);
+  cursor: pointer;
+  transition: border-color $transition-fast $easing-snappy;
+
+  &:hover {
+    border-color: $input-focus-border-color;
+  }
+
+  &:focus {
+    outline: none;
+    border-color: $input-focus-border-color;
+    box-shadow: 0 0 0 $focus-ring-width $accent-light;
+  }
+
+  // Size modifiers (matching input sizes)
+  &--xs {
+    height: #{$base-input-size-xs-height}rem;
+    font-size: $font-size-xs;
+  }
+
+  &--sm {
+    height: #{$base-input-size-sm-height}rem;
+    font-size: $font-size-xs;
+  }
+
+  &--md {
+    height: #{$base-input-size-md-height}rem;
+    font-size: $font-size-sm;
+  }
+
+  &--lg {
+    height: #{$base-input-size-lg-height}rem;
+    font-size: $font-size-base;
+  }
+
+  &--xl {
+    height: #{$base-input-size-xl-height}rem;
+    font-size: $font-size-lg;
+  }
+
+  &__icon {
+    flex-shrink: 0;
+    opacity: $opacity-muted;
+  }
+
+  &__placeholder {
+    flex: 1;
+    color: var(--pa-text-color-2);
+    white-space: nowrap;
+    overflow: hidden;
+    text-overflow: ellipsis;
+  }
+
+  &__shortcut {
+    display: flex;
+    align-items: center;
+    gap: 2px;
+    flex-shrink: 0;
+
+    kbd {
+      display: inline-flex;
+      align-items: center;
+      justify-content: center;
+      min-width: 2rem;
+      height: 2rem;
+      padding: 0 $spacing-xs;
+      font-family: $body-font-family;
+      font-size: $font-size-2xs;
+      font-weight: $font-weight-medium;
+      color: var(--pa-text-color-2);
+      background-color: var(--pa-subtle-bg);
+      border: $border-width-base solid var(--pa-border-color);
+      border-radius: var(--pa-border-radius-sm);
+      box-shadow: 0 1px 1px rgba(0, 0, 0, 0.05);
+    }
+  }
+}
+
+// Responsive: hide shortcut on small screens
+@media (max-width: $mobile-breakpoint) {
+  .pa-navbar-search {
+    &__placeholder {
+      display: none;
+    }
+
+    &__shortcut {
+      display: none;
+    }
+  }
+}
+
+/* ========================================
+   Shortcut Help Dialog
+   Modal content for displaying keyboard shortcuts
+   ======================================== */
+
+.pa-shortcut-help {
+  display: flex;
+  flex-direction: column;
+  gap: $spacing-base;
+}
+
+.pa-shortcut-help__category {
+  display: flex;
+  flex-direction: column;
+  gap: $spacing-xs;
+}
+
+.pa-shortcut-help__category-title {
+  font-size: $font-size-xs;
+  font-weight: $font-weight-semibold;
+  text-transform: uppercase;
+  letter-spacing: 0.5px;
+  color: var(--pa-text-color-2);
+  margin: 0;
+  padding-bottom: $spacing-xs;
+  border-bottom: $border-width-base solid var(--pa-border-color);
+}
+
+.pa-shortcut-help__list {
+  display: flex;
+  flex-direction: column;
+  gap: $spacing-xs;
+}
+
+.pa-shortcut-help__item {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: $spacing-base;
+  padding: $spacing-xs 0;
+}
+
+.pa-shortcut-help__keys {
+  display: flex;
+  align-items: center;
+  gap: $spacing-xs;
+  flex-shrink: 0;
+}
+
+.pa-shortcut-help__key {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  min-width: $spacing-lg;
+  height: $spacing-lg;
+  padding: 0 $spacing-xs;
+  font-family: $body-font-family;
+  font-size: $font-size-2xs;
+  font-weight: $font-weight-medium;
+  color: var(--pa-text-color-1);
+  background-color: var(--pa-subtle-bg);
+  border: $border-width-base solid var(--pa-border-color);
+  border-radius: var(--pa-border-radius-sm);
+  box-shadow: 0 1px 1px rgba(0, 0, 0, 0.05);
+}
+
+.pa-shortcut-help__separator {
+  color: var(--pa-text-color-2);
+  font-size: $font-size-xs;
+}
+
+.pa-shortcut-help__description {
+  color: var(--pa-text-color-1);
+  font-size: $font-size-sm;
+}
+
+.pa-shortcut-help__empty {
+  text-align: center;
+  color: var(--pa-text-color-2);
+  padding: $spacing-xl;
+}