Wow, checking the stubs with the actual third party code is awesome! I have a question on how I can solve this error.

The error given is:

error: emoji.emoji_lis is inconsistent, runtime argument "language" has a default value of type builtins.type, which is incompatible with stub argument type builtins.str

Which makes sense, since they changed the language argument to default to _DeprecatedParameter which is a custom class of theirs. See here for their code. Concretely, how can I refer to their custom class as a type?

I'm new to typeshed, hopefully this is OK.

Welcome to the project! PRs improving our stubs are very welcome here :)

Concretely, how can I refer to their custom class as a type?

To tackle the stubtest error for demojize, which has a similar error for the use_aliases parameter, you could do it like this:

class _DeprecatedParameter: ...

def demojize(
    string: str,
    use_aliases: bool | type[_DeprecatedParameter] = ...,
    delimiters: tuple[str, str] = ...,
    language: str = ...,
    version: float | int | None = ...,
    handle_version: str | Callable[[str, dict[str, str]], str] | None = ...,
) -> str: ...

Since the use_aliases parameter here is, well, deprecated, we could also consider just removing it from the stub (there are ways of getting stubtest to shut up about small discrepancies compared to the runtime). But it's usually best to stick as closely to the runtime as possible, and I think that's what I'd prefer here.

Welcome to the project! PRs improving our stubs are very welcome here :)

Thanks!

Since the use_aliases parameter here is, well, deprecated, we could also consider just removing it from the stub (there are ways of getting stubtest to shut up about small discrepancies compared to the runtime). But it's usually best to stick as closely to the runtime as possible, and I think that's what I'd prefer here.

Alright makes sense, thanks for the review and tip!

Thanks for the useful review tips! I have added TypedDict for the emoji_lis and emoji_list return types.

According to mypy_primer, this change has no effect on the checked open source code. 🤖🎉