/**
 * Knowledge Base Styles
 *
 * Custom styles for Heroic Knowledge Base integration with Sparkplug theme.
 * These styles enhance the KB plugin's block-based templates with gradient
 * effects, category cards, and cohesive design system integration.
 *
 * Design Principles:
 * - All spacing uses --sprk-space-* tokens for automatic responsive behavior
 * - Three gradient themes (warm/cool/vibrant) for Core/Account/Add-ons sections
 * - Hover effects use gradient shadows coordinated with card colors
 * - No manual breakpoints - relies on design token scaling
 *
 * Sections:
 * - Layout & Structure
 * - Category Cards & Grid Layout
 * - Search Interface
 * - Article Lists
 * - Breadcrumbs & Navigation
 * - Changelog Feed
 * - Category Archive Template
 * - Single Article Template
 */

/* ==========================================================================
   Layout & Structure
   ========================================================================== */

/**
 * Search section with dark background - 2 column layout
 */
.nf-spark-kb-search-section {
    display: grid;
    grid-template-columns: 1.5fr 1fr;
    gap: var(--sprk-space-6);
    background: var(--sprk-color-background-dark);
    padding: 0 var(--sprk-space-7);
    margin-bottom: var(--sprk-space-8);
    border-radius: var(--sprk-radius-lg);
    overflow: hidden;
}

@media (max-width: 768px) {
    .nf-spark-kb-search-section {
        grid-template-columns: 1fr;
    }
}

.nf-spark-kb-hero__search {
    display: flex;
    flex-direction: column;
    justify-content: center;
    padding: var(--sprk-space-6) 0;
}

/* Hide "Search for:" label text */
.nf-spark-kb-hero__search label {
    display: none;
}

/* Override plugin search styles and make search input full width */
.nf-spark-kb-hero__search .hkb-site-search {
    max-width: none;
    margin: 0;
    position: relative;
}

.nf-spark-kb-hero__search input[type="text"] {
    width: 100%;
    font-size: var(--sprk-font-size-lg);
}

/* Darker placeholder text for better visibility */
.nf-spark-kb-hero__search input[type="text"]::placeholder {
    color: var(--sprk-color-text-secondary);
    opacity: 0.7;
}

.nf-spark-kb-hero__search input[type="text"]::-webkit-input-placeholder {
    color: var(--sprk-color-text-secondary);
    opacity: 0.7;
}

.nf-spark-kb-hero__search input[type="text"]::-moz-placeholder {
    color: var(--sprk-color-text-secondary);
    opacity: 0.7;
}

.nf-spark-kb-hero__search input[type="text"]:-ms-input-placeholder {
    color: var(--sprk-color-text-secondary);
    opacity: 0.7;
}

/* Position search icon on the right side, vertically centered */
.hkb-site-search__icon {
    position: absolute;
    right: var(--sprk-space-2);
    top: 50%;
    transform: translateY(-50%);
    width: 20px;
    height: 20px;
    fill: var(--sprk-color-text-muted);
    pointer-events: none;
}

/**
 * Peeking ninja container and SVG
 */
.nf-spark-kb-peeker-container {
    display: flex;
    align-items: flex-end;
    justify-content: flex-end;
}

.nf-spark-kb-peeker {
    width: 100%;
    height: auto;
    max-width: 512px;
    pointer-events: none;
}

@media (max-width: 768px) {
    .nf-spark-kb-peeker-container {
        display: none;
    }
}

/**
 * Popular article pills - solid light background with dark text
 */
.nf-spark-kb-popular-pills-wrapper {
    margin-top: var(--sprk-space-4);
}

.nf-spark-kb-popular-pills-label {
    color: var(--sprk-color-text-inverse);
    font-weight: var(--sprk-font-weight-regular);
    opacity: 0.7;
    margin: 0 0 var(--sprk-space-2) 0;
}

.nf-spark-kb-popular-pills {
    display: flex;
    flex-wrap: wrap;
    gap: var(--sprk-space-2);
}

a.nf-spark-kb-pill {
    display: inline-block;
    padding: var(--sprk-space-1) var(--sprk-space-2);
    background: var(--sprk-color-text-primary);
    border: none;
    border-radius: var(--sprk-radius-full);
    font-size: var(--sprk-font-size-sm);
    text-decoration: none;
    transition: all var(--sprk-transition-fast);
    color: var(--sprk-color-text-inverse);
}

a.nf-spark-kb-pill:visited {
    background: var(--sprk-color-text-primary);
    color: var(--sprk-color-text-inverse);
}

a.nf-spark-kb-pill:hover {
    background: var(--global-palette4);
    color: var(--global-palette7);
}

/**
 * Main container
 */
.nf-spark-kb-container {
    max-width: 1200px;
    margin: 0 auto;
    padding: 0 var(--sprk-space-4);
}

/**
 * KB sections
 */
.nf-spark-kb-main {
    padding: var(--sprk-space-3) 0 var(--sprk-space-8);
}

.nf-spark-kb-section {
    margin-bottom: var(--sprk-space-8);
}

.nf-spark-kb-section__title {
    font-size: var(--sprk-font-size-3xl);
    font-weight: var(--sprk-font-weight-bold);
    margin-bottom: var(--sprk-space-2);
}

.nf-spark-kb-section__description {
    font-size: var(--sprk-font-size-xl);
    line-height: var(--sprk-line-height-snug);
    color: var(--sprk-color-text-muted);
    margin-top: 0;
    margin-bottom: var(--sprk-space-4);
}

