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

feat(react, react-query-4): add missing JSDoc for react and react-query-4 #1365

Merged
merged 4 commits into from
Nov 20, 2024

Conversation

kangju2000
Copy link
Collaborator

Overview

I add JSDoc comments to @suspensive/react and @suspensive/react-query-4.

PR Checklist

  • I did below actions if need
  1. I read the Contributing Guide
  2. I added documents and tests.

@kangju2000 kangju2000 requested a review from manudeli as a code owner November 19, 2024 18:32
Copy link

coauthors bot commented Nov 19, 2024

People can be co-author:

Candidate Reasons Count Add this as commit message
@kangju2000 #1365 (comment) #1365 (comment) #1365 (comment) #1365 (review) #1365 (review) #1365 (review) #1365 7 Co-authored-by: kangju2000 <23312485+kangju2000@users.noreply.github.com>
@manudeli #1365 (comment) #1365 (comment) #1365 (review) #1365 (review) #1365 (review) 5 Co-authored-by: manudeli <61593290+manudeli@users.noreply.github.com>
@codecov-commenter #1365 (comment) 1 Co-authored-by: codecov-commenter <65553080+codecov-commenter@users.noreply.github.com>

Copy link

changeset-bot bot commented Nov 19, 2024

🦋 Changeset detected

Latest commit: dc2fb49

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 5 packages
Name Type
@suspensive/react-query-4 Patch
@suspensive/react Patch
@suspensive/react-query-5 Patch
@suspensive/react-query Patch
@suspensive/jotai Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

Copy link

vercel bot commented Nov 19, 2024

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name Status Preview Comments Updated (UTC)
suspensive.org ✅ Ready (Inspect) Visit Preview 💬 Add feedback Nov 20, 2024 2:32am
v1.suspensive.org ✅ Ready (Inspect) Visit Preview 💬 Add feedback Nov 20, 2024 2:32am
visualization.suspensive.org ✅ Ready (Inspect) Visit Preview 💬 Add feedback Nov 20, 2024 2:32am

Copy link

github-actions bot commented Nov 19, 2024

Size Change: -4 B (-0.01%)

Total Size: 64.2 kB

