Skip to content

fix(onClickOutside): the order of overload signatures #4839

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 4 commits into
base: main
Choose a base branch
from

Conversation

whiteyebrw
Copy link
Contributor

Before submitting the PR, please make sure you do the following

  • Read the Contributing Guidelines.
  • Read the Pull Request Guidelines.
  • Check that there isn't already a PR that solves the problem the same way to avoid creating a duplicate.
  • Provide a description in this PR that addresses what the PR is solving, or reference the issue that it solves (e.g. fixes #123).
  • Ideally, include relevant tests that fail without this PR but pass with it.
⚠️ Slowing down new functions

Warning: Slowing down new functions

As the VueUse audience continues to grow, we have been inundated with an overwhelming number of feature requests and pull requests. As a result, maintaining the project has become increasingly challenging and has stretched our capacity to its limits. As such, in the near future, we may need to slow down our acceptance of new features and prioritize the stability and quality of existing functions. Please note that new features for VueUse may not be accepted at this time. If you have any new ideas, we suggest that you first incorporate them into your own codebase, iterate on them to suit your needs, and assess their generalizability. If you strongly believe that your ideas are beneficial to the community, you may submit a pull request along with your use cases, and we would be happy to review and discuss them. Thank you for your understanding.


Description

Fixes #4838.
The order of Overload Signatures has been changed.

Additional context

@dosubot dosubot bot added the size:S This PR changes 10-29 lines, ignoring generated files. label Jun 26, 2025
Comment on lines 62 to 67
export function onClickOutside(
target: MaybeElementRef,
handler: OnClickOutsideHandler<{ detectIframe: OnClickOutsideOptions['detectIframe'], controls: true }>,
options: OnClickOutsideOptions<true>,
): { stop: Fn, cancel: Fn, trigger: (event: Event) => void }

Copy link
Contributor

@cszhjh cszhjh Jun 26, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Would you be able to assist with solving this kind of type inference issue as well? I’d really appreciate it!

onClickOutside(document.documentElement, (e) => {
  // Currently, the type of e is `Event | PointerEvent`
  // The correct type should be `Event | PointerEvent | FocusEvent`.
}, {
  controls: true,
  detectIframe: true
})

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ok. i'll see what i can do.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I had to add stricter overloads for the handler.

@dosubot dosubot bot added size:M This PR changes 30-99 lines, ignoring generated files. and removed size:S This PR changes 10-29 lines, ignoring generated files. labels Jun 27, 2025
Copy link
Member

@ilyaliao ilyaliao left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should we change it like this?

-export interface OnClickOutsideOptions<Controls extends boolean = false> extends ConfigurableWindow {
+export interface OnClickOutsideOptions<Controls extends boolean = false, DetectIframe extends boolean = false> extends ConfigurableWindow {
   // ...
-  detectIframe?: boolean
+  detectIframe?: DetectIframe
   // ...
}

@43081j
Copy link
Collaborator

43081j commented Jun 28, 2025

i think you could simplify this to two overloads 👀

you only need to know what controls is in the overloads so you can get the right return type

so we could instead do something like this:

export function onClickOutside<
  T extends OnClickOutsideOptions<true>
>(
  target: MaybeElementRef,
  handler: OnClickOutsideHandler<T>,
  options: T
): Controls;
export function onClickOutside<
  T extends OnClickOutsideOptions<false>
>(
  target: MaybeElementRef,
  handler: OnClickOutsideHandler<T>,
  options: T
): Fn;

and

export type OnClickOutsideHandler<
  TControls extends boolean, // may not be needed? may be able to just do `<boolean>` below
  T extends OnClickOutsideOptions<TControls>
> = (
  event: (T['detectIframe'] extends true ? FocusEvent : never)
    | (T['controls'] extends true ? Event : never)
    | PointerEvent,
) => void

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
size:M This PR changes 30-99 lines, ignoring generated files.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

BUG | onClickOutside | breaking change + wrong type declaration regarding the use of controls
4 participants