.nf-spark-kb-section__content {
    display: grid;
    grid-template-columns: 2fr 3fr;
    gap: var(--sprk-space-8);
}

@media (max-width: 768px) {
    .nf-spark-kb-section__content {
        grid-template-columns: 1fr;
    }
}

/**
 * Popular Topics sidebar
 */
.nf-spark-kb-popular__title {
    font-size: var(--sprk-font-size-base);
    margin-bottom: var(--sprk-space-3);
}

.nf-spark-kb-popular__list {
    display: flex;
    flex-direction: column;
}

.nf-spark-kb-popular__item {
    display: flex;
    gap: var(--sprk-space-2);
    padding: var(--sprk-space-2) 0;
    text-decoration: none;
    border-bottom: 1px solid var(--sprk-color-border);
}

.nf-spark-kb-popular__item:hover .nf-spark-kb-popular__icon {
    color: var(--sprk-color-text-secondary);
}

.nf-spark-kb-popular__item:hover .nf-spark-kb-popular__item-title {
    text-decoration: underline;
    text-decoration-color: var(--sprk-color-accent-hover);
}

.nf-spark-kb-popular__icon {
    flex-shrink: 0;
    width: var(--sprk-space-4);
    height: var(--sprk-space-4);
    color: var(--sprk-color-text-primary);
    transition: color 0.2s ease;
}

.nf-spark-kb-popular__icon svg {
    width: 100%;
    height: 100%;
    display: block;
}

.nf-spark-kb-popular__content {
    flex: 1;
    min-width: 0;
}

.nf-spark-kb-popular__item-title {
    font-size: var(--sprk-font-size-xl);
    font-weight: var(--sprk-font-weight-regular);
    margin: 0 0 var(--sprk-space-1) 0;
    line-height: var(--sprk-line-height-tight);
    color: var(--sprk-color-text-primary);
    text-decoration: underline;
    text-decoration-color: transparent;
    text-underline-offset: 0.36em;
    transition: text-decoration-color 0.2s ease;
}

.nf-spark-kb-popular__item-excerpt {
    font-size: var(--sprk-font-size-base);
    color: var(--sprk-color-text-muted);
    margin: 0;
    line-height: var(--sprk-line-height-base);
}


/**
 * Changelog section
 */
.nf-spark-kb-changelog {
    margin-top: var(--sprk-space-8);
    padding-top: var(--sprk-space-6);
    border-top: 2px solid var(--sprk-color-border);
}

.nf-spark-kb-changelog__title {
    font-size: var(--sprk-font-size-2xl);
    font-weight: var(--sprk-font-weight-bold);
    margin-bottom: var(--sprk-space-3);
}

.nf-spark-kb-changelog__note {
    color: var(--sprk-color-text-muted);
    font-style: italic;
}

/* ==========================================================================
   Category Cards & Grid Layout
   ========================================================================== */

/**
 * Category card base styles
 *
 * Cards are white with borders, showing subtle gradient shadow effects on hover.
 * Uses ::before pseudo-element for gradient shadow effect.
 * Inner wrapper contains all visual styling and content.
 */
.nf-spark-kb-card {
    position: relative;
    text-decoration: none;
    height: 100%;
}

.nf-spark-kb-card::before {
    content: '';
    position: absolute;
    inset: 0;
    border-radius: var(--sprk-radius-md);
    opacity: 0;
    transition: opacity var(--sprk-transition-base);
    z-index: 0;
    filter: blur(8px);
}

.nf-spark-kb-card__inner {
    display: flex;
    flex-direction: column;
    height: 100%;
    padding: var(--sprk-space-4);
    border-radius: var(--sprk-radius-base);
    background: var(--sprk-color-background);
    border: 1px solid var(--sprk-color-border);
    position: relative;
    z-index: 1;
    transition: border-color var(--sprk-transition-base);
}

.nf-spark-kb-card:hover {
    text-decoration: none;
}

.nf-spark-kb-card:hover::before {
    opacity: 0.5;
}

.nf-spark-kb-card:hover .nf-spark-kb-card__icon {
    opacity: 1;
}

/**
 * Gradient shadow and border variants on hover
 *
 * Two targeting approaches for the same three themes:
 *
 * 1. Card modifier classes (--warm/--cool/--vibrant)
 *    Used by taxonomy-ht_kb_category.php where variant class is set per-card.
 *
 * 2. Section slug selectors (.nf-spark-kb-section--{slug})
 *    Used by template-knowledge-base.php (index page). Cards carry no variant
 *    class — theming is inherited from the parent section via slug class.
 *    Add a new block here when a new top-level KB category is created.
 *
 * Gradient variables: --sprk-gradient-warm / -cool / -vibrant (design-tokens.css)
 * Icon accent colours: warm #ef4748 | cool #1551dd | vibrant #911ad4
 */

/* --- Card modifier classes (taxonomy archive) --- */
.nf-spark-kb-card--warm::before {
    background: var(--sprk-gradient-warm);
}

.nf-spark-kb-card--warm:hover .nf-spark-kb-card__inner {
    border-color: transparent;
}

.nf-spark-kb-card--cool::before {
    background: var(--sprk-gradient-cool);
}

.nf-spark-kb-card--cool:hover .nf-spark-kb-card__inner {
    border-color: transparent;
}

.nf-spark-kb-card--vibrant::before {
    background: var(--sprk-gradient-vibrant);
}

.nf-spark-kb-card--vibrant:hover .nf-spark-kb-card__inner {
    border-color: transparent;
}