Filename Size Change
packages/react-query-4/dist/index.js 393 B -1 B (-0.25%)
packages/react/dist/ErrorBoundaryGroup.js 195 B -1 B (-0.51%)
packages/react/dist/Suspense.js 171 B -1 B (-0.58%)
packages/react/dist/wrap.js 210 B -1 B (-0.47%)
ℹ️ View Unchanged
Filename Size
packages/jotai/dist/Atom.cjs 660 B
packages/jotai/dist/Atom.js 115 B
packages/jotai/dist/AtomValue.cjs 647 B
packages/jotai/dist/AtomValue.js 120 B
packages/jotai/dist/index.cjs 755 B
packages/jotai/dist/index.js 158 B
packages/jotai/dist/SetAtom.cjs 645 B
packages/jotai/dist/SetAtom.js 118 B
packages/react-dom/dist/index.cjs 2.11 kB
packages/react-dom/dist/index.js 139 B
packages/react-dom/dist/InView.cjs 2.1 kB
packages/react-dom/dist/InView.js 130 B
packages/react-dom/dist/useInView.cjs 1.87 kB
packages/react-dom/dist/useInView.js 120 B
packages/react-native/dist/index.cjs 619 B
packages/react-native/dist/index.js 122 B
packages/react-native/dist/TestText.cjs 612 B
packages/react-native/dist/TestText.js 119 B
packages/react-query-4/dist/index.cjs 1.86 kB
packages/react-query-4/dist/infiniteQueryOptions.cjs 548 B
packages/react-query-4/dist/infiniteQueryOptions.js 144 B
packages/react-query-4/dist/Mutation.cjs 821 B
packages/react-query-4/dist/Mutation.js 132 B
packages/react-query-4/dist/PrefetchInfiniteQuery.cjs 722 B
packages/react-query-4/dist/PrefetchInfiniteQuery.js 155 B
packages/react-query-4/dist/PrefetchQuery.cjs 712 B
packages/react-query-4/dist/PrefetchQuery.js 147 B
packages/react-query-4/dist/QueryClientConsumer.cjs 665 B
packages/react-query-4/dist/QueryClientConsumer.js 139 B
packages/react-query-4/dist/QueryErrorBoundary.cjs 1.12 kB
packages/react-query-4/dist/QueryErrorBoundary.js 142 B
packages/react-query-4/dist/queryOptions.cjs 540 B
packages/react-query-4/dist/queryOptions.js 136 B
packages/react-query-4/dist/SuspenseInfiniteQuery.cjs 1.05 kB
packages/react-query-4/dist/SuspenseInfiniteQuery.js 155 B
packages/react-query-4/dist/SuspenseQueries.cjs 923 B
packages/react-query-4/dist/SuspenseQueries.js 149 B
packages/react-query-4/dist/SuspenseQuery.cjs 1.04 kB
packages/react-query-4/dist/SuspenseQuery.js 146 B
packages/react-query-4/dist/usePrefetchInfiniteQuery.cjs 648 B
packages/react-query-4/dist/usePrefetchInfiniteQuery.js 148 B
packages/react-query-4/dist/usePrefetchQuery.cjs 639 B
packages/react-query-4/dist/usePrefetchQuery.js 140 B
packages/react-query-4/dist/useSuspenseInfiniteQuery.cjs 833 B
packages/react-query-4/dist/useSuspenseInfiniteQuery.js 148 B
packages/react-query-4/dist/useSuspenseQueries.cjs 833 B
packages/react-query-4/dist/useSuspenseQueries.js 142 B
packages/react-query-4/dist/useSuspenseQuery.cjs 824 B
packages/react-query-4/dist/useSuspenseQuery.js 139 B
packages/react-query-5/dist/index.cjs 1.76 kB
packages/react-query-5/dist/index.js 389 B
packages/react-query-5/dist/infiniteQueryOptions.cjs 573 B
packages/react-query-5/dist/infiniteQueryOptions.js 144 B
packages/react-query-5/dist/Mutation.cjs 821 B
packages/react-query-5/dist/Mutation.js 132 B
packages/react-query-5/dist/PrefetchInfiniteQuery.cjs 647 B
packages/react-query-5/dist/PrefetchInfiniteQuery.js 145 B
packages/react-query-5/dist/PrefetchQuery.cjs 639 B
packages/react-query-5/dist/PrefetchQuery.js 137 B
packages/react-query-5/dist/QueryClientConsumer.cjs 663 B
packages/react-query-5/dist/QueryClientConsumer.js 140 B
packages/react-query-5/dist/QueryErrorBoundary.cjs 1.12 kB
packages/react-query-5/dist/QueryErrorBoundary.js 142 B
packages/react-query-5/dist/queryOptions.cjs 563 B
packages/react-query-5/dist/queryOptions.js 136 B
packages/react-query-5/dist/SuspenseInfiniteQuery.cjs 833 B
packages/react-query-5/dist/SuspenseInfiniteQuery.js 145 B
packages/react-query-5/dist/SuspenseQueries.cjs 671 B
packages/react-query-5/dist/SuspenseQueries.js 139 B
packages/react-query-5/dist/SuspenseQuery.cjs 825 B
packages/react-query-5/dist/SuspenseQuery.js 137 B
packages/react-query-5/dist/usePrefetchInfiniteQuery.cjs 577 B
packages/react-query-5/dist/usePrefetchInfiniteQuery.js 148 B
packages/react-query-5/dist/usePrefetchQuery.cjs 569 B
packages/react-query-5/dist/usePrefetchQuery.js 140 B
packages/react-query-5/dist/useSuspenseInfiniteQuery.cjs 577 B
packages/react-query-5/dist/useSuspenseInfiniteQuery.js 148 B
packages/react-query-5/dist/useSuspenseQueries.cjs 571 B
packages/react-query-5/dist/useSuspenseQueries.js 142 B
packages/react-query-5/dist/useSuspenseQuery.cjs 569 B
packages/react-query-5/dist/useSuspenseQuery.js 140 B
packages/react-query/dist/index.cjs 551 B
packages/react-query/dist/index.js 121 B
packages/react-query/dist/v4.cjs 550 B
packages/react-query/dist/v4.js 116 B
packages/react-query/dist/v5.cjs 550 B
packages/react-query/dist/v5.js 116 B
packages/react/dist/ClientOnly.cjs 734 B
packages/react/dist/ClientOnly.js 141 B
packages/react/dist/DefaultProps.cjs 1.05 kB
packages/react/dist/DefaultProps.js 167 B
packages/react/dist/Delay.cjs 1.23 kB
packages/react/dist/Delay.js 159 B
packages/react/dist/DevMode.cjs 530 B
packages/react/dist/DevMode.js 131 B
packages/react/dist/ErrorBoundary.cjs 2.74 kB
packages/react/dist/ErrorBoundary.js 205 B
packages/react/dist/ErrorBoundaryGroup.cjs 1.38 kB
packages/react/dist/index.cjs 4.32 kB
packages/react/dist/index.js 368 B
packages/react/dist/Suspense.cjs 1.29 kB
packages/react/dist/Suspensive.cjs 1.26 kB
packages/react/dist/Suspensive.js 175 B
packages/react/dist/wrap.cjs 3.78 kB

