react-perf-analyzer 0.1.0

Static analysis CLI for React performance anti-patterns
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66

/// cli.rs — CLI argument parsing using clap derive macros.
///
/// Defines the top-level `Cli` struct that clap populates from argv.
/// Kept intentionally minimal: path, output format, and rule thresholds.
use std::path::PathBuf;

use clap::{Parser, ValueEnum};

/// React performance static analysis tool.
///
/// Scans JS/TS/JSX files for React-specific performance anti-patterns
/// and outputs warnings to stdout.
///
/// Example usage:
///   react-perf-analyzer ./src
///   react-perf-analyzer ./src --format json
///   react-perf-analyzer ./src --max-component-lines 150
#[derive(Parser, Debug)]
#[command(
    name = "react-perf-analyzer",
    version,
    about = "Static analysis for React performance anti-patterns",
    long_about = None
)]
pub struct Cli {
    /// Path to the file or directory to analyze.
    /// Directories are scanned recursively for .js/.jsx/.ts/.tsx files.
    pub path: PathBuf,

    /// Output format for lint results.
    ///
    /// - text: Human-readable columnar output (default)
    /// - json: Machine-readable JSON array
    #[arg(long, default_value = "text", value_name = "FORMAT")]
    pub format: OutputFormat,

    /// Maximum number of lines allowed in a single React component.
    ///
    /// Components exceeding this threshold trigger the `large_component` warning.
    /// Default is 300 lines.
    #[arg(long, default_value_t = 300, value_name = "LINES")]
    pub max_component_lines: usize,

    /// Include test and Storybook files in the analysis.
    ///
    /// By default, the following file patterns are skipped because inline
    /// functions and object literals are idiomatic in tests/stories:
    ///   *.test.{js,ts,jsx,tsx}
    ///   *.spec.{js,ts,jsx,tsx}
    ///   *.stories.{js,ts,jsx,tsx}
    ///   *.story.{js,ts,jsx,tsx}
    ///   __tests__/ directories
    ///
    /// Pass this flag to lint those files anyway.
    #[arg(long, default_value_t = false)]
    pub include_tests: bool,
}

/// Supported output formats for lint results.
#[derive(ValueEnum, Clone, Debug, PartialEq)]
pub enum OutputFormat {
    /// Human-readable text output (default).
    Text,
    /// JSON array output, suitable for tooling integration.
    Json,
}