/* --- Section slug selectors (index page) --- */
.nf-spark-kb-section--core-plugin .nf-spark-kb-card::before {
    background: var(--sprk-gradient-warm);
}

.nf-spark-kb-section--core-plugin .nf-spark-kb-card:hover .nf-spark-kb-card__inner {
    border-color: transparent;
}

.nf-spark-kb-section--core-plugin .nf-spark-kb-card__icon {
    background: var(--sprk-gradient-warm);
}

.nf-spark-kb-section--account-management .nf-spark-kb-card::before {
    background: var(--sprk-gradient-cool);
}

.nf-spark-kb-section--account-management .nf-spark-kb-card:hover .nf-spark-kb-card__inner {
    border-color: transparent;
}

.nf-spark-kb-section--account-management .nf-spark-kb-card__icon {
    background: var(--sprk-gradient-cool);
}

.nf-spark-kb-section--add-ons .nf-spark-kb-card::before {
    background: var(--sprk-gradient-vibrant);
}

.nf-spark-kb-section--add-ons .nf-spark-kb-card:hover .nf-spark-kb-card__inner {
    border-color: transparent;
}

.nf-spark-kb-section--add-ons .nf-spark-kb-card__icon {
    background: var(--sprk-gradient-vibrant);
}

/**
 * Card content elements
 */
.nf-spark-kb-card__icon {
    width: var(--sprk-space-6);
    height: var(--sprk-space-6);
    margin-bottom: var(--sprk-space-3);
    mask-image: url('../icons/svg/user-manual.svg');
    mask-size: contain;
    mask-repeat: no-repeat;
    mask-position: center;
    -webkit-mask-image: url('../icons/svg/user-manual.svg');
    -webkit-mask-size: contain;
    -webkit-mask-repeat: no-repeat;
    -webkit-mask-position: center;
    opacity: 0.65;
    transition: opacity var(--sprk-transition-fast);
}

.nf-spark-kb-card__title {
    font-size: var(--sprk-font-size-lg);
    font-weight: var(--sprk-font-weight-regular);
    line-height: var(--sprk-line-height-tight);
    margin-bottom: var(--sprk-space-2);
}

.nf-spark-kb-card__description {
    font-size: var(--sprk-font-size-base);
    line-height: var(--sprk-line-height-base);
    color: var(--sprk-color-text-muted);
    margin-top: 0;
    flex: 1;
}

.nf-spark-kb-card__meta {
    position: absolute;
    top: var(--sprk-space-4);
    right: var(--sprk-space-4);
    display: flex;
    align-items: center;
    justify-content: center;
    gap: var(--sprk-space-1);
    min-width: var(--sprk-space-5);
    min-height: var(--sprk-space-5);
    padding: var(--sprk-space-1) var(--sprk-space-2);
    background: var(--sprk-color-background-muted);
    color: var(--sprk-color-text-muted);
    border-radius: var(--sprk-radius-full);
    font-size: var(--sprk-font-size-sm);
    letter-spacing: 0.025em;
    line-height: 1;
    margin: var(--sprk-space-0-5) 0;
}

.nf-spark-kb-card__meta-label {
    display: none;
}

.nf-spark-kb-card__link {
    font-size: var(--sprk-font-size-sm);
    font-weight: var(--sprk-font-weight-bold);
    color: var(--sprk-color-brand-red);
    text-decoration: underline;
    margin-top: auto;
}

/**
 * Category card grid
 *
 * 2-column grid using design token spacing.
 * Kadence handles responsive breakpoints automatically.
 */
.nf-spark-kb-grid {
    display: grid;
    align-content: start;
    grid-template-columns: repeat(2, 1fr);
    gap: var(--sprk-space-2);
    margin-bottom: var(--sprk-space-8);
}

/* Single column on narrow viewports (handled by Kadence) */
@media (max-width: 768px) {
    .nf-spark-kb-grid {
        grid-template-columns: 1fr;
    }
}

/* ==========================================================================
   Search Interface
   ========================================================================== */

/**
 * Live search dropdown z-index
 *
 * Ensures the AJAX live search results dropdown appears above other elements.
 */
body #hkb-jquery-live-search {
    z-index: 10;
    margin-top: -1px;
    margin-left: 1px;
}

ul.hkb-searchresults {
    margin: 0;
    list-style: none;
}

.hkb-searchresults__article,
.hkb-searchresults__noresults,
.hkb-searchresults__showall {
    padding: var(--sprk-space-1) var(--sprk-space-3);
}

.hkb-searchresults__noresults,
.hkb-searchresults__showall {
    font-size: var(--sprk-font-size-sm);
}

.hkb-searchresults__article a {
    text-decoration: none;
}

.hkb-searchresults__excerpt {
    display: block;
    font-size: var(--sprk-font-size-sm);
    color: var(--sprk-color-text-secondary);
    line-height: var(--sprk-line-height-snug);
}

.hkb-searchresults__title {
    display: block;
    font-weight: var(--sprk-font-weight-bold);
}

.hkb-searchresults__showall {
    font-size: var(--sprk-font-size-sm);
    text-align: right;
}

/**
 * Plugin search form styling
 *
 * Styles for Heroic KB native search form (hkb-site-search).
 * Fixes icon sizing and integrates with hero section.
 */
.hkb-site-search {
    position: relative;
    max-width: 700px;
    margin: 0 auto;
}

.hkb-site-search__field {
    width: 100%;
    padding: var(--sprk-space-3) var(--sprk-space-12) var(--sprk-space-3) var(--sprk-space-4);
    border: 2px solid var(--sprk-color-border);
    transition: border-color var(--sprk-transition-fast);
}

.hkb-site-search__field:focus {
    outline: none;
    border-color: var(--sprk-color-brand-red);
}

.hkb-site-search__button {
    position: absolute;
    right: var(--sprk-space-2);
    top: 50%;
    transform: translateY(-50%);
    background: transparent;
    border: none;
    cursor: pointer;
    padding: var(--sprk-space-2);
    display: flex;
    align-items: center;
    justify-content: center;
}

.hkb-site-search__button span {
    position: absolute;
    width: 1px;
    height: 1px;
    padding: 0;
    margin: -1px;
    overflow: hidden;
    clip: rect(0,0,0,0);
    white-space: nowrap;
    border-width: 0;
}

.hkb-site-search__icon {
    width: 24px;
    height: 24px;
    fill: var(--sprk-color-text-muted);
    transition: fill var(--sprk-transition-fast);
}

.hkb-site-search__button:hover .hkb-site-search__icon {
    fill: var(--sprk-color-brand-red);
}

/**
 * Search button fixes for wp-site-blocks context
 * Removes unwanted transforms and styling that misalign the button
 */
.wp-site-blocks #hkb .hkb-site-search .hkb-site-search__button,
.wp-site-blocks #hkb .hkb-site-search .hkb-site-search__button:hover {
    transform: none;
    box-shadow: none;
    background: transparent;
    border: none;
}

/**
 * Search field padding fixes for wp-site-blocks context
 * Uses design tokens with fixed right padding for icon space
 */
.wp-site-blocks #hkb .hkb-site-search .hkb-site-search__field {
    padding: var(--sprk-space-1) 60px var(--sprk-space-1) var(--sprk-space-3);
}

/**
 * KB search bar styling
 *
 * Enhanced search interface with category filter integration.
 */
.nf-spark-kb-search {
    margin-bottom: var(--sprk-space-6);
}

.nf-spark-kb-search__input {
    width: 100%;
    padding: var(--sprk-space-3);
    border: 2px solid var(--sprk-color-border);
    transition: border-color var(--sprk-transition-fast);
}

.nf-spark-kb-search__input:focus {
    outline: none;
    border-color: var(--sprk-color-accent);
    box-shadow: 0 0 0 3px rgba(239, 71, 72, 0.1);
}

.nf-spark-kb-search__filters {
    display: flex;
    gap: var(--sprk-space-2);
    margin-top: var(--sprk-space-3);
    flex-wrap: wrap;
}

.nf-spark-kb-search__filter-btn {
    padding: var(--sprk-space-1) var(--sprk-space-2);
    font-size: var(--sprk-font-size-sm);
    border: 1px solid var(--sprk-color-border);
    background: var(--sprk-color-background);
    cursor: pointer;
    transition: all var(--sprk-transition-fast);
}

.nf-spark-kb-search__filter-btn:hover,
.nf-spark-kb-search__filter-btn--active {
    background: var(--sprk-color-accent);
    color: var(--sprk-color-text-inverse);
    border-color: var(--sprk-color-accent);
}

/* ==========================================================================
   Article Lists & Content
   ========================================================================== */

/**
 * Popular topics list
 */
.nf-spark-kb-popular {
    margin-bottom: var(--sprk-space-6);
}

.nf-spark-kb-popular__title {
    font-size: var(--sprk-font-size-lg);
    margin-bottom: var(--sprk-space-1);
}

.nf-spark-kb-popular__list {
    list-style: none;
    padding: 0;
    margin: 0;
}


.nf-spark-kb-popular__link {
    display: flex;
    align-items: center;
    justify-content: space-between;
    text-decoration: none;
    transition: color var(--sprk-transition-fast);
}

.nf-spark-kb-popular__link:hover {
    color: var(--sprk-color-accent);
}

.nf-spark-kb-popular__arrow {
    font-size: var(--sprk-font-size-sm);
    color: var(--sprk-color-text-muted);
    transition: transform var(--sprk-transition-fast);
}

.nf-spark-kb-popular__link:hover .nf-spark-kb-popular__arrow {
    transform: translateX(4px);
}

/**
 * Article list (category archives)
 */
.nf-spark-kb-article-list {
    list-style: none;
    padding: 0;
    margin: 0;
}

.nf-spark-kb-article-list__item {
    margin-bottom: var(--sprk-space-3);
    border: 1px solid var(--sprk-color-border);
    transition: border-color var(--sprk-transition-fast), box-shadow var(--sprk-transition-fast);
}

.nf-spark-kb-article-list__item:hover {
    border-color: var(--sprk-color-accent);
    box-shadow: var(--sprk-shadow-md);
}

.nf-spark-kb-article-list__title {
    font-weight: var(--sprk-font-weight-bold);
    margin-bottom: var(--sprk-space-1);
}

.nf-spark-kb-article-list__title a {
    text-decoration: none;
    transition: color var(--sprk-transition-fast);
}

.nf-spark-kb-article-list__title a:hover {
    color: var(--sprk-color-accent);
}

.nf-spark-kb-article-list__excerpt {
    font-size: var(--sprk-font-size-base);
    color: var(--sprk-color-text-secondary);
    line-height: var(--sprk-line-height-base);
}

/* ==========================================================================
   Breadcrumbs & Navigation
   ========================================================================== */

/**
 * Category sidebar navigation
 */
.nf-spark-kb-sidebar-nav__title {
    font-weight: var(--sprk-font-weight-bold);
    margin-bottom: var(--sprk-space-3);
}

.nf-spark-kb-sidebar-nav__list {
    list-style: none;
    padding: 0;
    margin: 0;
}

.nf-spark-kb-sidebar-nav__item {
    margin-bottom: var(--sprk-space-2);
}

.nf-spark-kb-sidebar-nav__link {
    color: var(--sprk-color-text-secondary);
    text-decoration: none;
    transition: color var(--sprk-transition-fast);
}

.nf-spark-kb-sidebar-nav__link:hover,
.nf-spark-kb-sidebar-nav__link--active {
    color: var(--sprk-color-accent);
}

/* ==========================================================================
   Changelog Feed
   ========================================================================== */

/**
 * Changelog list at bottom of KB index
 * Note: Automation deferred - manual entries for now
 */
.nf-spark-kb-changelog {
    margin-top: var(--sprk-space-8);
    padding-top: var(--sprk-space-6);
    border-top: 2px solid var(--sprk-color-border);
}

.nf-spark-kb-changelog__title {
    font-size: var(--sprk-font-size-xxl);
    font-weight: var(--sprk-font-weight-bold);
    margin-bottom: var(--sprk-space-4);
}

.nf-spark-kb-changelog__list {
    list-style: none;
    padding: 0;
    margin: 0;
}

.nf-spark-kb-changelog__item {
    padding: var(--sprk-space-3);
    margin-bottom: var(--sprk-space-2);
    border-left: 4px solid var(--sprk-color-accent);
}

.nf-spark-kb-changelog__version {
    font-size: var(--sprk-font-size-sm);
    font-weight: var(--sprk-font-weight-bold);
    color: var(--sprk-color-accent);
    margin-bottom: var(--sprk-space-1);
}

.nf-spark-kb-changelog__date {
    font-size: var(--sprk-font-size-xs);
    color: var(--sprk-color-text-muted);
    margin-bottom: var(--sprk-space-1);
}

.nf-spark-kb-changelog__description {
    font-size: var(--sprk-font-size-base);
    color: var(--sprk-color-text-secondary);
    line-height: var(--sprk-line-height-base);
}

/* ==========================================================================
   Category Archive Template (taxonomy-ht_kb_category.php)
   ========================================================================== */

/**
 * Category Archive Layout
 */
.nf-spark-kb-category-layout {
    max-width: var(--sprk-container-width);
    margin: 0 auto;
    display: grid;
    grid-template-columns: 1fr 380px;
    gap: var(--sprk-space-8);
}

@media (max-width: 1024px) {
    .nf-spark-kb-category-layout {
        grid-template-columns: 1fr;
    }
}

/**
 * Category Header
 */
.nf-spark-kb-category-header {
    margin-bottom: var(--sprk-space-6);
}

.nf-spark-kb-category-header__title {
    font-size: var(--sprk-font-size-4xl);
    font-weight: var(--sprk-font-weight-bold);
    margin: 0 0 var(--sprk-space-2) 0;
    line-height: var(--sprk-line-height-tight);
}

.nf-spark-kb-category-header__description {
    color: var(--sprk-color-text-muted);
    margin: 0;
    line-height: var(--sprk-line-height-base);
}

/**
 * Article List
 */
.nf-spark-kb-article-list {
    display: flex;
    flex-direction: column;
}

.nf-spark-kb-article-item {
    display: flex;
    gap: var(--sprk-space-3);
    padding: var(--sprk-space-4) 0;
    text-decoration: none;
    border-bottom: 1px solid var(--sprk-color-border);
    transition: all var(--sprk-transition-fast);
}

.nf-spark-kb-article-item:hover .nf-spark-kb-article-item__icon {
    color: var(--sprk-color-text-secondary);
}

.nf-spark-kb-article-item:hover .nf-spark-kb-article-item__title {
    text-decoration-color: var(--sprk-color-accent-hover);
}

.nf-spark-kb-article-item__icon {
    flex-shrink: 0;
    width: var(--sprk-space-5);
    height: var(--sprk-space-5);
    color: var(--sprk-color-text-primary);
    transition: color var(--sprk-transition-fast);
}

.nf-spark-kb-article-item__icon svg {
    width: 100%;
    height: 100%;
    display: block;
}

.nf-spark-kb-article-item__content {
    flex: 1;
    min-width: 0;
}

.nf-spark-kb-article-item__title {
    font-size: var(--sprk-font-size-xl);
    font-weight: var(--sprk-font-weight-regular);
    margin: 0 0 var(--sprk-space-1) 0;
    line-height: var(--sprk-line-height-tight);
    color: var(--sprk-color-text-primary);
    text-decoration: underline;
    text-decoration-color: transparent;
    text-underline-offset: 0.36em;
    transition: text-decoration-color var(--sprk-transition-fast);
}

.nf-spark-kb-article-item__excerpt {
    font-size: var(--sprk-font-size-base);
    color: var(--sprk-color-text-muted);
    margin: 0;
    line-height: var(--sprk-line-height-base);
}

.nf-spark-kb-no-articles {
    font-size: var(--sprk-font-size-base);
    color: var(--sprk-color-text-muted);
    padding: var(--sprk-space-6) 0;
    text-align: center;
}

/**
 * Category Sidebar
 */
.nf-spark-kb-category-sidebar {
    display: flex;
    flex-direction: column;
    gap: var(--sprk-space-6);
}

.nf-spark-kb-sidebar-section__title {
    display: none;
}

