code2llm 0.5.125__tar.gz → 0.5.126__tar.gz

{code2llm-0.5.125 → code2llm-0.5.126}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: code2llm
-Version: 0.5.125
+Version: 0.5.126
 Summary: High-performance Python code flow analysis with optimized TOON format - CFG, DFG, call graphs, and intelligent code queries
 Home-page: https://github.com/wronai/stts
 Author: STTS Project
@@ -67,7 +67,7 @@ Dynamic: requires-python
 
 ## AI Cost Tracking
 
-![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-0.5.125-blue) ![Python](https://img.shields.io/badge/python-3.9+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
+![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-0.5.126-blue) ![Python](https://img.shields.io/badge/python-3.9+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
 ![AI Cost](https://img.shields.io/badge/AI%20Cost-$7.50-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-57.3h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
 
 - 🤖 **LLM usage:** $7.5000 (166 commits)

{code2llm-0.5.125 → code2llm-0.5.126}/README.md

@@ -3,7 +3,7 @@
 
 ## AI Cost Tracking
 
-![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-0.5.125-blue) ![Python](https://img.shields.io/badge/python-3.9+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
+![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-0.5.126-blue) ![Python](https://img.shields.io/badge/python-3.9+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
 ![AI Cost](https://img.shields.io/badge/AI%20Cost-$7.50-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-57.3h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
 
 - 🤖 **LLM usage:** $7.5000 (166 commits)

{code2llm-0.5.125 → code2llm-0.5.126}/code2llm/__init__.py

@@ -8,7 +8,7 @@ Includes NLP Processing Pipeline for query normalization, intent matching,
 and entity resolution with multilingual support.
 """
 
-__version__ = "0.5.125"
+__version__ = "0.5.126"
 __author__ = "STTS Project"
 
 # Core analysis components (lightweight, always needed)

{code2llm-0.5.125 → code2llm-0.5.126}/code2llm/cli_exports/__init__.py

@@ -27,6 +27,10 @@ from .orchestrator import (
     _export_single_project,
     _export_chunked_results,
 )
+from .orchestrator_chunked import (
+    _get_filtered_subprojects,
+    _process_subproject,
+)
 
 __all__ = [
     "_export_simple_formats",
@@ -45,4 +49,6 @@ __all__ = [
     "_run_exports",
     "_export_single_project",
     "_export_chunked_results",
+    "_get_filtered_subprojects",
+    "_process_subproject",
 ]

{code2llm-0.5.125 → code2llm-0.5.126}/code2llm/cli_exports/orchestrator.py

@@ -27,45 +27,24 @@ from code2llm.exporters import (
 from code2llm.exporters.project_yaml.evolution import load_previous_evolution
 from code2llm.core.persistent_cache import PersistentCache
 from code2llm.core.config import DEFAULT_PROGRESS_BAR_THRESHOLD
-
-
-# Format output filenames
-FORMAT_FILENAMES: Dict[str, str] = {
-    'toon': 'analysis.toon.yaml',
-    'map': 'map.toon.yaml',
-    'flow': 'flow.toon.yaml',
-    'context': 'context.md',
-    'yaml': 'analysis.yaml',
-    'json': 'analysis.json',
-    'evolution': 'evolution.toon.yaml',
-    'readme': 'README.md',
-    'project-yaml': 'project.yaml',
-}
-
-# Files produced per format in dry-run preview
-FORMAT_DRY_RUN_FILES: Dict[str, List[str]] = {
-    'toon':      ['analysis.toon'],
-    'map':       ['map.toon.yaml'],
-    'evolution': ['evolution.toon.yaml'],
-    'context':   ['context.md'],
-    'mermaid':   ['calls.mmd', 'calls.png'],
-    'yaml':      ['analysis.yaml'],
-    'json':      ['analysis.json'],
-    'readme':    ['README.md'],
-}
-
-# Human-readable labels
-FORMAT_LABELS: Dict[str, str] = {
-    'toon': 'TOON (diagnostics)',
-    'map': 'MAP (structure)',
-    'flow': 'FLOW (data-flow)',
-    'context': 'CONTEXT (LLM narrative)',
-    'yaml': 'YAML',
-    'json': 'JSON',
-    'evolution': 'EVOLUTION (refactoring queue)',
-    'readme': 'README (documentation)',
-    'project-yaml': 'PROJECT-YAML (single source of truth)',
-}
+from .orchestrator_constants import (
+    FORMAT_FILENAMES,
+    FORMAT_DRY_RUN_FILES,
+    FORMAT_LABELS,
+)
+from .orchestrator_handlers import (
+    _export_mermaid,
+    _export_calls,
+    _export_context_fallback,
+    _export_data_structures,
+    _export_project_toon,
+    _export_readme,
+    _export_index_html,
+)
+from .orchestrator_chunked import (
+    _get_filtered_subprojects,
+    _process_subproject,
+)
 
 
 def _build_export_config(args, formats: List[str]) -> Dict[str, Any]:
@@ -302,185 +281,13 @@ def _get_format_kwargs(fmt: str, args) -> Dict[str, Any]:
     return kwargs
 
 
-def _export_mermaid(args, result, output_dir: Path):
-    """Export mermaid diagrams."""
-    exporter = MermaidExporter()
-    include_examples = getattr(args, 'flow_include_examples', False)
-
-    # Core diagrams
-    exporter.export_flow_compact(result, str(output_dir / 'flow.mmd'), include_examples)
-    exporter.export_call_graph(result, str(output_dir / 'calls.mmd'))
-    exporter.export_compact(result, str(output_dir / 'compact_flow.mmd'))
-
-    # Optional detailed diagrams
-    if getattr(args, 'flow_detail', False):
-        exporter.export_flow_detailed(result, str(output_dir / 'flow_detailed.mmd'), include_examples)
-    if getattr(args, 'flow_full', False):
-        exporter.export_flow_full(result, str(output_dir / 'flow_full.mmd'), include_examples)
-
-    # Also export calls.yaml/toon
-    yaml_exporter = YAMLExporter()
-    yaml_exporter.export_calls(result, str(output_dir / 'calls.yaml'))
-    yaml_exporter.export_calls_toon(result, str(output_dir / 'calls.toon.yaml'))
-
-    if args.verbose:
-        files = ['flow.mmd', 'calls.mmd', 'compact_flow.mmd', 'calls.yaml']
-        if getattr(args, 'flow_detail', False):
-            files.append('flow_detailed.mmd')
-        if getattr(args, 'flow_full', False):
-            files.append('flow_full.mmd')
-        print(f"  - Mermaid: {output_dir}/*.mmd ({', '.join(files)})")
-
-    # PNG generation
-    _export_mermaid_pngs(args, output_dir)
-
-
-def _export_mermaid_pngs(args, output_dir: Path):
-    """Generate PNGs from mermaid files."""
-    if getattr(args, 'no_png', False):
-        return
-    try:
-        from ..generators.mermaid import generate_pngs
-        png_count = generate_pngs(output_dir, output_dir)
-        if args.verbose and png_count > 0:
-            print(f"  - PNG: {png_count} files generated")
-    except ImportError:
-        if args.verbose:
-            print(f"  - PNG: Skipped (install with: make install-mermaid)")
-
-
-def _export_calls(args, result, output_dir: Path, formats: List[str]):
-    """Export calls.yaml and calls.toon.yaml."""
-    yaml_exporter = YAMLExporter()
-    if 'calls' in formats:
-        yaml_exporter.export_calls(result, str(output_dir / 'calls.yaml'))
-        if args.verbose:
-            print(f"  - CALLS (call graph YAML): {output_dir / 'calls.yaml'}")
-    if 'calls_toon' in formats:
-        yaml_exporter.export_calls_toon(result, str(output_dir / 'calls.toon.yaml'))
-        if args.verbose:
-            print(f"  - CALLS (toon format): {output_dir / 'calls.toon.yaml'}")
-
-
-def _export_context_fallback(args, result, output_dir: Path):
-    """Export context.md as fallback."""
-    exporter_cls = get_exporter('context')
-    if exporter_cls:
-        exporter = exporter_cls()
-        exporter.export(result, str(output_dir / 'context.md'))
-        if args.verbose:
-            print(f"  - CONTEXT (LLM narrative): {output_dir / 'context.md'}")
-
-
-def _export_data_structures(args, result, output_dir: Path):
-    """Export data_structures.yaml."""
-    yaml_exporter = YAMLExporter()
-    yaml_exporter.export_data_structures(result, str(output_dir / 'data_structures.yaml'), compact=True)
-    if args.verbose:
-        print(f"  - Data structures: {output_dir / 'data_structures.yaml'}")
-
-
-def _export_project_toon(args, result, output_dir: Path):
-    """Export project.toon.yaml from project.yaml data."""
-    from ..exporters.project_yaml_exporter import ProjectYAMLExporter
-
-    project_yaml_exporter = ProjectYAMLExporter()
-    prev_evolution = load_previous_evolution(output_dir / 'project.yaml')
-    data = project_yaml_exporter._build_project_yaml(result, prev_evolution)
-
-    generator = ToonViewGenerator()
-    generator.generate(data, str(output_dir / 'project.toon.yaml'))
-
-    if args.verbose:
-        print(f"  - PROJECT-TOON (project overview): {output_dir / 'project.toon.yaml'}")
-
-
-def _export_readme(args, result, output_dir: Path):
-    """Export README.md."""
-    if getattr(args, 'no_readme', False):
-        return
-    exporter_cls = get_exporter('readme')
-    if exporter_cls:
-        exporter = exporter_cls()
-        exporter.export(result, str(output_dir / 'README.md'))
-        if args.verbose:
-            print(f"  - README (documentation): {output_dir / 'README.md'}")
-
-
-def _export_index_html(args, output_dir: Path):
-    """Generate index.html for browsing files."""
-    if 'all' not in getattr(args, 'format', ''):
-        return
-    try:
-        generator = IndexHTMLGenerator(output_dir)
-        index_path = generator.generate()
-        if args.verbose:
-            print(f"  - INDEX (file browser): {index_path}")
-    except Exception as e:
-        if args.verbose:
-            print(f"  - INDEX generation failed: {e}", file=sys.stderr)
-
-
 def _export_chunked(
     args, result, output_dir: Path, source_path: Path,
     formats: List[str], requested_formats: List[str]
 ):
     """Export chunked analysis results."""
-    subprojects = _get_filtered_subprojects(args, source_path)
-
-    for sp in subprojects:
-        _process_subproject(args, sp, output_dir)
-
-    # Merged summary
-    _export_registry_formats(args, result, output_dir, ['toon', 'context', 'evolution'])
-
-    if 'calls' in formats or 'calls_toon' in formats:
-        _export_calls(args, result, output_dir, formats)
-    if 'all' in requested_formats:
-        _export_project_toon(args, result, output_dir)
-
-    if source_path is not None:
-        from .code2logic import _export_code2logic
-        from .prompt import _export_chunked_prompt_txt
-        _export_code2logic(args, source_path, output_dir, formats)
-        _export_chunked_prompt_txt(args, output_dir, requested_formats, source_path, subprojects)
-
-    _export_readme(args, result, output_dir)
-    _export_index_html(args, output_dir)
-
-
-def _get_filtered_subprojects(args, source_path: Path):
-    """Get filtered subprojects list."""
-    from ..core.large_repo import HierarchicalRepoSplitter
-
-    splitter = HierarchicalRepoSplitter(size_limit_kb=args.chunk_size)
-    subprojects = splitter.get_analysis_plan(source_path)
-
-    if getattr(args, 'only_subproject', None):
-        subprojects = [
-            sp for sp in subprojects
-            if sp.name == args.only_subproject or sp.name.startswith(args.only_subproject + '.')
-        ]
-    if getattr(args, 'skip_subprojects', None):
-        subprojects = [
-            sp for sp in subprojects
-            if not any(sp.name.startswith(skip) for skip in args.skip_subprojects)
-        ]
-    return subprojects
-
-
-def _process_subproject(args, sp, output_dir: Path):
-    """Process a single subproject result."""
-    sp_output_dir = output_dir / sp.name.replace('.', '_')
-    if not sp_output_dir.exists():
-        return
-    for ext in ['.toon', '.yaml', '.json']:
-        result_file = sp_output_dir / f'analysis{ext}'
-        if result_file.exists():
-            if args.verbose:
-                level_name = {0: 'root', 1: 'L1', 2: 'L2'}.get(sp.level, f'L{sp.level}')
-                print(f"  - Exported [{level_name}] {sp.name}")
-            break
+    from .orchestrator_chunked import _export_chunked as _chunked_impl
+    _chunked_impl(args, result, output_dir, source_path, formats, requested_formats)
 
 
 # Backward-compatible aliases

code2llm-0.5.126/code2llm/cli_exports/orchestrator_chunked.py

@@ -0,0 +1,87 @@
+"""Chunked export functionality — handles multi-subproject analysis export.
+
+Extracted from orchestrator.py to reduce its complexity and separate
+the chunked/distributed analysis concerns.
+"""
+
+from pathlib import Path
+from typing import List
+
+from ..core.large_repo import HierarchicalRepoSplitter
+from .orchestrator_handlers import (
+    _export_calls,
+    _export_project_toon,
+    _export_readme,
+    _export_index_html,
+)
+
+
+def _export_chunked(
+    args,
+    result,
+    output_dir: Path,
+    source_path: Path,
+    formats: List[str],
+    requested_formats: List[str],
+):
+    """Export chunked analysis results."""
+    from .orchestrator import _export_registry_formats
+    from .code2logic import _export_code2logic
+    from .prompt import _export_chunked_prompt_txt
+
+    subprojects = _get_filtered_subprojects(args, source_path)
+    for sp in subprojects:
+        _process_subproject(args, sp, output_dir)
+
+    _export_registry_formats(args, result, output_dir, ['toon', 'context', 'evolution'])
+
+    if 'calls' in formats or 'calls_toon' in formats:
+        _export_calls(args, result, output_dir, formats)
+    if 'all' in requested_formats:
+        _export_project_toon(args, result, output_dir)
+
+    if source_path is not None:
+        _export_code2logic(args, source_path, output_dir, formats)
+        _export_chunked_prompt_txt(args, output_dir, requested_formats, source_path, subprojects)
+
+    _export_readme(args, result, output_dir)
+    _export_index_html(args, output_dir)
+
+
+def _get_filtered_subprojects(args, source_path: Path):
+    """Get filtered subprojects list based on CLI arguments."""
+    splitter = HierarchicalRepoSplitter(size_limit_kb=args.chunk_size)
+    subprojects = splitter.get_analysis_plan(source_path)
+
+    if getattr(args, 'only_subproject', None):
+        subprojects = [
+            sp for sp in subprojects
+            if sp.name == args.only_subproject or sp.name.startswith(args.only_subproject + '.')
+        ]
+    if getattr(args, 'skip_subprojects', None):
+        subprojects = [
+            sp for sp in subprojects
+            if not any(sp.name.startswith(skip) for skip in args.skip_subprojects)
+        ]
+    return subprojects
+
+
+def _process_subproject(args, sp, output_dir: Path):
+    """Process a single subproject result."""
+    sp_output_dir = output_dir / sp.name.replace('.', '_')
+    if not sp_output_dir.exists():
+        return
+    for ext in ['.toon', '.yaml', '.json']:
+        result_file = sp_output_dir / f'analysis{ext}'
+        if result_file.exists():
+            if args.verbose:
+                level_name = {0: 'root', 1: 'L1', 2: 'L2'}.get(sp.level, f'L{sp.level}')
+                print(f"  - Exported [{level_name}] {sp.name}")
+            break
+
+
+__all__ = [
+    '_export_chunked',
+    '_get_filtered_subprojects',
+    '_process_subproject',
+]

code2llm-0.5.126/code2llm/cli_exports/orchestrator_constants.py

@@ -0,0 +1,52 @@
+"""Export orchestrator constants — format filenames, labels, and dry-run mappings.
+
+This module centralizes all format-related constants for the export system
+to avoid duplication and enable easier maintenance.
+"""
+
+from typing import Dict, List
+
+
+# Format output filenames
+FORMAT_FILENAMES: Dict[str, str] = {
+    'toon': 'analysis.toon.yaml',
+    'map': 'map.toon.yaml',
+    'flow': 'flow.toon.yaml',
+    'context': 'context.md',
+    'yaml': 'analysis.yaml',
+    'json': 'analysis.json',
+    'evolution': 'evolution.toon.yaml',
+    'readme': 'README.md',
+    'project-yaml': 'project.yaml',
+}
+
+# Files produced per format in dry-run preview
+FORMAT_DRY_RUN_FILES: Dict[str, List[str]] = {
+    'toon':      ['analysis.toon'],
+    'map':       ['map.toon.yaml'],
+    'evolution': ['evolution.toon.yaml'],
+    'context':   ['context.md'],
+    'mermaid':   ['calls.mmd', 'calls.png'],
+    'yaml':      ['analysis.yaml'],
+    'json':      ['analysis.json'],
+    'readme':    ['README.md'],
+}
+
+# Human-readable labels
+FORMAT_LABELS: Dict[str, str] = {
+    'toon': 'TOON (diagnostics)',
+    'map': 'MAP (structure)',
+    'flow': 'FLOW (data-flow)',
+    'context': 'CONTEXT (LLM narrative)',
+    'yaml': 'YAML',
+    'json': 'JSON',
+    'evolution': 'EVOLUTION (refactoring queue)',
+    'readme': 'README (documentation)',
+    'project-yaml': 'PROJECT-YAML (single source of truth)',
+}
+
+__all__ = [
+    'FORMAT_FILENAMES',
+    'FORMAT_DRY_RUN_FILES',
+    'FORMAT_LABELS',
+]

code2llm-0.5.126/code2llm/cli_exports/orchestrator_handlers.py

@@ -0,0 +1,149 @@
+"""Export handlers — specific format export implementations.
+
+This module contains all the individual export handler functions
+that were extracted from orchestrator.py to reduce its size.
+"""
+
+from pathlib import Path
+from typing import Any, Dict, List
+
+from code2llm.exporters import (
+    get_exporter,
+    YAMLExporter,
+    MermaidExporter,
+    ToonViewGenerator,
+    IndexHTMLGenerator,
+)
+from code2llm.exporters.project_yaml.evolution import load_previous_evolution
+from .orchestrator_constants import FORMAT_LABELS
+
+
+def _export_mermaid(args, result, output_dir: Path):
+    """Export mermaid diagrams."""
+    exporter = MermaidExporter()
+    include_examples = getattr(args, 'flow_include_examples', False)
+
+    # Core diagrams
+    exporter.export_flow_compact(result, str(output_dir / 'flow.mmd'), include_examples)
+    exporter.export_call_graph(result, str(output_dir / 'calls.mmd'))
+    exporter.export_compact(result, str(output_dir / 'compact_flow.mmd'))
+
+    # Optional detailed diagrams
+    if getattr(args, 'flow_detail', False):
+        exporter.export_flow_detailed(result, str(output_dir / 'flow_detailed.mmd'), include_examples)
+    if getattr(args, 'flow_full', False):
+        exporter.export_flow_full(result, str(output_dir / 'flow_full.mmd'), include_examples)
+
+    # Also export calls.yaml/toon
+    yaml_exporter = YAMLExporter()
+    yaml_exporter.export_calls(result, str(output_dir / 'calls.yaml'))
+    yaml_exporter.export_calls_toon(result, str(output_dir / 'calls.toon.yaml'))
+
+    if args.verbose:
+        files = ['flow.mmd', 'calls.mmd', 'compact_flow.mmd', 'calls.yaml']
+        if getattr(args, 'flow_detail', False):
+            files.append('flow_detailed.mmd')
+        if getattr(args, 'flow_full', False):
+            files.append('flow_full.mmd')
+        print(f"  - Mermaid: {output_dir}/*.mmd ({', '.join(files)})")
+
+    # PNG generation
+    _export_mermaid_pngs(args, output_dir)
+
+
+def _export_mermaid_pngs(args, output_dir: Path):
+    """Generate PNGs from mermaid files."""
+    if getattr(args, 'no_png', False):
+        return
+    try:
+        from ..generators.mermaid import generate_pngs
+        png_count = generate_pngs(output_dir, output_dir)
+        if args.verbose and png_count > 0:
+            print(f"  - PNG: {png_count} files generated")
+    except ImportError:
+        if args.verbose:
+            print(f"  - PNG: Skipped (install with: make install-mermaid)")
+
+
+def _export_calls(args, result, output_dir: Path, formats: List[str]):
+    """Export calls.yaml and calls.toon.yaml."""
+    yaml_exporter = YAMLExporter()
+    if 'calls' in formats:
+        yaml_exporter.export_calls(result, str(output_dir / 'calls.yaml'))
+        if args.verbose:
+            print(f"  - CALLS (call graph YAML): {output_dir / 'calls.yaml'}")
+    if 'calls_toon' in formats:
+        yaml_exporter.export_calls_toon(result, str(output_dir / 'calls.toon.yaml'))
+        if args.verbose:
+            print(f"  - CALLS (toon format): {output_dir / 'calls.toon.yaml'}")
+
+
+def _export_context_fallback(args, result, output_dir: Path):
+    """Export context.md as fallback."""
+    exporter_cls = get_exporter('context')
+    if exporter_cls:
+        exporter = exporter_cls()
+        exporter.export(result, str(output_dir / 'context.md'))
+        if args.verbose:
+            print(f"  - CONTEXT (LLM narrative): {output_dir / 'context.md'}")
+
+
+def _export_data_structures(args, result, output_dir: Path):
+    """Export data_structures.yaml."""
+    yaml_exporter = YAMLExporter()
+    yaml_exporter.export_data_structures(result, str(output_dir / 'data_structures.yaml'), compact=True)
+    if args.verbose:
+        print(f"  - Data structures: {output_dir / 'data_structures.yaml'}")
+
+
+def _export_project_toon(args, result, output_dir: Path):
+    """Export project.toon.yaml from project.yaml data."""
+    from ..exporters.project_yaml_exporter import ProjectYAMLExporter
+
+    project_yaml_exporter = ProjectYAMLExporter()
+    prev_evolution = load_previous_evolution(output_dir / 'project.yaml')
+    data = project_yaml_exporter._build_project_yaml(result, prev_evolution)
+
+    generator = ToonViewGenerator()
+    generator.generate(data, str(output_dir / 'project.toon.yaml'))
+
+    if args.verbose:
+        print(f"  - PROJECT-TOON (project overview): {output_dir / 'project.toon.yaml'}")
+
+
+def _export_readme(args, result, output_dir: Path):
+    """Export README.md."""
+    if getattr(args, 'no_readme', False):
+        return
+    exporter_cls = get_exporter('readme')
+    if exporter_cls:
+        exporter = exporter_cls()
+        exporter.export(result, str(output_dir / 'README.md'))
+        if args.verbose:
+            print(f"  - README (documentation): {output_dir / 'README.md'}")
+
+
+def _export_index_html(args, output_dir: Path):
+    """Generate index.html for browsing files."""
+    if 'all' not in getattr(args, 'format', ''):
+        return
+    try:
+        generator = IndexHTMLGenerator(output_dir)
+        index_path = generator.generate()
+        if args.verbose:
+            print(f"  - INDEX (file browser): {index_path}")
+    except Exception as e:
+        if args.verbose:
+            print(f"  - INDEX generation failed: {e}", file=__import__('sys').stderr)
+
+
+__all__ = [
+    '_export_mermaid',
+    '_export_mermaid_pngs',
+    '_export_calls',
+    '_export_context_fallback',
+    '_export_data_structures',
+    '_export_project_toon',
+    '_export_readme',
+    '_export_index_html',
+]

code2llm-0.5.126/code2llm/exporters/map/__init__.py

@@ -0,0 +1,60 @@
+"""Map exporter package — generates map.toon.yaml (structural map).
+
+This package provides:
+- utils: Path handling, line counting, language detection
+- alerts: Build alerts and hotspots for header
+- header: Render header lines with project stats
+- module_list: Render M[] module list
+- details: Render D: details per module
+- yaml_export: Export to structured YAML format
+
+All public names are re-exported here for backward compatibility
+with the original map_exporter.py module structure.
+"""
+
+# Utils
+from .utils import (
+    rel_path,
+    file_line_count,
+    count_total_lines,
+    detect_languages,
+)
+
+# Alerts
+from .alerts import (
+    build_alerts,
+    build_hotspots,
+    load_evolution_trend,
+)
+
+# Header
+from .header import render_header
+
+# Module list
+from .module_list import render_module_list
+
+# Details
+from .details import render_details
+
+# YAML export
+from .yaml_export import export_to_yaml
+
+__all__ = [
+    # Utils
+    'rel_path',
+    'file_line_count',
+    'count_total_lines',
+    'detect_languages',
+    # Alerts
+    'build_alerts',
+    'build_hotspots',
+    'load_evolution_trend',
+    # Header
+    'render_header',
+    # Module list
+    'render_module_list',
+    # Details
+    'render_details',
+    # YAML export
+    'export_to_yaml',
+]