loctree 0.8.16

Structural code intelligence for AI agents. Scan once, query everything.
Documentation 
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
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116

//! Static analysis engine for loctree.
//!
//! This module contains language-specific analyzers and cross-cutting analysis features:
//!
//! ## Language Analyzers
//! - [`ast_js`] / [`js`] - TypeScript/JavaScript AST analysis
//! - [`py`] - Python import/export analysis
//! - [`rust`] - Rust analysis (Tauri commands, mod statements)
//! - [`css`] - CSS/SCSS dependency tracking
//! - [`dart`] - Dart/Flutter import/export analysis (lightweight)
//!
//! ## Analysis Features
//! - [`cycles`] - Circular import detection (Tarjan's SCC algorithm)
//! - [`dead_parrots`] - Dead/unused export detection
//! - [`coverage`] - Tauri command coverage (FE→BE matching)
//! - [`trace`] - Handler tracing through the call graph
//! - [`pipelines`] - Data flow pipeline analysis
//!
//! ## Output Formats
//! - [`for_ai`] - AI-optimized JSON with quick wins
//! - [`html`] - Interactive HTML reports
//! - [`sarif`] - SARIF 2.1.0 for CI integration
//! - [`report`] - Report data structures

pub mod assets;
pub mod ast_js;
pub mod audit_report;
pub mod barrels;
pub mod classify;
pub mod coverage;
pub mod coverage_gaps;
pub mod crowd;
mod css;
pub mod cycles;
pub mod dart;
pub mod dead_parrots;
pub mod dist;
pub mod dist_vlq;
pub mod entrypoints;
pub mod findings;
pub mod for_ai;
pub mod frameworks;
pub mod go;
mod graph;
pub mod health_score;
pub mod html;
pub(crate) mod html_analyzer;
pub mod insights;
pub mod js;
pub mod manifests;
pub mod memory_lint;
pub mod open_server;
pub mod output;
pub mod pipelines;
pub mod py;
pub mod react_lint;
pub mod regexes;
pub mod report;
pub mod resolvers;
pub mod root_scan;
pub mod runner;
pub mod rust;
pub mod sarif;
pub mod scan;
pub mod search;
pub mod test_coverage;
pub mod trace;
pub mod ts_lint;
mod tsconfig;
pub mod twins;

pub(super) fn offset_to_line(content: &str, offset: usize) -> usize {
    content[..offset].bytes().filter(|b| *b == b'\n').count() + 1
}

/// Check if a file path looks like a test file.
/// Used by ts_lint and memory_lint to adjust severity.
pub fn is_test_file(path: &str) -> bool {
    let p = path.to_lowercase();
    p.contains(".test.")
        || p.contains(".spec.")
        || p.contains("__tests__")
        || p.contains("/test/")
        || p.contains("/tests/")
        || p.contains("test-utils")
        || p.ends_with("setup.ts")
        || p.ends_with("setup.tsx")
}

/// Build an open URL for IDE integration
/// Format: loctree://open?f={file}&l={line}
/// Or if open_base is provided (e.g., "http://127.0.0.1:7777"):
/// Format: {open_base}/open?f={file}&l={line}
pub fn build_open_url(file: &str, line: Option<usize>, open_base: Option<&str>) -> String {
    let base = open_base.unwrap_or("loctree://");
    let path = if base.ends_with('/') {
        format!("{}open", base)
    } else if base.contains("://") {
        format!("{}/open", base)
    } else {
        format!("{}://open", base)
    };

    match line {
        Some(l) => format!("{}?f={}&l={}", path, urlencoding::encode(file), l),
        None => format!("{}?f={}", path, urlencoding::encode(file)),
    }
}

#[allow(unused_imports)]
pub use cycles::{ClassifiedCycle, CycleClassification};
pub use report::{
    AiInsight, CommandGap, DupLocation, DupSeverity, GraphComponent, GraphData, GraphNode,
    RankedDup, ReportSection,
};
pub use runner::run_import_analyzer;