/**
 * Category Navigation (Sidebar)
 */
.nf-spark-kb-category-nav {
    display: flex;
    flex-direction: column;
    gap: var(--sprk-space-1);
}

.nf-spark-kb-category-nav__item {
    display: flex;
    align-items: center;
    gap: var(--sprk-space-2);
    padding: var(--sprk-space-1) var(--sprk-space-2);
    border: 1px solid var(--sprk-color-border);
    text-decoration: none;
    border-radius: var(--sprk-radius-sm);
    transition: all var(--sprk-transition-fast);
}

.nf-spark-kb-category-nav__item:hover {
    background: var(--sprk-color-background);
    border-color: var(--sprk-color-border-strong);
}

.nf-spark-kb-category-nav__item--active {
    background: var(--sprk-color-background);
}

.nf-spark-kb-category-nav__icon {
    flex-shrink: 0;
    width: var(--sprk-space-4);
    height: var(--sprk-space-4);
    mask-image: url('../icons/svg/user-manual.svg');
    mask-size: contain;
    mask-repeat: no-repeat;
    mask-position: center;
    -webkit-mask-image: url('../icons/svg/user-manual.svg');
    -webkit-mask-size: contain;
    -webkit-mask-repeat: no-repeat;
    -webkit-mask-position: center;
    opacity: 0.65;
    transition: opacity var(--sprk-transition-fast);
}

/* Gradient backgrounds for category icons */
.nf-spark-kb-category-nav__icon.nf-spark-kb-card--warm {
    background: var(--sprk-gradient-warm);
}

.nf-spark-kb-category-nav__icon.nf-spark-kb-card--cool {
    background: var(--sprk-gradient-cool);
}

.nf-spark-kb-category-nav__icon.nf-spark-kb-card--vibrant {
    background: var(--sprk-gradient-vibrant);
}

/* Icon opacity hover effect */
.nf-spark-kb-category-nav__item:hover .nf-spark-kb-category-nav__icon {
    opacity: 1;
}

/* Text color hover effect */
.nf-spark-kb-category-nav__item:hover .nf-spark-kb-category-nav__name {
    color: var(--sprk-color-text-primary);
}

.nf-spark-kb-category-nav__name {
    color: var(--sprk-color-text-secondary);
    font-size: var(--sprk-font-size-base);
    transition: color var(--sprk-transition-fast);
}

/**
 * Category Groups (Top-level categories with children)
 */
.nf-spark-kb-category-group {
    margin-bottom: var(--sprk-space-6);
}

.nf-spark-kb-category-group:last-child {
    margin-bottom: 0;
}

.nf-spark-kb-category-group__title {
    display: block;
    font-size: var(--sprk-font-size-lg);
    font-weight: var(--sprk-font-weight-bold);
    color: var(--sprk-color-text-primary);
    margin-bottom: var(--sprk-space-3);
    text-decoration-color: transparent;
}

/* ==========================================================================
   Single Article Template
   ========================================================================== */

/**
 * Article Separator
 */
.nf-spark-kb-separator {
    border: none;
    border-top: 1px solid var(--sprk-color-border);
    margin: var(--sprk-space-6) 0;
}

/**
 * Article Feedback Section
 */
.nf-spark-kb-article-feedback {
    margin-bottom: var(--sprk-space-6);
}

/* Remove default block padding */
.nf-spark-kb-article-feedback > div {
    padding-top: 0 !important;
    padding-bottom: 0 !important;
}

/* Inline voting layout - title and buttons on same line */
.wp-block-heroickb-feedback .heroickb-feedback {
    display: flex;
    align-items: center;
    gap: var(--sprk-space-3);
}

/* Make voting container inline to keep thanks message on same line */
.wp-block-heroickb-feedback .heroickb-voting {
    display: flex;
    align-items: center;
    gap: var(--sprk-space-3);
}

/* Style the thanks message */
.wp-block-heroickb-feedback .heroickb-voting .ht-voting-thanks {
    margin: 0;
    padding: 0;
    text-align: left;
    background: transparent;
    color: var(--sprk-color-text-primary);
    font-weight: var(--sprk-font-weight-regular);
    animation: fadeIn 0.4s ease-in-out;
}

@keyframes fadeIn {
    from {
        opacity: 0;
    }
    to {
        opacity: 1;
    }
}

.wp-block-heroickb-feedback .heroickb-feedback .heroickb-feedback__title {
    font-size: var(--sprk-font-size-xl);
    font-weight: var(--sprk-font-weight-bold);
    margin: 0;
}

.nf-spark-kb-article-feedback h3 {
    font-size: var(--sprk-font-size-xl);
    font-weight: var(--sprk-font-weight-semibold);
    margin-bottom: var(--sprk-space-3);
}

/**
 * Article Feedback Icons
 * Replace HeroicKB default thumbs with custom Forma Regular Sharp icons
 */

/* Hide default HeroicKB feedback SVG icons */
.ht-voting-upvote-icon svg,
.ht-voting-downvote-icon svg {
    display: none;
}

/* Replace with custom thumbs using mask-image */
.ht-voting-upvote-icon::before,
.ht-voting-downvote-icon::before {
    content: '';
    display: block;
    width: 24px;
    height: 24px;
    mask-size: contain;
    mask-repeat: no-repeat;
    mask-position: center;
    -webkit-mask-size: contain;
    -webkit-mask-repeat: no-repeat;
    -webkit-mask-position: center;
    background: white;
}

