import { build } from 'esbuild';
import { tektonPlugin } from '@tekton/esbuild-plugin';

await build({
  entryPoints: ['src/index.ts'],
  bundle: true,
  plugins: [
    tektonPlugin({
      strict: true, // Fail build on violations (default: true in production)
      threshold: 100, // Required compliance percentage
      verbose: true, // Enable logging
      reportPath: './tekton-report.txt', // Optional report file
    }),
  ],
});

With tsup

import { defineConfig } from 'tsup';
import { tektonPlugin } from '@tekton/esbuild-plugin';

export default defineConfig({
  entry: ['src/index.ts'],
  esbuildPlugins: [
    tektonPlugin({
      strict: process.env.NODE_ENV === 'production',
    }),
  ],
});

Options

interface TektonPluginOptions {
  strict?: boolean; // Fail build on violations (default: true in prod)
  include?: RegExp[]; // File patterns to include (default: /.tsx?$/)
  exclude?: RegExp[]; // File patterns to exclude (default: node_modules, tests)
  threshold?: number; // Compliance threshold (default: 100)
  reportPath?: string; // Generate report file
  verbose?: boolean; // Enable verbose logging
}

How It Works

AST Analysis: Uses Babel parser to analyze styled-components templates
Pattern Detection: Identifies hardcoded colors (hex, rgb, hsl) and spacing (px values)
Violation Reporting: Generates detailed reports with file, line, and suggestions
Build Enforcement: Fails build when compliance < threshold (100% by default)

Development vs Production

Development mode (strict: false): Warns about violations but doesn't fail build
Production mode (strict: true): Fails build if any violations are found

Example Violations

// ❌ Detected violations:

styled.div`
  background: #ffffff; // Error: hex color "#ffffff"
  // Suggestion: tokens.bg.* or tokens.fg.*

  padding: 16px; // Error: pixel spacing "16px"
  // Suggestion: tokens.spacing[4]
`;