compressed-size-action

@codecov-commenter
Copy link

codecov-commenter commented Nov 19, 2024

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 71.86%. Comparing base (9db2983) to head (dc2fb49).

Additional details and impacted files

Impacted file tree graph

@@           Coverage Diff           @@
##             main    #1365   +/-   ##
=======================================
  Coverage   71.86%   71.86%           
=======================================
  Files          67       67           
  Lines         583      583           
  Branches      129      129           
=======================================
  Hits          419      419           
  Misses        151      151           
  Partials       13       13           
Components Coverage Δ
@suspensive/react 100.00% <100.00%> (ø)
@suspensive/react-dom 100.00% <ø> (ø)
@suspensive/react-native 100.00% <ø> (ø)
@suspensive/react-query 72.86% <ø> (ø)
@suspensive/react-query-4 0.00% <ø> (ø)
@suspensive/react-query-5 0.00% <ø> (ø)
@suspensive/jotai 0.00% <ø> (ø)
@suspensive/codemods 41.97% <ø> (ø)
---- 🚨 Try these New Features:

Copy link

codspeed-hq bot commented Nov 19, 2024

CodSpeed Performance Report

Merging #1365 will create unknown performance changes

Comparing feat/add-jsDoc (dc2fb49) with main (9db2983)

Summary

⚠️ No benchmarks were detected in both the base of the PR and the PR.

@@ -6,4 +6,8 @@ export interface ClientOnlyProps {
fallback?: ReactNode
}

/**
* This component ensures its children are only rendered on the client-side.
* @see {@link https://suspensive.org/docs/react/ClientOnly Suspensive Docs}
Copy link
Collaborator Author

Choose a reason for hiding this comment

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

Which one do you prefer between https://suspensive.org/docs and https://suspensive.org/en/docs

Copy link
Member

@manudeli manudeli Nov 20, 2024

Choose a reason for hiding this comment

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

https://suspensive.org/docs is proper in my opinion. because https://suspensive.org/docs will automatically redirect user's page to proper language page if user use any language

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

It would be good to standardize it to links without 'en' since they're not unified!

Copy link
Member

Choose a reason for hiding this comment

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

Oh,, I merge this Pull Request. could you do that in next pull request please?

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

Yes, I'll raise a PR to standardize the jsDoc overall!

Copy link
Member

@manudeli manudeli left a comment

Choose a reason for hiding this comment

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

❤️

@manudeli manudeli merged commit 89c1cd9 into main Nov 20, 2024
17 of 18 checks passed
@manudeli manudeli deleted the feat/add-jsDoc branch November 20, 2024 02:32
manudeli pushed a commit that referenced this pull request Nov 21, 2024
…1368)

# Overview

<!--
    A clear and concise description of what this pr is about.
 -->
#1365 (comment)

## PR Checklist

- [x] I did below actions if need

1. I read the [Contributing
Guide](https://github.com/toss/suspensive/blob/main/CONTRIBUTING.md)
2. I added documents and tests.
manudeli added a commit that referenced this pull request Nov 21, 2024
This PR was opened by the [Changesets
release](https://github.com/changesets/action) GitHub action. When
you're ready to do a release, you can merge this and the packages will
be published to npm automatically. If you're not ready to do a release
yet, that's fine, whenever you add more changesets to main, this PR will
be updated.


# Releases
## @suspensive/jotai@2.18.6

### Patch Changes

- [#1364](#1364)
[`9db2983`](9db2983)
Thanks [@kangju2000](https://github.com/kangju2000)! - fix(\*): fix typo
in jsdoc

- [#1364](#1364)
[`9db2983`](9db2983)
Thanks [@kangju2000](https://github.com/kangju2000)! - fix(react-query,
jotai, react): fix typo in jsdoc

## @suspensive/react@2.18.6

### Patch Changes

- [#1368](#1368)
[`30b39d9`](30b39d9)
Thanks [@kangju2000](https://github.com/kangju2000)! - docs(react-query,
react): Update jsdoc link from `en/docs` to `docs`

- [#1365](#1365)
[`89c1cd9`](89c1cd9)
Thanks [@kangju2000](https://github.com/kangju2000)! - feat(react,
react-query-4): add missing JSDoc for react and react-query-4

- [#1364](#1364)
[`9db2983`](9db2983)
Thanks [@kangju2000](https://github.com/kangju2000)! - fix(\*): fix typo
in jsdoc

- [#1364](#1364)
[`9db2983`](9db2983)
Thanks [@kangju2000](https://github.com/kangju2000)! - fix(react-query,
jotai, react): fix typo in jsdoc

## @suspensive/react-query@2.18.6

### Patch Changes

- Updated dependencies
\[[`30b39d9`](30b39d9),
[`89c1cd9`](89c1cd9),
[`9db2983`](9db2983),
[`9db2983`](9db2983)]:
    -   @suspensive/react-query-4@2.18.6
    -   @suspensive/react-query-5@2.18.6
    -   @suspensive/react@2.18.6

## @suspensive/react-query-4@2.18.6

### Patch Changes

- [#1368](#1368)
[`30b39d9`](30b39d9)
Thanks [@kangju2000](https://github.com/kangju2000)! - docs(react-query,
react): Update jsdoc link from `en/docs` to `docs`

- [#1365](#1365)
[`89c1cd9`](89c1cd9)
Thanks [@kangju2000](https://github.com/kangju2000)! - feat(react,
react-query-4): add missing JSDoc for react and react-query-4

- [#1364](#1364)
[`9db2983`](9db2983)
Thanks [@kangju2000](https://github.com/kangju2000)! - fix(\*): fix typo
in jsdoc

- [#1364](#1364)
[`9db2983`](9db2983)
Thanks [@kangju2000](https://github.com/kangju2000)! - fix(react-query,
jotai, react): fix typo in jsdoc

- Updated dependencies
\[[`30b39d9`](30b39d9),
[`89c1cd9`](89c1cd9),
[`9db2983`](9db2983),
[`9db2983`](9db2983)]:
    -   @suspensive/react@2.18.6

## @suspensive/react-query-5@2.18.6

### Patch Changes

- [#1368](#1368)
[`30b39d9`](30b39d9)
Thanks [@kangju2000](https://github.com/kangju2000)! - docs(react-query,
react): Update jsdoc link from `en/docs` to `docs`

- [#1364](#1364)
[`9db2983`](9db2983)
Thanks [@kangju2000](https://github.com/kangju2000)! - fix(\*): fix typo
in jsdoc

- [#1364](#1364)
[`9db2983`](9db2983)
Thanks [@kangju2000](https://github.com/kangju2000)! - fix(react-query,
jotai, react): fix typo in jsdoc

- Updated dependencies
\[[`30b39d9`](30b39d9),
[`89c1cd9`](89c1cd9),
[`9db2983`](9db2983),
[`9db2983`](9db2983)]:
    -   @suspensive/react@2.18.6
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants