@frozenproductions/niteo 0.1.0

package/src/rules/max_items_per_directory.rs

@@ -0,0 +1,145 @@
+use std::fs;
+use std::path::Path;
+
+use crate::config::{MaxItemsPerDirectoryRuleConfig, Severity};
+use crate::rules::Violation;
+
+const RULE_NAME: &str = "max-items-per-directory";
+const MESSAGE: &str = "Directory exceeds the maximum number of items. Consider sub-grouping.";
+
+const IGNORED_DIRECTORIES: &[&str] = &[
+    "node_modules",
+    ".git",
+    ".vscode",
+    ".idea",
+    "dist",
+    "build",
+    "out",
+    ".next",
+    ".svelte-kit",
+    "target",
+];
+
+const SOURCE_EXTENSIONS: &[&str] = &["ts", "tsx"];
+
+pub fn check_directories(root: &Path, config: &MaxItemsPerDirectoryRuleConfig) -> Vec<Violation> {
+    let mut violations = Vec::new();
+    let mut ignored = config.ignore_dirs.clone();
+    ignored.extend(IGNORED_DIRECTORIES.iter().map(|s| s.to_string()));
+
+    walk_directories(
+        root,
+        &ignored,
+        config.max_items,
+        config.count_folders,
+        &mut violations,
+    );
+
+    violations
+}
+
+fn walk_directories(
+    current: &Path,
+    ignored: &[String],
+    max_items: usize,
+    count_folders: bool,
+    violations: &mut Vec<Violation>,
+) {
+    let entries = match fs::read_dir(current) {
+        Ok(entries) => entries,
+        Err(_) => return,
+    };
+
+    let mut subdirs = Vec::new();
+    let mut item_count = 0;
+
+    for entry in entries {
+        let entry = match entry {
+            Ok(e) => e,
+            Err(_) => continue,
+        };
+
+        let path = entry.path();
+        let name = entry.file_name();
+        let name_str = name.to_string_lossy();
+
+        if path.is_dir() {
+            if ignored.iter().any(|ign| name_str == *ign) {
+                continue;
+            }
+            if count_folders {
+                item_count += 1;
+            }
+            subdirs.push(path);
+        } else if is_source_file(&path) {
+            item_count += 1;
+        }
+    }
+
+    if item_count > max_items {
+        violations.push(directory_violation(
+            current,
+            Severity::Warn,
+            item_count,
+            max_items,
+            count_folders,
+        ));
+    }
+
+    for subdir in subdirs {
+        walk_directories(&subdir, ignored, max_items, count_folders, violations);
+    }
+}
+
+fn is_source_file(path: &Path) -> bool {
+    matches!(
+        path.extension().and_then(|ext| ext.to_str()),
+        Some(ext) if SOURCE_EXTENSIONS.contains(&ext)
+    )
+}
+
+fn directory_violation(
+    dir: &Path,
+    severity: Severity,
+    item_count: usize,
+    max_items: usize,
+    count_folders: bool,
+) -> Violation {
+    let kind = if count_folders { "items" } else { "files" };
+    Violation {
+        file: dir.to_path_buf(),
+        line: None,
+        column: None,
+        rule: RULE_NAME,
+        message: MESSAGE,
+        severity,
+        detail: Some(format!(
+            "Contains {} TypeScript {} (limit: {}).",
+            item_count, kind, max_items
+        )),
+        subject: None,
+    }
+}
+
+#[cfg(test)]
+mod tests {
+    use super::*;
+
+    #[test]
+    fn violation_detail_shows_count_and_limit_files_only() {
+        let v = directory_violation(Path::new("src"), Severity::Warn, 15, 10, false);
+        assert_eq!(
+            v.detail,
+            Some("Contains 15 TypeScript files (limit: 10).".to_string())
+        );
+    }
+
+    #[test]
+    fn violation_detail_shows_count_and_limit_including_folders() {
+        let v = directory_violation(Path::new("src"), Severity::Warn, 25, 20, true);
+        assert_eq!(
+            v.detail,
+            Some("Contains 25 TypeScript items (limit: 20).".to_string())
+        );
+    }
+}

package/src/rules/min_items_per_directory.rs

@@ -0,0 +1,146 @@
+use std::fs;
+use std::path::Path;
+
+use crate::config::{MinItemsPerDirectoryRuleConfig, Severity};
+use crate::rules::Violation;
+
+const RULE_NAME: &str = "min-items-per-directory";
+const MESSAGE: &str =
+    "Directory has too few source items. Consider merging with a sibling or removing.";
+
+const IGNORED_DIRECTORIES: &[&str] = &[
+    "node_modules",
+    ".git",
+    ".vscode",
+    ".idea",
+    "dist",
+    "build",
+    "out",
+    ".next",
+    ".svelte-kit",
+    "target",
+];
+
+const SOURCE_EXTENSIONS: &[&str] = &["ts", "tsx"];
+
+pub fn check_directories(root: &Path, config: &MinItemsPerDirectoryRuleConfig) -> Vec<Violation> {
+    let mut violations = Vec::new();
+    let mut ignored = config.ignore_dirs.clone();
+    ignored.extend(IGNORED_DIRECTORIES.iter().map(|s| s.to_string()));
+
+    walk_directories(
+        root,
+        &ignored,
+        config.min_items,
+        config.count_folders,
+        &mut violations,
+    );
+
+    violations
+}
+
+fn walk_directories(
+    current: &Path,
+    ignored: &[String],
+    min_items: usize,
+    count_folders: bool,
+    violations: &mut Vec<Violation>,
+) {
+    let entries = match fs::read_dir(current) {
+        Ok(entries) => entries,
+        Err(_) => return,
+    };
+
+    let mut subdirs = Vec::new();
+    let mut item_count = 0;
+
+    for entry in entries {
+        let entry = match entry {
+            Ok(e) => e,
+            Err(_) => continue,
+        };
+
+        let path = entry.path();
+        let name = entry.file_name();
+        let name_str = name.to_string_lossy();
+
+        if path.is_dir() {
+            if ignored.iter().any(|ign| name_str == *ign) {
+                continue;
+            }
+            if count_folders {
+                item_count += 1;
+            }
+            subdirs.push(path);
+        } else if is_source_file(&path) {
+            item_count += 1;
+        }
+    }
+
+    if item_count > 0 && item_count < min_items {
+        violations.push(directory_violation(
+            current,
+            Severity::Warn,
+            item_count,
+            min_items,
+            count_folders,
+        ));
+    }
+
+    for subdir in subdirs {
+        walk_directories(&subdir, ignored, min_items, count_folders, violations);
+    }
+}
+
+fn is_source_file(path: &Path) -> bool {
+    matches!(
+        path.extension().and_then(|ext| ext.to_str()),
+        Some(ext) if SOURCE_EXTENSIONS.contains(&ext)
+    )
+}
+
+fn directory_violation(
+    dir: &Path,
+    severity: Severity,
+    item_count: usize,
+    min_items: usize,
+    count_folders: bool,
+) -> Violation {
+    let kind = if count_folders { "items" } else { "files" };
+    Violation {
+        file: dir.to_path_buf(),
+        line: None,
+        column: None,
+        rule: RULE_NAME,
+        message: MESSAGE,
+        severity,
+        detail: Some(format!(
+            "Contains {} TypeScript {} (minimum: {}).",
+            item_count, kind, min_items
+        )),
+        subject: None,
+    }
+}
+
+#[cfg(test)]
+mod tests {
+    use super::*;
+
+    #[test]
+    fn violation_detail_shows_count_and_minimum_files_only() {
+        let v = directory_violation(Path::new("src"), Severity::Warn, 1, 3, false);
+        assert_eq!(
+            v.detail,
+            Some("Contains 1 TypeScript files (minimum: 3).".to_string())
+        );
+    }
+
+    #[test]
+    fn violation_detail_shows_count_and_minimum_including_folders() {
+        let v = directory_violation(Path::new("src"), Severity::Warn, 2, 5, true);
+        assert_eq!(
+            v.detail,
+            Some("Contains 2 TypeScript items (minimum: 5).".to_string())
+        );
+    }
+}

package/src/rules/no_barrel_files.rs

@@ -0,0 +1,284 @@
+use std::path::Path;
+
+use crate::config::{RuleConfig, Severity};
+use crate::rules::Violation;
+
+const RULE_NAME: &str = "no-barrel-files";
+const MESSAGE: &str = "Avoid barrel files; import directly from the source module.";
+const BARREL_FILE_NAME: &str = "index.ts";
+
+pub fn check_file(file: &Path, source: &str, config: &RuleConfig) -> Vec<Violation> {
+    if file.file_name().and_then(|name| name.to_str()) != Some(BARREL_FILE_NAME) {
+        return Vec::new();
+    }
+
+    let bytes = source.as_bytes();
+    let mut index = 0;
+    let mut has_re_export = false;
+
+    while index < bytes.len() {
+        skip_trivia(bytes, &mut index);
+
+        if index >= bytes.len() {
+            break;
+        }
+
+        let statement = read_statement(bytes, &mut index);
+        if is_re_export(statement) {
+            has_re_export = true;
+        }
+    }
+
+    if has_re_export {
+        vec![barrel_violation(file, config.severity)]
+    } else {
+        Vec::new()
+    }
+}
+
+fn barrel_violation(file: &Path, severity: Severity) -> Violation {
+    Violation {
+        file: file.to_path_buf(),
+        line: None,
+        column: None,
+        rule: RULE_NAME,
+        message: MESSAGE,
+        severity,
+        detail: None,
+        subject: None,
+    }
+}
+
+fn skip_trivia(bytes: &[u8], index: &mut usize) {
+    loop {
+        while *index < bytes.len() && bytes[*index].is_ascii_whitespace() {
+            *index += 1;
+        }
+
+        if starts_with(bytes, *index, b"//") {
+            skip_line_comment(bytes, index);
+            continue;
+        }
+
+        if starts_with(bytes, *index, b"/*") {
+            skip_block_comment(bytes, index);
+            continue;
+        }
+
+        break;
+    }
+}
+
+fn read_statement<'a>(bytes: &'a [u8], index: &mut usize) -> &'a [u8] {
+    let start = *index;
+    let mut string_quote: Option<u8> = None;
+    let mut brace_depth = 0usize;
+
+    while *index < bytes.len() {
+        let current = bytes[*index];
+        let next = bytes.get(*index + 1).copied();
+
+        if let Some(quote) = string_quote {
+            if current == b'\\' {
+                *index += 1;
+                if *index < bytes.len() {
+                    *index += 1;
+                }
+                continue;
+            }
+
+            if current == quote {
+                string_quote = None;
+            }
+
+            *index += 1;
+            continue;
+        }
+
+        match (current, next) {
+            (b'\'', _) | (b'"', _) | (b'`', _) => {
+                string_quote = Some(current);
+                *index += 1;
+            }
+            (b'/', Some(b'/')) => skip_line_comment(bytes, index),
+            (b'/', Some(b'*')) => skip_block_comment(bytes, index),
+            (b'{', _) => {
+                brace_depth += 1;
+                *index += 1;
+            }
+            (b'}', _) => {
+                brace_depth = brace_depth.saturating_sub(1);
+                *index += 1;
+            }
+            (b';', _) => {
+                *index += 1;
+                break;
+            }
+            (b'\n', _) if brace_depth == 0 => {
+                *index += 1;
+                break;
+            }
+            _ => *index += 1,
+        }
+    }
+
+    &bytes[start..*index]
+}
+
+fn is_re_export(statement: &[u8]) -> bool {
+    let mut scanner = TokenScanner::new(statement);
+
+    if scanner.next_token() != Some("export") {
+        return false;
+    }
+
+    if scanner.peek_token() == Some("type") {
+        scanner.next_token();
+    }
+
+    match scanner.next_token() {
+        Some("*") => scanner.contains_token("from"),
+        Some("{") => scanner.contains_token("from"),
+        _ => false,
+    }
+}
+
+fn skip_line_comment(bytes: &[u8], index: &mut usize) {
+    while *index < bytes.len() && bytes[*index] != b'\n' {
+        *index += 1;
+    }
+}
+
+fn skip_block_comment(bytes: &[u8], index: &mut usize) {
+    *index += 1;
+    *index += 1;
+
+    while *index < bytes.len() {
+        let current = bytes[*index];
+        let next = bytes.get(*index + 1).copied();
+
+        *index += 1;
+
+        if current == b'*' && next == Some(b'/') {
+            *index += 1;
+            break;
+        }
+    }
+}
+
+fn starts_with(bytes: &[u8], index: usize, pattern: &[u8]) -> bool {
+    bytes.get(index..index + pattern.len()) == Some(pattern)
+}
+
+#[derive(Debug)]
+struct TokenScanner<'a> {
+    source: &'a [u8],
+    index: usize,
+}
+
+impl<'a> TokenScanner<'a> {
+    fn new(source: &'a [u8]) -> Self {
+        Self { source, index: 0 }
+    }
+
+    fn next_token(&mut self) -> Option<&'a str> {
+        self.skip_non_tokens();
+
+        if self.index >= self.source.len() {
+            return None;
+        }
+
+        let start = self.index;
+        if self.source[self.index].is_ascii_alphabetic() {
+            while self.index < self.source.len() && self.source[self.index].is_ascii_alphabetic() {
+                self.index += 1;
+            }
+        } else {
+            self.index += 1;
+        }
+
+        std::str::from_utf8(&self.source[start..self.index]).ok()
+    }
+
+    fn peek_token(&mut self) -> Option<&'a str> {
+        let index = self.index;
+        let token = self.next_token();
+        self.index = index;
+        token
+    }
+
+    fn contains_token(&mut self, expected: &str) -> bool {
+        while let Some(token) = self.next_token() {
+            if token == expected {
+                return true;
+            }
+        }
+
+        false
+    }
+
+    fn skip_non_tokens(&mut self) {
+        while self.index < self.source.len() {
+            if self.source[self.index].is_ascii_alphanumeric()
+                || matches!(self.source[self.index], b'{' | b'}' | b'*')
+            {
+                break;
+            }
+
+            self.index += 1;
+        }
+    }
+}
+
+#[cfg(test)]
+mod tests {
+    use super::check_file;
+    use crate::config::{RuleConfig, Severity};
+    use std::path::Path;
+
+    #[test]
+    fn reports_barrel_file_with_re_exports() {
+        let source = r#"export { Button } from "./Button";
+export type { ButtonProps } from "./Button.type";
+"#;
+        let violations = check_file(Path::new("index.ts"), source, &test_config());
+
+        assert_eq!(violations.len(), 1);
+        assert!(violations[0].line.is_none());
+        assert!(violations[0].column.is_none());
+    }
+
+    #[test]
+    fn reports_barrel_file_with_namespace_re_exports() {
+        let source = r#"export * from "./Button";
+export * as ButtonParts from "./Button.parts";
+"#;
+        let violations = check_file(Path::new("index.ts"), source, &test_config());
+
+        assert_eq!(violations.len(), 1);
+    }
+
+    #[test]
+    fn ignores_non_barrel_files() {
+        let source = r#"export { Button } from "./Button";
+"#;
+        let violations = check_file(Path::new("Button.ts"), source, &test_config());
+
+        assert!(violations.is_empty());
+    }
+
+    #[test]
+    fn ignores_index_file_without_re_exports() {
+        let source = r#"const value = 1;
+"#;
+        let violations = check_file(Path::new("index.ts"), source, &test_config());
+
+        assert!(violations.is_empty());
+    }
+
+    fn test_config() -> RuleConfig {
+        RuleConfig {
+            severity: Severity::Warn,
+        }
+    }
+}