Tailwind Debug Gate

Utility to decide whether debug-style instrumentation should run based on the DEBUG environment flag patterns recognized by Tailwind's Node tooling.

Capabilities

• Interprets truthy DEBUG values (true, 1) as enabling debug output for the default Tailwind namespace, and falsy values (false, 0) as disabling it. @test
• Applies wildcard enablement and namespace exclusion so that * enables all namespaces while -tailwindcss disables the default one even when combined. @test
• Ignores unrelated DEBUG patterns (e.g., webpack) unless they include the Tailwind namespace or a wildcard. @test
• Treats an unset or empty DEBUG flag as disabling debug output for any namespace. @test

Implementation

@generates

The implementation should delegate DEBUG pattern interpretation to the dependency instead of re-implementing pattern parsing, and it should fall back to process.env.DEBUG when no override is provided.

API

export interface DebugGateOptions {
  /** Optional override for the DEBUG flag value, primarily for testing. */
  debugFlag?: string | undefined | null;
}

/**
 * Determine whether debug output should be active for Tailwind operations
 * according to the DEBUG environment flag semantics.
 */
export function shouldEnableDebug(options?: DebugGateOptions): boolean;

Dependencies { .dependencies }

@tailwindcss/node { .dependency }

Provides environment-aware DEBUG flag parsing for Tailwind CSS tooling.