Skip to content
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

chore: add stronger types to several files #28347

Merged
merged 15 commits into from
Oct 23, 2023
Merged

chore: add stronger types to several files #28347

merged 15 commits into from
Oct 23, 2023

Conversation

liamdebeasi
Copy link
Contributor

@liamdebeasi liamdebeasi commented Oct 12, 2023

Issue number: Internal


What is the current behavior?

As part of FW-2832, the team would like to swap out usages of the any type for stronger types.

What is the new behavior?

c529bc2

  • scrollToTop doesn't return anything, so I added the void return type

a96971a

  • animation.effect is a type of AnimationEffect. One of the more common types of effects is a KeyframeEffect. However, TypeScript doesn't know which specific type of AnimationEffect we are using, so I cast animation.effect as KeyframeEffect where appropriate.
  • I also added ! to places where we know the effect and other properties are always defined (since they run after the web animation has been constructed)
  • Added stronger types to the internal to/from/fromTo functions (the public facing type improvements are in fix(animation): add stronger types to Animation interface #28334)

fdaf550

  • getRootNode can return multiple types of objects, so I cast it to the specific types that we work with in isFocused.

46a6efa

  • Added the "Animation" type and resolved related errors once we had stronger types

a7cb9a5

  • Made heavier use of the T generic
  • Once we know node is an Element (nodeType === 1) we manually cast the element as T

6a9d1f0

  • The focus visible utility is an internal utility, but it was lacking an interface, so I added one.

90b64c2

  • Removed unneeded HTMLElement casting
  • Added ! since we can assume the selected elements are defined with the refresher
  • Added documentation as to why casting referencEl.style as any is something we need to keep.

3a084ca

  • Avoided the Event naming collision by using globalThis

Does this introduce a breaking change?

  • Yes
  • No

Other information

Note: This PR contains only type changes. Changes the required updates to the implementation of Ionic are pulled out into separate PRs and target a minor release branch to minimize risk.

@github-actions github-actions bot added the package: core @ionic/core package label Oct 12, 2023
@liamdebeasi liamdebeasi changed the title 2832 types chore: add stronger types to several files Oct 12, 2023
@liamdebeasi liamdebeasi marked this pull request as ready for review October 13, 2023 13:25
Comment on lines -480 to -484
this.animation = await menuController._createAnimation(this.type!, this);
const animation = (this.animation = await menuController._createAnimation(this.type!, this));
if (!config.getBoolean('animated', true)) {
this.animation.duration(0);
animation.duration(0);
}
this.animation.fill('both');
Copy link
Contributor

Choose a reason for hiding this comment

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

Why was this change made? (Specifically moving the this reference into line 480, which makes the code a bit harder to reason about IMO.) menuController._createAnimation returns a Promise<Animation>, so I'd assume there would be no type conflicts with this.animation.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

TypeScript logged an error saying that this.animation was potentially undefined (because that's what the type definition says). Using the local variable ensures that animation is always defined due to the _createAnimation return type you noted.

@liamdebeasi liamdebeasi requested a review from a team October 20, 2023 16:26
Copy link
Contributor

@thetaPC thetaPC left a comment

Choose a reason for hiding this comment

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

LGTM

@thetaPC thetaPC requested a review from a team October 20, 2023 21:22
@liamdebeasi liamdebeasi added this pull request to the merge queue Oct 23, 2023
Merged via the queue into main with commit 15a0225 Oct 23, 2023
@liamdebeasi liamdebeasi deleted the 2832-types branch October 23, 2023 17:04
sean-perkins pushed a commit that referenced this pull request Oct 27, 2023
Issue number: Internal

---------

<!-- Please do not submit updates to dependencies unless it fixes an
issue. -->

<!-- Please try to limit your pull request to one type (bugfix, feature,
etc). Submit multiple pull requests if needed. -->

## What is the current behavior?
<!-- Please describe the current behavior that you are modifying. -->

As part of FW-2832, the team would like to swap out usages of the any
type for stronger types.

## What is the new behavior?
<!-- Please describe the behavior or changes that are being added by
this PR. -->


c529bc2
- `scrollToTop` doesn't return anything, so I added the `void` return
type


a96971a
- `animation.effect` is a type of
[AnimationEffect](https://developer.mozilla.org/en-US/docs/Web/API/Animation/effect).
One of the more common types of effects is a `KeyframeEffect`. However,
TypeScript doesn't know which specific type of AnimationEffect we are
using, so I cast `animation.effect` as KeyframeEffect where appropriate.
- I also added `!` to places where we know the effect and other
properties are always defined (since they run after the web animation
has been constructed)
- Added stronger types to the internal to/from/fromTo functions (the
public facing type improvements are in
#28334)


fdaf550
- `getRootNode` can return multiple types of objects, so I cast it to
the specific types that we work with in `isFocused`.


46a6efa
- Added the "Animation" type and resolved related errors once we had
stronger types


a7cb9a5
- Made heavier use of the `T` generic
- Once we know `node` is an Element (`nodeType === 1`) we manually cast
the element as `T`


6a9d1f0
- The focus visible utility is an internal utility, but it was lacking
an interface, so I added one.


90b64c2
- Removed unneeded HTMLElement casting
- Added `!` since we can assume the selected elements are defined with
the refresher
- Added documentation as to why casting `referencEl.style` as `any` is
something we need to keep.


3a084ca
- Avoided the Event naming collision by using globalThis

## Does this introduce a breaking change?

- [ ] Yes
- [x] No

<!-- If this introduces a breaking change, please describe the impact
and migration path for existing applications below. -->


## Other information

<!-- Any other information that is important to this PR such as
screenshots of how the component looks before and after the change. -->

Note: This PR contains only type changes. Changes the required updates
to the implementation of Ionic are pulled out into separate PRs and
target a minor release branch to minimize risk.

---------

Co-authored-by: Amanda Johnston <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
package: core @ionic/core package
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants