Add an opt-in hover/signature expansion for **kwargs: Unpack[TypedDict]

[Erlonealpha]

Title

Add an opt-in hover/signature expansion for **kwargs: Unpack[TypedDict]

Summary

Please add an optional setting that expands function signatures using **kwargs: Unpack[TypedDict] in hover and signature help.

For example, instead of showing:

func(**kwargs: Options) -> None

show an expanded form such as:

func(*, a: str, b: int) -> None

when Options is a TypedDict like:

class Options(TypedDict):
    a: str
    b: int

Motivation

Unpack[TypedDict] keeps source code concise, but hover text hides the effective callable interface.

When reading an API, users often want to see the accepted keyword names immediately, without having to jump to the TypedDict definition or manually expand it.

This is especially useful for:

• APIs with many keyword-only options
• library code that models keyword arguments using TypedDict
• call sites where quick hover inspection is faster than navigating to the type definition

Why this request is narrower than discussion #2715

There is already a broader discussion about showing expanded types rather than aliases in hover:

#2715

This request is much narrower:

• it is only about **kwargs: Unpack[TypedDict]
• it only asks for hover/signature presentation
• it does not require general type-alias expansion everywhere

That makes it a more targeted and potentially more manageable feature.

Example

from typing import TypedDict, Unpack


class Options(TypedDict):
    a: str
    b: int


def func(**kwargs: Unpack[Options]) -> None:
    ...

Current hover/signature display:

func(**kwargs: Options) -> None

Requested hover/signature display when the option is enabled:

func(*, a: str, b: int) -> None

Proposed behavior

Please add an opt-in setting for hover and/or signature help that expands **kwargs: Unpack[TypedDict] into explicit keyword parameters.

Possible behavior:

• default behavior remains unchanged
• when the option is enabled, Pylance shows expanded keyword parameters in hover/signature UI
• if fields are optional in the TypedDict, they could be displayed accordingly

Scope

To keep the feature predictable, the initial scope could be limited to:

• direct Unpack[SomeTypedDict]
• function hover
• signature help

It does not need to solve:

• arbitrary type-alias expansion
• expansion in every UI surface
• recursive pretty-printing of all nested complex types

Benefit

This would make APIs using Unpack[TypedDict] much easier to inspect in practice, while keeping the feature small, optional, and focused.

[github-actions[bot]]

Hi @Erlonealpha, I'm an AI Support assistant here to help with your issue. While the team reviews your request, I wanted to provide some possible tips and documentation that might help you in the meantime.

---

Similar Issues (FYI only, not solutions)

The following issues may or may not be related to your request. They are provided for reference only, as they may describe similar concerns about hover/signature formatting, but may not be the same feature request.

• Discussion about showing expanded types instead of aliases in hover: Option to show expanded type instead of type alias on hover #2715
• Feature request for improved tooltip formatting in notebooks: Formatting of tooltips in notebook #4859
• Request for syntax highlighting and formatting of Python tooltips in editor and notebook: Syntax highlighting and formatting of tooltips in Python #4937
• Request for named argument expansion in function snippet completions: Named arguments in function snippet pyright#9203

---

The team will respond to your issue shortly. Please note this is a trial feature and may not be fully accurate. I hope these suggestions are helpful in the meantime. If this comment helped you, please give it a 👍. If the suggestion was not helpful or was incorrect, please give it a 👎. Your feedback helps us improve!

[rchiodo]

Thanks for the suggestion. Transferring to discussion items for up votes.