/* TODO: Review box-shadow values - consider using design system shadow variables (--shadow-xs, --shadow-sm, etc.) */
/**
 * UI/UX Clarity Enhancement Styles
 * High ROI Improvement - UI/UX Clarity (ROI: 1.67)
 */

/* ============================================
   ACTION PROMPTS
   ============================================ */

.action-prompt-indicator {
    display: inline-block;
    margin-left: 0.5rem;
    font-size: 0.9em;
    opacity: 0.7;
    transition: opacity 0.2s;

button:hover .action-prompt-indicator {
    opacity: 1;

/* ============================================
   INPUT HELPER TEXT
   ============================================ */

.input-helper-text {
    font-size: 0.85em;
    color: var(--color-text-secondary, var(--color-text-secondary));
    margin-top: 0.5rem;
    padding: 0.5rem;
    background: rgba(74, 144, 226, 0.1);
    border-radius: var(--radius-sm);
    border-left: calc(var(--spacing-xs) * 0.75) solid var(--color-info, #4a90e2);

/* ============================================
   CONTEXTUAL HELP
   ============================================ */

.contextual-help-trigger {
    background: transparent;
    border: none;
    color: var(--color-info, #4a90e2);
    font-size: 1em;
    cursor: pointer;
    padding: 0.25rem 0.5rem;
    border-radius: var(--radius-full);
    transition: all 0.2s;
    margin-left: 0.5rem;
    opacity: 0.6;

.contextual-help-trigger:hover {
    opacity: 1;
    background: rgba(74, 144, 226, 0.2);
    transform: scale(1.1);

.contextual-help-tooltip {
    position: fixed;
    z-index: 10000;
    max-width: 304px;
    background: var(--color-bg-card, var(--color-bg-card));
    border: 2px solid var(--color-info, #4a90e2);
    border-radius: var(--radius-md);
    box-shadow: 0 8px 24px rgba(var(--color-bg-primary-rgb, 26, 26, 26), 0.4);
    animation: tooltipFadeIn 0.3s ease-out;

.help-tooltip-content {
    padding: 1rem;
    position: relative;

.help-tooltip-close {
    position: absolute;
    top: 0.5rem;
    right: 0.5rem;
    background: transparent;
    border: none;
    color: var(--color-text-secondary, var(--color-text-secondary));
    font-size: 1.5em;
    cursor: pointer;
    line-height: 1;
    padding: 0;
    width: var(--spacing-lg);
    height: var(--spacing-lg);
    display: flex;
    align-items: center;
    justify-content: center;
    border-radius: var(--radius-full);
    transition: all 0.2s;

.help-tooltip-close:hover {
    background: rgba(var(--color-text-primary-rgb, 224, 224, 224), 0.1);
    color: var(--color-text-primary, var(--color-text-primary));

.help-tooltip-text {
    color: var(--color-text-primary, var(--color-text-primary));
    line-height: 1.6;
    margin-top: 0.5rem;

@keyframes tooltipFadeIn {
    from {
        opacity: 0;
        transform: translateX(-10px);

    to {
        opacity: 1;
        transform: translateX(0);

/* ============================================
   VISUAL HIERARCHY
   ============================================ */

.action-group {
    display: flex;
    flex-direction: column;
    gap: 0.75rem;
    padding: 1rem;
    background: rgba(74, 144, 226, 0.05);
    border-radius: var(--radius-md);
    border: 1px solid rgba(74, 144, 226, 0.2);
    margin-bottom: 1rem;

.action-group::before {
    content: attr(data-group-label);
    font-size: 0.85em;
    font-weight: 600;
    color: var(--color-info, #4a90e2);
    text-transform: uppercase;
    letter-spacing: 0.05em;
    margin-bottom: 0.5rem;

.primary-action-highlighted {
    position: relative;
    font-weight: 700 !important;
    box-shadow: 0 4px 12px rgba(74, 144, 226, 0.3) !important;
    border: 2px solid var(--color-info, #4a90e2) !important;

.primary-action-highlighted::after {
    content: '⭐';
    position: absolute;
    top: -var(--spacing-sm);
    right: -var(--spacing-sm);
    font-size: 0.8em;
    background: var(--color-bg-primary, var(--color-bg-primary));
    padding: calc(var(--spacing-xs) / 2) var(--spacing-xs);
    border-radius: var(--radius-full);

.collapsible-section {
    max-height: 200px;
    overflow: hidden;
    transition: max-height 0.3s ease;

.collapsible-section.expanded {
    max-height: none;

/* ============================================
   QUICK ACTION HELPER
   ============================================ */

.quick-action-helper {
    position: relative;
    display: inline-block;

.helper-trigger {
    background: var(--color-info, #4a90e2);
    color: white;
    border: none;
    padding: 0.5rem 1rem;
    border-radius: calc(var(--radius-sm) * 1.5);
    cursor: pointer;
    font-size: 0.9em;
    font-weight: 600;
    transition: all 0.2s;
    box-shadow: 0 2px 8px rgba(74, 144, 226, 0.3);

.helper-trigger:hover {
    background: var(--color-info-hover, #5ba0f2);
    transform: translateY(-2px);
    box-shadow: 0 4px 12px rgba(74, 144, 226, 0.4);

.helper-content {
    position: absolute;
    top: 100%;
    right: 0;
    margin-top: 0.5rem;
    background: var(--color-bg-card, var(--color-bg-card));
    border: 2px solid var(--color-info, #4a90e2);
    border-radius: var(--radius-md);
    padding: 1rem;
    min-width: 248px;
    max-width: 400px;
    box-shadow: 0 8px 24px rgba(var(--color-bg-primary-rgb, 26, 26, 26), 0.4);
    z-index: 1000;
    animation: slideDown 0.3s ease-out;

.helper-content h4 {
    margin: 0 0 0.75rem 0;
    color: var(--color-info, #4a90e2);
    font-size: 1em;
    text-transform: uppercase;
    letter-spacing: 0.05em;

.helper-content ul {
    list-style: none;
    padding: 0;
    margin: 0;

.helper-content li {
    padding: 0.5rem 0;
    color: var(--color-text-primary, var(--color-text-primary));
    border-bottom: 1px solid rgba(var(--color-text-primary-rgb, 224, 224, 224), 0.1);
    font-size: 0.9em;

.helper-content li:last-child {
    border-bottom: none;

.shortcut-hint {
    float: right;
    color: var(--color-text-secondary, var(--color-text-secondary));
    font-size: 0.85em;
    font-family: var(--font-mono, 'Roboto Mono', monospace);

@keyframes slideDown {
    from {
        opacity: 0;
        transform: translateY(-10px);

    to {
        opacity: 1;
        transform: translateY(0);

/* ============================================
   KEYBOARD SHORTCUT HINT
   ============================================ */

.keyboard-shortcut-hint {
    display: inline-block;
    padding: 0.5rem 1rem;
    background: rgba(74, 144, 226, 0.1);
    border: 1px solid rgba(74, 144, 226, 0.3);
    border-radius: calc(var(--radius-sm) * 1.5);
    color: var(--color-text-secondary, var(--color-text-secondary));
    font-size: 0.85em;
    cursor: pointer;
    transition: all 0.2s;
    margin-left: 1rem;

.keyboard-shortcut-hint:hover {
    background: rgba(74, 144, 226, 0.2);
    color: var(--color-text-primary, var(--color-text-primary));
    border-color: var(--color-info, #4a90e2);

.keyboard-shortcut-hint kbd {
    background: var(--color-bg-primary, var(--color-bg-primary));
    border: 1px solid var(--color-border, #444);
    border-radius: calc(var(--radius-sm) * 0.75);
    padding: calc(var(--spacing-xs) / 2) calc(var(--spacing-xs) * 1.5);
    font-family: var(--font-mono, 'Roboto Mono', monospace);
    font-size: 0.9em;
    margin: 0 calc(var(--spacing-xs) / 2);
    box-shadow: 0 1px 2px rgba(var(--color-bg-primary-rgb, 26, 26, 26), 0.3);

/* ============================================
   ENHANCED BUTTON LABELS
   ============================================ */

button.has-clear-label {
    position: relative;

button.has-clear-label::after {
    content: attr(title);
    position: absolute;
    bottom: 100%;
    left: 50%;
    transform: translateX(-50%);
    background: var(--color-bg-card, var(--color-bg-card));
    color: var(--color-text-primary, var(--color-text-primary));
    padding: 0.5rem 0.75rem;
    border-radius: var(--radius-sm);
    font-size: 0.85em;
    white-space: nowrap;
    opacity: 0;
    pointer-events: none;
    transition: opacity 0.2s;
    margin-bottom: 0.5rem;
    border: 1px solid var(--color-border, #444);
    box-shadow: 0 4px 8px rgba(var(--color-bg-primary-rgb, 26, 26, 26), 0.3);
    z-index: 1000;

button.has-clear-label:hover::after {
    opacity: 1;

/* ============================================
   RESPONSIVE
   ============================================ */

@media (max-width: 768px) {
    .helper-content {
        right: auto;
        left: 0;
        min-width: 200px;

    .contextual-help-tooltip {
        max-width: 248px;
        left: 1rem !important;
        right: 1rem !important;

    .keyboard-shortcut-hint {
        display: none;

}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}