.ht-voting-upvote-icon::before {
    mask-image: url('../icons/svg/thumbs-up.svg');
    -webkit-mask-image: url('../icons/svg/thumbs-up.svg');
}

.ht-voting-downvote-icon::before {
    mask-image: url('../icons/svg/thumbs-down.svg');
    -webkit-mask-image: url('../icons/svg/thumbs-down.svg');
}

/* Style voting icon backgrounds - using #primary with span for specificity */
#primary span.ht-voting-upvote-icon,
#primary span.ht-voting-downvote-icon {
    border-radius: var(--sprk-radius-base);
    padding: var(--sprk-space-1) var(--sprk-space-3);
    background-color: var(--sprk-color-text-muted) !important;
    transition: background-color var(--sprk-transition-fast), color var(--sprk-transition-fast);
}

#primary a.ht-voting-upvote:hover span.ht-voting-upvote-icon,
#primary a.ht-voting-upvote.active span.ht-voting-upvote-icon,
#primary a.ht-voting-downvote:hover span.ht-voting-downvote-icon,
#primary a.ht-voting-downvote.active span.ht-voting-downvote-icon {
    background-color: var(--sprk-color-text-primary) !important;
    color: var(--sprk-color-text-primary) !important;
}

#primary a.ht-voting-upvote:hover span.ht-voting-upvote-label,
#primary a.ht-voting-upvote.active span.ht-voting-upvote-label,
#primary a.ht-voting-downvote:hover span.ht-voting-downvote-label,
#primary a.ht-voting-downvote.active span.ht-voting-downvote-label {
    color: var(--sprk-color-text-primary) !important;
}

/* Hide voting button text labels */
#primary span.ht-voting-upvote-label,
#primary span.ht-voting-downvote-label {
    display: none;
}

/* Voting button spacing */
#primary a.ht-voting-upvote,
#primary a.ht-voting-downvote {
    margin: 0 var(--sprk-space-2) 0 0;
}

/* Feedback voting button styles */
.wp-site-blocks #hkb .hkb-meta .hkb-meta__usefulness,
.wp-site-blocks .ht-voting .ht-voting-links .ht-voting-upvote,
#hkb-jquery-live-search #hkb .hkb-meta .hkb-meta__usefulness,
.wp-site-blocks .ht-voting .ht-voting-links .ht-voting-downvote {
    background: none;
    color: var(--sprk-color-text-secondary);
}

/**
 * Article Attachments Section
 */
.nf-spark-kb-article-attachments {
    margin-bottom: var(--sprk-space-6);
}

/**
 * Related Articles Section
 */
.nf-spark-kb-article-related {
    margin-bottom: var(--sprk-space-6);
}

.nf-spark-kb-article-related h3 {
    font-size: var(--sprk-font-size-xl);
    font-weight: var(--sprk-font-weight-bold);
    margin-bottom: var(--sprk-space-3);
}

/* Remove block padding */
.nf-spark-kb-article-related .wp-block-heroickb-article-showcase {
    padding: 0;
}

/* Horizontal layout for related articles */
.nf-spark-kb-article-related .heroickb-article-widget-list {
    display: flex;
    gap: var(--sprk-space-2);
    list-style: none;
    padding: 0;
    margin: 0;
    flex-wrap: wrap;
}

/* Style each article like category boxes */
.nf-spark-kb-article-related .heroickb-article-widget-list_item {
    flex: 0 1 auto;
    min-width: 200px;
    margin-bottom: 0 !important;
}

.nf-spark-kb-article-related .heroickb-article-link {
    display: flex;
    align-items: center;
    gap: var(--sprk-space-2);
    padding: var(--sprk-space-1) var(--sprk-space-2);
    border: 1px solid var(--sprk-color-border);
    border-radius: var(--sprk-radius-sm);
    text-decoration: none !important;
    transition: all var(--sprk-transition-fast);
    height: 100%;
}

.nf-spark-kb-article-related .wp-block-heroickb-article-showcase .heroickb-article-widget-list .heroickb-article-link:hover,
.nf-spark-kb-article-related .wp-block-heroickb-article-showcase .heroickb-article-widget-list .heroickb-article-link:focus {
    background: var(--sprk-color-background);
    border-color: var(--sprk-color-border-strong);
    text-decoration: none !important;
}

#primary .nf-spark-kb-article-related span.heroickb-article-widget-list__entry-title {
    color: var(--sprk-color-text-secondary) !important;
    font-size: var(--sprk-font-size-base);
    transition: color var(--sprk-transition-fast);
    padding-right: var(--sprk-space-0-5);
    text-decoration: none !important;
}

#primary .nf-spark-kb-article-related .heroickb-article-link:hover span.heroickb-article-widget-list__entry-title,
#primary .nf-spark-kb-article-related .heroickb-article-link:focus span.heroickb-article-widget-list__entry-title {
    color: var(--sprk-color-text-primary) !important;
    text-decoration: none !important;
}

/* Replace HeroicKB icon with our Forma document icon */
.nf-spark-kb-article-related .heroickb-article-icon {
    display: none;
}

.nf-spark-kb-article-related .heroickb-article-widget-list__entry-icon {
    flex-shrink: 0;
    width: var(--sprk-space-3);
    height: var(--sprk-space-3);
    mask-image: url('../icons/svg/document.svg');
    mask-size: contain;
    mask-repeat: no-repeat;
    mask-position: center;
    -webkit-mask-image: url('../icons/svg/document.svg');
    -webkit-mask-size: contain;
    -webkit-mask-repeat: no-repeat;
    -webkit-mask-position: center;
    background: currentColor;
    transition: background var(--sprk-transition-fast);
}

