[tool.makefile.docs]
    # Base directory for all generated documentation
    # Default: "docs"
    output_dir = "docs"

    # Files/directories preserved during `make docs-clean`
    # Paths are relative to output_dir
    # Default: []
    no_clean = [".nojekyll"]

    # Shifts heading levels in combined markdown output (make docs-md)
    # With increment=2: # H1 → ### H3, ## H2 → #### H4
    # Useful when embedding generated docs in a larger document
    # Default: 2
    markdown_headings_increment = 2

    # Regex patterns for pdoc warnings to suppress
    # Matched against warning messages; use ".*pattern.*" for partial matches
    # Default: [] (show all warnings)
    warnings_ignore = [
        ".*No docstring.*",
        ".*Private member.*",
    ]

    # Jupyter notebook conversion settings
    [tool.makefile.docs.notebooks]
        # Master switch - set to true to convert .ipynb files to HTML
        # Requires nbformat and nbconvert packages
        # Default: false
        enabled = true

        # Directory containing source .ipynb files
        # Default: "notebooks"
        source_path = "notebooks"

        # Output subdirectory relative to output_dir
        # Default: "notebooks"
        output_path_relative = "notebooks"

        # Custom Jinja2 template for notebooks index page
        # Available variables: notebooks (list of dicts with ipynb, html, desc)
        # Default: built-in template
        # index_template = "..."

        # Map notebook filename (without .ipynb) to description
        # Shown on the notebooks index page
        # Notebooks not listed here appear with no description
        [tool.makefile.docs.notebooks.descriptions]
            "example" = "Example notebook showing basic usage"
            "advanced" = "Advanced usage patterns"

[tool.makefile.uv-exports]
    # Global args passed to ALL uv export commands
    # Default: []
    args = ["--no-hashes"]

    # Each entry generates a requirements file in .meta/requirements/
    # Default: [{ name = "all" }] (just base dependencies)
    exports = [
        # name (required): identifier for this export
        #   - must be alphanumeric
        #   - generates filename "requirements-{name}.txt" by default
        #
        # groups: which dependency groups to include
        #   - true: include ALL groups from [dependency-groups]
        #   - false: exclude ALL groups (base dependencies only)
        #   - ["dev", "lint"]: include only these specific groups
        #   - omitted/null: no group filtering
        #
        # extras: which optional dependencies to include
        #   - true: include ALL extras from [project.optional-dependencies]
        #   - false or []: no extras
        #   - ["cli"]: include only these specific extras
        #
        # filename: override the output filename
        #
        # options: raw args passed directly to uv export

        # Base dependencies only (from [project.dependencies])
        { name = "base", groups = false, extras = false },

        # All dependency groups, no extras
        { name = "groups", groups = true, extras = false },

        # Only the lint group - using raw uv options
        { name = "lint", options = ["--only-group", "lint"] },

        # Everything with custom filename
        { name = "all", filename = "requirements.txt", groups = true, extras = true },
    ]

[tool.makefile.inline-todo]
    # Root directory to search for TODOs
    # Default: "."
    search_dir = "."

    # Base path for output files (without extension)
    # Generates multiple files:
    #   - {base}.jsonl: raw data, one JSON object per line
    #   - {base}-standard.md: grouped by tag, then by file
    #   - {base}-table.md: flat table format
    #   - {base}.html: interactive HTML viewer
    # Default: "docs/todo-inline"
    out_file_base = "docs/other/todo-inline"

    # Lines of context to include before/after each TODO
    # Default: 2
    context_lines = 2

    # File extensions to scan (without dots)
    # Default: ["py", "md"]
    extensions = ["py", "md"]

    # Comment tags to search for (case-sensitive, exact match)
    # Must be surrounded by valid boundary characters (space, colon, brackets, etc.)
    # Default: ["CRIT", "TODO", "FIXME", "HACK", "BUG"]
    tags = ["CRIT", "TODO", "FIXME", "HACK", "BUG", "DOC"]

    # Glob patterns to exclude from search
    # Default: ["docs/**", ".venv/**"]
    exclude = ["docs/**", ".venv/**", "scripts/get_todos.py"]

    # Git branch for GitHub code links
    # Links point to: {repo_url}/blob/{branch}/{file}#L{line}
    # Default: "main"
    branch = "main"

    # Repository URL for GitHub links
    # Auto-detected from [project.urls.Repository] or [project.urls.github]
    # Only set this to override auto-detection
    # repo_url = "https://github.com/user/repo"

    # Map comment tags to GitHub issue labels
    # Used when generating "create issue" links
    # Tags not in this map use the tag name as the label
    # Defaults: CRIT/FIXME/BUG → "bug", TODO/HACK → "enhancement"
    [tool.makefile.inline-todo.tag_label_map]
        "CRIT" = "bug"
        "BUG" = "bug"
        "FIXME" = "bug"
        "TODO" = "enhancement"
        "HACK" = "enhancement"
        "DOC" = "documentation"