[Bug]: arun() and arun_many() type hinting needs fixing

[luzede]

crawl4ai version

0.8.6

Expected Behavior

Something like this

And the docstring comments also say that it returns CrawlResult

Current Behavior

Is this reproducible?

Yes

Inputs Causing the Bug

RunManyReturn = Union[
    CrawlResultContainer[CrawlResultT],
    AsyncGenerator[CrawlResultT, None]
]

`arun()` is not an async generator, maybe you guys give it generator properties through CrawlResultContainer but the typing needs fixing.

Steps to Reproduce

I am using Pylance, I tried Pyrefly from meta too.

Code snippets

import asyncio
from crawl4ai import *

async def main():
    async with AsyncWebCrawler() as crawler:
        result = await crawler.arun(
            url="https://www.nbcnews.com/business",
        )
        print(result.markdown)

if __name__ == "__main__":
    asyncio.run(main())

OS

Windows

Python version

3.13.11

Browser

No response

Browser version

No response

Error logs & Screenshots (if applicable)

No response

[hafezparast]

Fixed in PR #1901. arun() was annotated as RunManyReturn (includes AsyncGenerator) but always returns CrawlResultContainer. Changed to CrawlResultContainer — Pylance/Pyright should stop flagging result.markdown as an error.

Also added test_type_annotations.py — static analysis tests that catch this class of bug without needing pyright in CI. A full pyright scan found 46 return type mismatches across the codebase; this PR fixes the user-facing one and guards against future regressions.

pip install git+https://github.com/hafezparast/crawl4ai.git@fix/maysam-arun-type-hint-1898

[luzede]

There is similar issue for arun_many() too.

[nightcityblade]

Hi, I'd like to work on this. I'll submit a PR shortly.