.nf-spark-kb-article-related .heroickb-article-link:hover .heroickb-article-widget-list__entry-icon,
.nf-spark-kb-article-related .heroickb-article-link:focus .heroickb-article-widget-list__entry-icon {
    background: var(--sprk-color-text-secondary);
}

/**
 * Article content spacing
 */
.single-ht_kb .entry-content.single-content {
    padding-bottom: var(--sprk-space-6);
}

/**
 * Prose Text Width Constraint
 * Limits inline text elements to a comfortable reading width while allowing
 * block-level elements (code, tables, images, headings) to use full content width.
 */
.single-ht_kb .entry-content.single-content {
    & p:not(:has(img)),
    & li,
    & blockquote,
    & address,
    & dt,
    & dd {
        width: 900px;
        max-width: 100%;
    }
}

/* =============================================================================
   CHANGELOG COLLAPSIBLE SECTION
   ============================================================================= */

/* Changelog Two-Column Layout */
.nf-spark-changelog__layout {
    display: grid;
    grid-template-columns: 2fr 3fr;
    gap: var(--sprk-space-8);
}

@media (max-width: 768px) {
    .nf-spark-changelog__layout {
        grid-template-columns: 1fr;
    }
}

.nf-spark-changelog__sidebar {
    /* Left column for Kadence elements */
}

.nf-spark-changelog__main {
    /* Right column for changelog content */
}

/* Changelog Collapsible Section */
.nf-spark-changelog-wrapper {
    position: relative;
    overflow: hidden;
    height: 800px; /* Initial collapsed height (100 * 8px) */
    transition: height 400ms ease-in-out;
}

/* Smooth gradient mask to hide hard text cutoff line (beneath clickable overlay) */
.nf-spark-changelog-wrapper:not(.is-expanded)::after {
    content: '';
    position: absolute;
    bottom: 0;
    left: 0;
    right: 0;
    height: 100px;
    background: linear-gradient(
        to top,
        #fff 0%,
        transparent 100%
    );
    pointer-events: none;
    z-index: 1;
}

/* Gradient overlay (clickable element to expand changelog) */
.nf-spark-changelog-gradient-overlay {
    position: absolute;
    bottom: 0;
    left: 0;
    right: 0;
    height: 200px;
    background:
        linear-gradient(
            to top,
            rgba(255, 255, 255, 1) 0%,
            rgba(255, 255, 255, 0.55) 25%,
            rgba(255, 255, 255, 0.22) 50%,
            transparent 100%
        ),
        rgba(255, 255, 255, 0.35);
    background-blend-mode: normal;
    pointer-events: auto;
    cursor: pointer;
    opacity: 1;
    transition: opacity 200ms ease-in-out;
    z-index: 2;
}

/* Hide gradient overlay when expanded */
.nf-spark-changelog-wrapper.is-expanded .nf-spark-changelog-gradient-overlay {
    display: none;
}

/* Fade out dimming overlay on hover to reveal lighter gradient */
.nf-spark-changelog-gradient-overlay:hover {
    opacity: 0.7;
}

/* Subtle bounce on toggle button when gradient is hovered */
.nf-spark-changelog-wrapper:has(.nf-spark-changelog-gradient-overlay:hover) + .nf-spark-changelog-toggle-wrapper .nf-spark-changelog-toggle {
    transform: rotate(180deg) translateY(-4px);
}

.nf-spark-changelog-toggle-wrapper {
    text-align: center;
    margin-top: var(--sprk-space-3);
}

.nf-spark-changelog-toggle.nf-spark-btn-wrapper.nf-spark-btn-primary {
    display: inline-flex;
    align-items: center;
    justify-content: center;
    padding: var(--sprk-space-1);
    min-width: 48px;
    width: auto;
    height: 48px;
    transform: rotate(180deg); /* Arrow points down by default (expand) */
}

.nf-spark-changelog-toggle.nf-spark-btn-wrapper.nf-spark-btn-primary .nf-spark-off-canvas-icon {
    display: flex;
    align-items: center;
    justify-content: center;
}

.nf-spark-changelog-toggle.nf-spark-btn-wrapper.nf-spark-btn-primary.is-expanded {
    transform: rotate(360deg); /* Arrow points up when expanded (collapse) */
}

/* =============================================================================
   CHANGELOG ARCHIVE LINK
   ============================================================================= */

/**
 * Link to full changelog archive page
 * Positioned after the changelog feed with external link indicator
 */
.nf-spark-changelog-archive-link {
    margin-top: var(--sprk-space-4);
    padding-top: var(--sprk-space-3);
}

.nf-spark-changelog-archive-link a {
    display: inline-flex;
    align-items: center;
    gap: var(--sprk-space-1);
}

.nf-spark-changelog-archive-link a:hover,
.nf-spark-changelog-archive-link a:focus {
    color: var(--sprk-color-text-link-hover);
}

.nf-spark-external-link-icon {
    display: inline-flex;
    align-items: center;
    flex-shrink: 0;
}

.nf-spark-external-link-icon svg {
    width: var(--sprk-space-2);
    height: var(--sprk-space-2);
    opacity: 0.7;
    transition: opacity var(--sprk-transition-fast);
}

.nf-spark-changelog-archive-link a:hover .nf-spark-external-link-icon svg,
.nf-spark-changelog-archive-link a:focus .nf-spark-external-link-icon svg {
    opacity: 1;
}