tree-sitter-analyzer 1.9.17.1__py3-none-any.whl

tree_sitter_analyzer/table_formatter.py

@@ -0,0 +1,782 @@
+#!/usr/bin/env python3
+"""
+Table Formatter for Tree-sitter Analyzer
+
+Provides table-formatted output for Java code analysis results.
+"""
+
+import csv
+import io
+import json
+from typing import Any
+
+
+class TableFormatter:
+    """Table formatter for code analysis results"""
+
+    def __init__(
+        self,
+        format_type: str = "full",
+        language: str = "java",
+        include_javadoc: bool = False,
+    ):
+        self.format_type = format_type
+        self.language = language
+        self.include_javadoc = include_javadoc
+
+    def _get_platform_newline(self) -> str:
+        """Get platform-specific newline character"""
+        import os
+
+        return "\r\n" if os.name == "nt" else "\n"  # Windows uses \r\n, others use \n
+
+    def _convert_to_platform_newlines(self, text: str) -> str:
+        """Convert standard \\n to platform-specific newline characters"""
+        platform_newline = self._get_platform_newline()
+        if platform_newline != "\n":
+            return text.replace("\n", platform_newline)
+        return text
+
+    def format_structure(self, structure_data: dict[str, Any]) -> str:
+        """Format structure data as table"""
+        if self.format_type == "full":
+            result = self._format_full_table(structure_data)
+        elif self.format_type == "compact":
+            result = self._format_compact_table(structure_data)
+        elif self.format_type == "csv":
+            result = self._format_csv(structure_data)
+        elif self.format_type == "json":
+            result = self._format_json(structure_data)
+        else:
+            raise ValueError(f"Unsupported format type: {self.format_type}")
+
+        # Finally convert to platform-specific newline characters
+        # Skip newline conversion for CSV and JSON formats
+        if self.format_type in ["csv", "json"]:
+            return result
+
+        return self._convert_to_platform_newlines(result)
+
+    def _format_full_table(self, data: dict[str, Any]) -> str:
+        """Full table format - organized by class"""
+        lines = []
+
+        # Header - use language-specific title generation
+        title = self._generate_title(data)
+        lines.append(f"# {title}")
+        lines.append("")
+
+        # Get classes for later use
+        classes = data.get("classes", [])
+        if classes is None:
+            classes = []
+
+        # Package info
+        package_name = (data.get("package") or {}).get("name", "unknown")
+        if package_name and package_name != "unknown":
+            lines.append("## Package")
+            lines.append(f"`{package_name}`")
+            lines.append("")
+
+        # Imports
+        imports = data.get("imports", [])
+        if imports:
+            lines.append("## Imports")
+            lines.append(f"```{self.language}")
+            for imp in imports:
+                lines.append(str(imp.get("statement", "")))
+            lines.append("```")
+            lines.append("")
+
+        # Class Info section (for single class files or empty data)
+        if len(classes) == 1 or len(classes) == 0:
+            lines.append("## Class Info")
+            lines.append("| Property | Value |")
+            lines.append("|----------|-------|")
+
+            # Re-use package_name from above instead of re-fetching
+
+            if len(classes) == 1:
+                class_info = classes[0]
+                lines.append(f"| Package | {package_name} |")
+                lines.append(f"| Type | {str(class_info.get('type', 'class'))} |")
+                lines.append(
+                    f"| Visibility | {str(class_info.get('visibility', 'public'))} |"
+                )
+
+                # Lines
+                line_range = class_info.get("line_range", {})
+                lines_str = f"{line_range.get('start', 1)}-{line_range.get('end', 50)}"
+                lines.append(f"| Lines | {lines_str} |")
+            else:
+                # Empty data case
+                lines.append(f"| Package | {package_name} |")
+                lines.append("| Type | class |")
+                lines.append("| Visibility | public |")
+                lines.append("| Lines | 0-0 |")
+
+            # Count methods and fields
+            all_methods = data.get("methods", []) or []
+            all_fields = data.get("fields", []) or []
+            lines.append(f"| Total Methods | {len(all_methods)} |")
+            lines.append(f"| Total Fields | {len(all_fields)} |")
+            lines.append("")
+
+        # Classes Overview
+        if len(classes) > 1:
+            lines.append("## Classes Overview")
+            lines.append("| Class | Type | Visibility | Lines | Methods | Fields |")
+            lines.append("|-------|------|------------|-------|---------|--------|")
+
+            for class_info in classes:
+                name = str(class_info.get("name", "Unknown"))
+                class_type = str(class_info.get("type", "class"))
+                visibility = str(class_info.get("visibility", "public"))
+                line_range = class_info.get("line_range", {})
+                lines_str = f"{line_range.get('start', 0)}-{line_range.get('end', 0)}"
+
+                # Calculate method and field counts for this class
+                class_methods = self._get_class_methods(data, line_range)
+                class_fields = self._get_class_fields(data, line_range)
+
+                lines.append(
+                    f"| {name} | {class_type} | {visibility} | {lines_str} | {len(class_methods)} | {len(class_fields)} |"
+                )
+            lines.append("")
+
+        # Detailed class information - organized by class
+        for class_info in classes:
+            lines.extend(self._format_class_details(class_info, data))
+
+        # Remove trailing empty lines
+        while lines and lines[-1] == "":
+            lines.pop()
+
+        return "\n".join(lines)
+
+    def _get_class_methods(
+        self, data: dict[str, Any], class_line_range: dict[str, int]
+    ) -> list[dict[str, Any]]:
+        """Get methods that belong to a specific class based on line range, excluding nested classes."""
+        methods = data.get("methods", [])
+        classes = data.get("classes", [])
+        class_methods = []
+
+        # Get nested class ranges to exclude their methods
+        nested_class_ranges = []
+        for cls in classes:
+            cls_range = cls.get("line_range", {})
+            cls_start = cls_range.get("start", 0)
+            cls_end = cls_range.get("end", 0)
+
+            # If this class is nested within the current class range
+            if class_line_range.get(
+                "start", 0
+            ) < cls_start and cls_end < class_line_range.get("end", 0):
+                nested_class_ranges.append((cls_start, cls_end))
+
+        for method in methods:
+            method_line = method.get("line_range", {}).get("start", 0)
+
+            # Check if method is within the class range
+            if (
+                class_line_range.get("start", 0)
+                <= method_line
+                <= class_line_range.get("end", 0)
+            ):
+                # Check if method is NOT within any nested class
+                in_nested_class = False
+                for nested_start, nested_end in nested_class_ranges:
+                    if nested_start <= method_line <= nested_end:
+                        in_nested_class = True
+                        break
+
+                if not in_nested_class:
+                    class_methods.append(method)
+
+        return class_methods
+
+    def _get_class_fields(
+        self, data: dict[str, Any], class_line_range: dict[str, int]
+    ) -> list[dict[str, Any]]:
+        """Get fields that belong to a specific class based on line range, excluding nested classes."""
+        fields = data.get("fields", [])
+        classes = data.get("classes", [])
+        class_fields = []
+
+        # Get nested class ranges to exclude their fields
+        nested_class_ranges = []
+        for cls in classes:
+            cls_range = cls.get("line_range", {})
+            cls_start = cls_range.get("start", 0)
+            cls_end = cls_range.get("end", 0)
+
+            # If this class is nested within the current class range
+            if class_line_range.get(
+                "start", 0
+            ) < cls_start and cls_end < class_line_range.get("end", 0):
+                nested_class_ranges.append((cls_start, cls_end))
+
+        for field in fields:
+            field_line = field.get("line_range", {}).get("start", 0)
+
+            # Check if field is within the class range
+            if (
+                class_line_range.get("start", 0)
+                <= field_line
+                <= class_line_range.get("end", 0)
+            ):
+                # Check if field is NOT within any nested class
+                in_nested_class = False
+                for nested_start, nested_end in nested_class_ranges:
+                    if nested_start <= field_line <= nested_end:
+                        in_nested_class = True
+                        break
+
+                if not in_nested_class:
+                    class_fields.append(field)
+
+        return class_fields
+
+    def _format_class_details(
+        self, class_info: dict[str, Any], data: dict[str, Any]
+    ) -> list[str]:
+        """Format detailed information for a single class."""
+        lines = []
+
+        name = str(class_info.get("name", "Unknown"))
+        line_range = class_info.get("line_range", {})
+        lines_str = f"{line_range.get('start', 0)}-{line_range.get('end', 0)}"
+
+        # Class header
+        lines.append(f"## {name} ({lines_str})")
+
+        # Get class-specific methods and fields
+        class_methods = self._get_class_methods(data, line_range)
+        class_fields = self._get_class_fields(data, line_range)
+
+        # Fields section
+        if class_fields:
+            lines.append("### Fields")
+            lines.append("| Name | Type | Vis | Modifiers | Line | Doc |")
+            lines.append("|------|------|-----|-----------|------|-----|")
+
+            for field in class_fields:
+                name_field = str(field.get("name", ""))
+                type_field = str(field.get("type", ""))
+                visibility = self._convert_visibility(str(field.get("visibility", "")))
+                modifiers = ",".join(field.get("modifiers", []))
+                line_num = field.get("line_range", {}).get("start", 0)
+                doc = (
+                    self._extract_doc_summary(str(field.get("javadoc", "")))
+                    if self.include_javadoc
+                    else "-"
+                )
+
+                lines.append(
+                    f"| {name_field} | {type_field} | {visibility} | {modifiers} | {line_num} | {doc} |"
+                )
+            lines.append("")
+
+        # Methods section - separate by type
+        constructors = [m for m in class_methods if m.get("is_constructor", False)]
+        regular_methods = [
+            m for m in class_methods if not m.get("is_constructor", False)
+        ]
+
+        # Constructors
+        if constructors:
+            lines.append("### Constructors")
+            lines.append("| Constructor | Signature | Vis | Lines | Cx | Doc |")
+            lines.append("|-------------|-----------|-----|-------|----|----|")
+
+            for method in constructors:
+                lines.append(self._format_method_row_detailed(method))
+            lines.append("")
+
+        # Methods grouped by visibility
+        public_methods = [
+            m for m in regular_methods if m.get("visibility", "") == "public"
+        ]
+        protected_methods = [
+            m for m in regular_methods if m.get("visibility", "") == "protected"
+        ]
+        package_methods = [
+            m for m in regular_methods if m.get("visibility", "") == "package"
+        ]
+        private_methods = [
+            m for m in regular_methods if m.get("visibility", "") == "private"
+        ]
+
+        for method_group, title in [
+            (public_methods, "Public Methods"),
+            (protected_methods, "Protected Methods"),
+            (package_methods, "Package Methods"),
+            (private_methods, "Private Methods"),
+        ]:
+            if method_group:
+                lines.append(f"### {title}")
+                lines.append("| Method | Signature | Vis | Lines | Cx | Doc |")
+                lines.append("|--------|-----------|-----|-------|----|----|")
+
+                for method in method_group:
+                    lines.append(self._format_method_row_detailed(method))
+                lines.append("")
+
+        return lines
+
+    def _format_method_row_detailed(self, method: dict[str, Any]) -> str:
+        """Format method row for detailed class view."""
+        name = str(method.get("name", ""))
+        signature = self._create_full_signature(method)
+        visibility = self._convert_visibility(str(method.get("visibility", "")))
+        line_range = method.get("line_range", {})
+        lines_str = f"{line_range.get('start', 0)}-{line_range.get('end', 0)}"
+        complexity = method.get("complexity_score", 0)
+        doc = (
+            self._extract_doc_summary(str(method.get("javadoc", "")))
+            if self.include_javadoc
+            else "-"
+        )
+
+        return f"| {name} | {signature} | {visibility} | {lines_str} | {complexity} | {doc} |"
+
+    def _format_traditional_sections(self, data: dict[str, Any]) -> list[str]:
+        """Format traditional sections when no classes are found."""
+        lines = []
+
+        # Traditional class info
+        lines.append("## Class Info")
+        lines.append("| Property | Value |")
+        lines.append("|----------|-------|")
+
+        package_name = (data.get("package") or {}).get("name", "unknown")
+        class_info = data.get("classes", [{}])[0] if data.get("classes") else {}
+        stats = data.get("statistics") or {}
+
+        lines.append(f"| Package | {package_name} |")
+        lines.append(f"| Type | {str(class_info.get('type', 'class'))} |")
+        lines.append(f"| Visibility | {str(class_info.get('visibility', 'public'))} |")
+        lines.append(
+            f"| Lines | {class_info.get('line_range', {}).get('start', 0)}-{class_info.get('line_range', {}).get('end', 0)} |"
+        )
+        lines.append(f"| Total Methods | {stats.get('method_count', 0)} |")
+        lines.append(f"| Total Fields | {stats.get('field_count', 0)} |")
+        lines.append("")
+
+        # Fields
+        fields = data.get("fields", [])
+        if fields:
+            lines.append("## Fields")
+            lines.append("| Name | Type | Vis | Modifiers | Line | Doc |")
+            lines.append("|------|------|-----|-----------|------|-----|")
+
+            for field in fields:
+                name = str(field.get("name", ""))
+                field_type = str(field.get("type", ""))
+                visibility = self._convert_visibility(str(field.get("visibility", "")))
+                modifiers = ",".join([str(m) for m in field.get("modifiers", [])])
+                line = field.get("line_range", {}).get("start", 0)
+                doc = (
+                    self._extract_doc_summary(str(field.get("javadoc", "")))
+                    if self.include_javadoc
+                    else "-"
+                )
+
+                lines.append(
+                    f"| {name} | {field_type} | {visibility} | {modifiers} | {line} | {doc} |"
+                )
+            lines.append("")
+
+        # Methods by type
+        methods = data.get("methods", [])
+        constructors = [m for m in methods if m.get("is_constructor", False)]
+        regular_methods = [m for m in methods if not m.get("is_constructor", False)]
+
+        # Constructors
+        if constructors:
+            lines.append("## Constructor")
+            lines.append("| Method | Signature | Vis | Lines | Cols | Cx | Doc |")
+            lines.append("|--------|-----------|-----|-------|------|----|----|")
+            for method in constructors:
+                lines.append(self._format_method_row(method))
+            lines.append("")
+
+        # Methods by visibility
+        for visibility, title in [
+            ("public", "Public Methods"),
+            ("private", "Private Methods"),
+        ]:
+            visibility_methods = [
+                m for m in regular_methods if str(m.get("visibility")) == visibility
+            ]
+            if visibility_methods:
+                lines.append(f"## {title}")
+                lines.append("| Method | Signature | Vis | Lines | Cols | Cx | Doc |")
+                lines.append("|--------|-----------|-----|-------|------|----|----|")
+                for method in visibility_methods:
+                    lines.append(self._format_method_row(method))
+                lines.append("")
+
+        return lines
+
+    def _generate_title(self, data: dict[str, Any]) -> str:
+        """
+        Generate document title based on language and structure.
+
+        Args:
+            data: Analysis result dictionary containing classes, package, file_path
+
+        Returns:
+            Formatted title string (without leading "# ")
+        """
+        language = self.language.lower()
+        package_name = (data.get("package") or {}).get("name", "")
+        classes = data.get("classes", []) or []
+        file_path = data.get("file_path", "")
+
+        # Extract filename without extension
+        filename = self._extract_filename(file_path)
+
+        if language == "java":
+            return self._generate_java_title(package_name, classes, filename)
+        elif language == "python":
+            return self._generate_python_title(filename)
+        elif language in ["javascript", "typescript", "js", "ts"]:
+            return self._generate_js_ts_title(classes, filename)
+        else:
+            # Default fallback
+            return self._generate_default_title(package_name, classes, filename)
+
+    def _generate_java_title(
+        self, package_name: str, classes: list, filename: str
+    ) -> str:
+        """Generate title for Java files."""
+        if len(classes) == 1:
+            # Single class: use package.ClassName format
+            class_name = classes[0].get("name", "Unknown")
+            if package_name and package_name != "unknown":
+                return f"{package_name}.{class_name}"
+            return class_name
+        else:
+            # Multiple classes or no classes: use package.filename format
+            if package_name and package_name != "unknown":
+                return f"{package_name}.{filename}"
+            return filename
+
+    def _generate_python_title(self, filename: str) -> str:
+        """Generate title for Python files."""
+        return f"Module: {filename}"
+
+    def _generate_js_ts_title(self, classes: list, filename: str) -> str:
+        """Generate title for JavaScript/TypeScript files."""
+        if classes:
+            # Use primary (first) class name
+            return classes[0].get("name", filename)
+        return filename
+
+    def _generate_default_title(
+        self, package_name: str, classes: list, filename: str
+    ) -> str:
+        """Generate default title for unsupported languages."""
+        if len(classes) == 1:
+            class_name = classes[0].get("name", "Unknown")
+            if package_name and package_name != "unknown":
+                return f"{package_name}.{class_name}"
+            return class_name
+        return filename
+
+    def _extract_filename(self, file_path: str) -> str:
+        """Extract filename without extension from file path."""
+        if not file_path or file_path == "Unknown":
+            return "unknown"
+
+        # Get basename
+        filename = file_path.split("/")[-1].split("\\")[-1]
+
+        # Remove common extensions
+        for ext in [".java", ".py", ".js", ".ts", ".tsx", ".jsx"]:
+            if filename.endswith(ext):
+                filename = filename[: -len(ext)]
+                break
+
+        return filename or "unknown"
+
+    def _format_compact_table(self, data: dict[str, Any]) -> str:
+        """Compact table format"""
+        lines = []
+
+        # Header - use language-specific title generation
+        title = self._generate_title(data)
+        lines.append(f"# {title}")
+        lines.append("")
+
+        # Basic information
+        stats = data.get("statistics") or {}
+        package_name = (data.get("package") or {}).get("name", "unknown")
+        lines.append("## Info")
+        lines.append("| Property | Value |")
+        lines.append("|----------|-------|")
+        lines.append(f"| Package | {package_name} |")
+        lines.append(f"| Methods | {stats.get('method_count', 0)} |")
+        lines.append(f"| Fields | {stats.get('field_count', 0)} |")
+        lines.append("")
+
+        # Methods (simplified version)
+        methods = data.get("methods", [])
+        if methods is None:
+            methods = []
+        if methods:
+            lines.append("## Methods")
+            lines.append("| Method | Sig | V | L | Cx | Doc |")
+            lines.append("|--------|-----|---|---|----|----|")
+
+            for method in methods:
+                name = str(method.get("name", ""))
+                signature = self._create_compact_signature(method)
+                visibility = self._convert_visibility(str(method.get("visibility", "")))
+                line_range = method.get("line_range", {})
+                lines_str = f"{line_range.get('start', 0)}-{line_range.get('end', 0)}"
+                complexity = method.get("complexity_score", 0)
+                doc = self._clean_csv_text(
+                    self._extract_doc_summary(str(method.get("javadoc", "")))
+                )
+
+                lines.append(
+                    f"| {name} | {signature} | {visibility} | {lines_str} | {complexity} | {doc} |"
+                )
+            lines.append("")
+
+        # Remove trailing empty lines
+        while lines and lines[-1] == "":
+            lines.pop()
+
+        return "\n".join(lines)
+
+    def _format_csv(self, data: dict[str, Any]) -> str:
+        """CSV format"""
+        output = io.StringIO()
+        writer = csv.writer(
+            output, lineterminator="\n"
+        )  # Explicitly specify newline character
+
+        # Header
+        writer.writerow(
+            ["Type", "Name", "Signature", "Visibility", "Lines", "Complexity", "Doc"]
+        )
+
+        # Fields
+        for field in data.get("fields", []):
+            writer.writerow(
+                [
+                    "Field",
+                    str(field.get("name", "")),
+                    f"{str(field.get('name', ''))}:{str(field.get('type', ''))}",
+                    str(field.get("visibility", "")),
+                    f"{field.get('line_range', {}).get('start', 0)}-{field.get('line_range', {}).get('end', 0)}",
+                    "",
+                    self._clean_csv_text(
+                        self._extract_doc_summary(str(field.get("javadoc", "")))
+                    ),
+                ]
+            )
+
+        # Methods
+        for method in data.get("methods", []):
+            writer.writerow(
+                [
+                    "Constructor" if method.get("is_constructor", False) else "Method",
+                    str(method.get("name", "")),
+                    self._clean_csv_text(self._create_full_signature(method)),
+                    str(method.get("visibility", "")),
+                    f"{method.get('line_range', {}).get('start', 0)}-{method.get('line_range', {}).get('end', 0)}",
+                    method.get("complexity_score", 0),
+                    self._clean_csv_text(
+                        self._extract_doc_summary(str(method.get("javadoc", "")))
+                    ),
+                ]
+            )
+
+        # Completely control CSV output newlines
+        csv_content = output.getvalue()
+        # Unify all newline patterns and remove trailing newlines
+        csv_content = csv_content.replace("\r\n", "\n").replace("\r", "\n")
+        csv_content = csv_content.rstrip("\n")
+        output.close()
+
+        return csv_content
+
+    def _format_json(self, data: dict[str, Any]) -> str:
+        """JSON format"""
+        # Create a clean JSON structure with all the analysis data
+        json_data = {
+            "file_info": {
+                "file_path": data.get("file_path", ""),
+                "language": data.get("language", ""),
+                "package": data.get("package"),
+            },
+            "statistics": data.get("statistics", {}),
+            "elements": {
+                "classes": data.get("classes", []),
+                "methods": data.get("methods", []),
+                "fields": data.get("fields", []),
+                "imports": data.get("imports", []),
+            },
+        }
+
+        # Return formatted JSON with proper indentation
+        return json.dumps(json_data, indent=2, ensure_ascii=False)
+
+    def _format_method_row(self, method: dict[str, Any]) -> str:
+        """Format method row"""
+        name = str(method.get("name", ""))
+        signature = self._create_full_signature(method)
+        visibility = self._convert_visibility(str(method.get("visibility", "")))
+        line_range = method.get("line_range", {})
+        lines_str = f"{line_range.get('start', 0)}-{line_range.get('end', 0)}"
+        cols_str = (
+            "5-6"  # Default value (actual implementation should get accurate values)
+        )
+        complexity = method.get("complexity_score", 0)
+        if self.include_javadoc:
+            doc = self._clean_csv_text(
+                self._extract_doc_summary(str(method.get("javadoc", "")))
+            )
+        else:
+            doc = "-"
+
+        return f"| {name} | {signature} | {visibility} | {lines_str} | {cols_str} | {complexity} | {doc} |"
+
+    def _create_full_signature(self, method: dict[str, Any]) -> str:
+        """Create complete method signature"""
+        params = method.get("parameters", [])
+        param_strs = []
+        for param in params:
+            param_type = str(param.get("type", "Object"))
+            param_name = str(param.get("name", "param"))
+            param_strs.append(f"{param_name}:{param_type}")
+
+        params_str = ", ".join(param_strs)
+        return_type = str(method.get("return_type", "void"))
+
+        modifiers = []
+        if method.get("is_static", False):
+            modifiers.append("[static]")
+
+        modifier_str = " ".join(modifiers)
+        signature = f"({params_str}):{return_type}"
+
+        if modifier_str:
+            signature += f" {modifier_str}"
+
+        return signature
+
+    def _create_compact_signature(self, method: dict[str, Any]) -> str:
+        """Create compact method signature"""
+        params = method.get("parameters", [])
+        param_types = [self._shorten_type(p.get("type", "O")) for p in params]
+        params_str = ",".join(param_types)
+        return_type = self._shorten_type(method.get("return_type", "void"))
+
+        return f"({params_str}):{return_type}"
+
+    def _shorten_type(self, type_name: Any) -> str:
+        """Shorten type name"""
+        if type_name is None:
+            return "O"
+
+        # Convert non-string types to string
+        if not isinstance(type_name, str):
+            type_name = str(type_name)
+
+        # At this point, type_name is guaranteed to be a string
+        # Defensive check (avoid using assert for runtime safety and security checks)
+        if not isinstance(type_name, str):
+            try:
+                type_name = str(type_name)
+            except Exception:
+                type_name = "O"
+
+        type_mapping = {
+            "String": "S",
+            "int": "i",
+            "long": "l",
+            "double": "d",
+            "boolean": "b",
+            "void": "void",
+            "Object": "O",
+            "Exception": "E",
+            "SQLException": "SE",
+            "IllegalArgumentException": "IAE",
+            "RuntimeException": "RE",
+        }
+
+        # Map<String,Object> -> M<S,O>
+        if "Map<" in type_name:
+            return str(
+                type_name.replace("Map<", "M<")
+                .replace("String", "S")
+                .replace("Object", "O")
+            )
+
+        # List<String> -> L<S>
+        if "List<" in type_name:
+            return str(type_name.replace("List<", "L<").replace("String", "S"))
+
+        # String[] -> S[]
+        if "[]" in type_name:
+            base_type = type_name.replace("[]", "")
+            if base_type:
+                return str(type_mapping.get(base_type, base_type[0].upper())) + "[]"
+            else:
+                return "O[]"
+
+        return str(type_mapping.get(type_name, type_name))
+
+    def _convert_visibility(self, visibility: str) -> str:
+        """Convert visibility to symbol"""
+        mapping = {"public": "+", "private": "-", "protected": "#", "package": "~"}
+        return mapping.get(visibility, visibility)
+
+    def _extract_doc_summary(self, javadoc: str) -> str:
+        """Extract summary from JavaDoc"""
+        if not javadoc:
+            return "-"
+
+        # Remove comment symbols
+        clean_doc = (
+            javadoc.replace("/**", "").replace("*/", "").replace("*", "").strip()
+        )
+
+        # Get first line (use standard \\n only)
+        lines = clean_doc.split("\n")
+        first_line = lines[0].strip()
+
+        # Truncate if too long
+        if len(first_line) > 50:
+            first_line = first_line[:47] + "..."
+
+        # Escape characters that cause problems in Markdown tables (use standard \\n only)
+        return first_line.replace("|", "\\|").replace("\n", " ")
+
+    def _clean_csv_text(self, text: str) -> str:
+        """Text cleaning for CSV format"""
+        if not text:
+            return ""
+
+        # Replace all newline characters with spaces
+        cleaned = text.replace("\r\n", " ").replace("\r", " ").replace("\n", " ")
+        # Convert consecutive spaces to single space
+        cleaned = " ".join(cleaned.split())
+        # Escape characters that cause problems in CSV
+        cleaned = cleaned.replace('"', '""')  # Escape double quotes
+
+        return cleaned
+
+
+def create_table_formatter(
+    format_type: str, language: str = "java", include_javadoc: bool = False
+) -> "TableFormatter":
+    """Create table formatter (using new factory)"""
+    # Create TableFormatter directly (for JavaDoc support)
+    return TableFormatter(format_type, language, include_javadoc)