postcss.config.js

// PostCSS Configuration - Environment-aware optimization
const isDevelopment = process.env.HUGO_ENVIRONMENT === "development";

// Skip expensive PurgeCSS in development for faster rebuilds
const createPurgeCss = require("@fullhuman/postcss-purgecss").default || require("@fullhuman/postcss-purgecss");

const purgecss = createPurgeCss({
  content: ["./hugo_stats.json"],
  defaultExtractor: (content) => {
    const els = JSON.parse(content).htmlElements
    return [...(els.tags || []), ...(els.classes || []), ...(els.ids || [])]
  },
  safelist: {
    standard: [
      "button, input[type=button], input[type=submit]",

      // pp adv tabs
      "pp-tabs", "pp-tabs-label", "pp-tab-active", "pp-tabs-panel", "pp-tabs-panel-content",
      "pp-tabs-animation", "pp-no-border",

      // fl-theme
      "collapse", "fl-mobile-sub-menu-open", "current-menu-item", "fl-sub-menu-right", "fl-shrink-header-enabled",
      "fl-show", "mega-menu-disabled", "mega-menu", /^mega-menu-items-/, "fl-responsive-nav-enabled",
      "fl-nav-offcanvas-collapse",

      // sdb
      "jt-active",

      "comment-link",

      // Brand CTA buttons — MUST NEVER be purged. These rules live in
      // navigation.css and define the JT Ruby red (#cc342d) override
      // for .btn-primary and a.fl-button (homepage hero, Contact Us nav,
      // free-consultation CTAs). PurgeCSS in CI has been observed
      // removing them despite hugo_stats.json containing the class —
      // explicit safelist guards against that drift.
      "btn", "btn-primary", "fl-button", "fl-button-wrap", "action-button",

      // Accessibility skip-link (baseof.html) — same CI-purge phenomenon as
      // the fl-button entries above: 2026-07-19 a scheduled deploy shipped
      // the inline navigation bundle WITHOUT .sr-only (visible "Skip to
      // main content" on every page) while local builds of the same commit
      // kept it. Never purge these.
      "sr-only", "skip-link",
    ],

    deep: [
      /^fl-page/, /^navigation/, /^menu-close/, /^top-panel/, /^menu-opener/
    ],

    greedy: [
      /^swiper-/, /^is-/, /^has-/, /^js-/, /^fl-builder-content/, /^fl-col/, /^fl-node/, /^technologies-component/, /^footer-component/, /^use-cases/,
      // C2 de-obfuscation: semantic component prefixes inherit the greedy
      // protection their selectors previously got from /^fl-node/ (PowerPack
      // runtime classes like pp-swiper-button/pp-review-image are never in
      // hugo_stats.json, so without this the renamed rules get purged).
      /^testimonials-/, /^cta-banner/, /^jt-info-card/, /^career-/, /^clients-/,
      // jt-reviews-box restoration (decision: Claude per Paul delegation
      // 2026-07-19): the intended testimonial-slider design (arrow nav,
      // card refinements) was silently purged because pp-swiper/pp-review
      // runtime classes had no shield. Restored deliberately.
      /^pp-swiper/, /^pp-review/,
      /^notfound-/, /^use-case-/, /^services-/, /^service-/, /^about-/, /^home-/, /^careers-/,
      // Brand CTA buttons — preserve any selector mentioning these classes.
      // Standard safelist didn't catch tag+class compound selectors like
      // `a.fl-button` on CI (produced blue pills instead of Ruby red).
      // Greedy preserves rules where ANY class in the selector matches.
      /^fl-button/, /^btn/, /^action-button/
    ]
  },
  // Enhanced PurgeCSS options for better optimization
  variables: true,
  fontFace: true,
  keyframes: true,
  // More aggressive CSS removal
  rejected: true,
  rejectedCss: true
});

// PostCSS plugins
const postcssMixins = require('postcss-mixins');
const postcssExtend = require('postcss-extend-rule');
// Optional simple vars support (disabled by default) can be enabled later:
// const postcssSimpleVars = require('postcss-simple-vars');

module.exports = {
  plugins: [
    // Process @import statements first (must be first in order)
    require("postcss-import")({
      path: ["themes/beaver/assets/css", "themes/beaver/assets/css/mixins"],
      skipDuplicates: true
    }),

    // NOTE: POSTCSS_ENABLE_MIXINS and POSTCSS_ENABLE_EXTEND are inherited naturally
    // from the parent shell through standard OS process inheritance. Hugo does NOT
    // filter child-process env vars — only HUGO_ENVIRONMENT fails to auto-export.
    // These two toggles work without any explicit export in bin/dev, bin/hugo-build,
    // or CI. They're only needed if you want to DISABLE a plugin (export either as 'false').

    // Mixins first so they can be expanded before nesting/extend
    process.env.POSTCSS_ENABLE_MIXINS === 'false' ? null : postcssMixins({
      mixinsDir: 'themes/beaver/assets/css/mixins'
    }),

    // Enable @extend like SCSS (only light usage expected) - placed early so extended selectors participate in nesting
    process.env.POSTCSS_ENABLE_EXTEND === 'false' ? null : postcssExtend(),

    // (Optional) Uncomment if $var style variables are introduced later
    // postcssSimpleVars(),

    // Always include nested CSS support
    require("postcss-nested"),

    // Skip autoprefixer in development for faster processing
    isDevelopment ? null : require("autoprefixer"),

    // Skip PurgeCSS in development (major speed improvement)
    isDevelopment ? null : purgecss,

    // Skip duplicate removal in development
    isDevelopment ? null : require("postcss-delete-duplicate-css")({ isRemoveNull: true, isRemoveComment: true }),

    // Enhanced minification in production with aggressive optimization
    isDevelopment ? null : require("cssnano")({
      preset: ['default', {
        discardComments: {
          removeAll: true,
        },
        normalizeWhitespace: true,
        reduceIdents: false, // Preserve class names for compatibility
        mergeLonghand: true,
        discardDuplicates: true,
        discardEmpty: true,
        minifyFontValues: true,
        minifyGradients: true,
        minifyParams: true,
        minifySelectors: true,
        reduceTransforms: true,
        svgo: false, // Disable to prevent SVG issues
        zindex: false // Preserve z-index values for safety
      }]
    }),
  ].filter(Boolean), // Remove null plugins
};