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

Strict TS typing for useResizeObserver #3859

Merged
merged 3 commits into from
Nov 20, 2024
Merged

Conversation

joel-jeremy
Copy link
Contributor

No description provided.

@actual-github-bot actual-github-bot bot changed the title Strict type useResizeObserver [WIP] Strict type useResizeObserver Nov 20, 2024
Copy link

netlify bot commented Nov 20, 2024

Deploy Preview for actualbudget ready!

Name Link
🔨 Latest commit 04fb3fc
🔍 Latest deploy log https://app.netlify.com/sites/actualbudget/deploys/673e222e65c4a50008a320b2
😎 Deploy Preview https://deploy-preview-3859.demo.actualbudget.org
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site configuration.

@joel-jeremy joel-jeremy changed the title [WIP] Strict type useResizeObserver Strict TS typing for useResizeObserver Nov 20, 2024
Copy link
Contributor

github-actions bot commented Nov 20, 2024

Bundle Stats — desktop-client

Hey there, this message comes from a GitHub action that helps you and reviewers to understand how these changes affect the size of this project's bundle.

As this PR is updated, I'll keep you updated on how the bundle size is impacted.

Total

Files count Total bundle size % Changed
10 5.42 MB → 5.42 MB (-233 B) -0.00%
Changeset
File Δ Size
src/hooks/useResizeObserver.ts 📈 +4 B (+0.93%) 429 B → 433 B
node_modules/define-data-property/index.js 📉 -9 B (-0.39%) 2.25 kB → 2.24 kB
node_modules/call-bind/index.js 📉 -9 B (-0.84%) 1.05 kB → 1.04 kB
node_modules/has-property-descriptors/index.js 📉 -9 B (-1.55%) 582 B → 573 B
node_modules/es-define-property/index.js 📉 -210 B (-37.50%) 560 B → 350 B
View detailed bundle breakdown

Added

No assets were added

Removed

No assets were removed

Bigger

No assets were bigger

Smaller

Asset File Size % Changed
static/js/index.js 3.44 MB → 3.44 MB (-233 B) -0.01%

Unchanged

Asset File Size % Changed
static/js/indexeddb-main-thread-worker-e59fee74.js 13.5 kB 0%
static/js/AppliedFilters.js 21.32 kB 0%
static/js/useAccountPreviewTransactions.js 1.63 kB 0%
static/js/resize-observer.js 18.37 kB 0%
static/js/workbox-window.prod.es5.js 5.69 kB 0%
static/js/narrow.js 82.72 kB 0%
static/js/BackgroundImage.js 122.29 kB 0%
static/js/wide.js 241.19 kB 0%
static/js/ReportRouter.js 1.49 MB 0%

Copy link
Contributor

github-actions bot commented Nov 20, 2024

Bundle Stats — loot-core

Hey there, this message comes from a GitHub action that helps you and reviewers to understand how these changes affect the size of this project's bundle.

As this PR is updated, I'll keep you updated on how the bundle size is impacted.

Total

Files count Total bundle size % Changed
1 1.32 MB 0%

Changeset

No files were changed

View detailed bundle breakdown

Added

No assets were added

Removed

No assets were removed

Bigger

No assets were bigger

Smaller

No assets were smaller

Unchanged

Asset File Size % Changed
kcab.worker.js 1.32 MB 0%

Copy link
Contributor

coderabbitai bot commented Nov 20, 2024

Walkthrough

The pull request introduces modifications to the useResizeObserver function located in packages/desktop-client/src/hooks/useResizeObserver.ts. A generic type parameter <T extends Element> has been added, allowing the function to observe a wider range of element types. The return type has been updated from (el: unknown) => void to (el: T) => void, ensuring that the callback receives an element of the specified type. Additionally, the observer reference is now explicitly typed as ResizeObserver | undefined, which enhances type safety. The internal logic has been refined to utilize optional chaining (?.) for the disconnect() and observe() methods, thereby preventing potential runtime errors when observer.current is undefined. These changes collectively improve the type safety and robustness of the useResizeObserver function while maintaining its overall structure. The BudgetSummaries and Sidebar components have also been updated to use the new type parameter, ensuring that they specifically observe HTMLDivElement elements.

Possibly related PRs

Suggested labels

:sparkles: Merged

Suggested reviewers

  • matt-fidd
  • youngcw

Warning

There were issues while running some tools. Please review the errors and either fix the tool’s configuration or disable the tool if it’s a critical failure.

🔧 eslint

If the error stems from missing dependencies, add them to the package.json file. For unrecoverable errors (e.g., due to private dependencies), disable the tool in the CodeRabbit configuration.

packages/desktop-client/src/components/budget/BudgetSummaries.tsx

Oops! Something went wrong! :(

ESLint: 8.57.1

ESLint couldn't find the plugin "eslint-plugin-eslint-plugin".

(The package "eslint-plugin-eslint-plugin" was not found when loaded as a Node module from the directory "/packages/eslint-plugin-actual".)

It's likely that the plugin isn't installed correctly. Try reinstalling by running the following:

npm install eslint-plugin-eslint-plugin@latest --save-dev

The plugin "eslint-plugin-eslint-plugin" was referenced from the config file in "packages/eslint-plugin-actual/.eslintrc.js".

If you still can't figure out the problem, please stop by https://eslint.org/chat/help to chat with the team.


Thank you for using CodeRabbit. We offer it for free to the OSS community and would appreciate your support in helping us grow. If you find it useful, would you consider giving us a shout-out on your favorite social media?

❤️ Share
🪧 Tips

Chat

There are 3 ways to chat with CodeRabbit:

  • Review comments: Directly reply to a review comment made by CodeRabbit. Example:
    • I pushed a fix in commit <commit_id>, please review it.
    • Generate unit testing code for this file.
    • Open a follow-up GitHub issue for this discussion.
  • Files and specific lines of code (under the "Files changed" tab): Tag @coderabbitai in a new review comment at the desired location with your query. Examples:
    • @coderabbitai generate unit testing code for this file.
    • @coderabbitai modularize this function.
  • PR comments: Tag @coderabbitai in a new PR comment to ask questions about the PR branch. For the best results, please provide a very specific query, as very limited context is provided in this mode. Examples:
    • @coderabbitai gather interesting stats about this repository and render them as a table. Additionally, render a pie chart showing the language distribution in the codebase.
    • @coderabbitai read src/utils.ts and generate unit testing code.
    • @coderabbitai read the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.
    • @coderabbitai help me debug CodeRabbit configuration file.

Note: Be mindful of the bot's finite context window. It's strongly recommended to break down tasks such as reading entire modules into smaller chunks. For a focused discussion, use review comments to chat about specific files and their changes, instead of using the PR comments.

CodeRabbit Commands (Invoked using PR comments)

  • @coderabbitai pause to pause the reviews on a PR.
  • @coderabbitai resume to resume the paused reviews.
  • @coderabbitai review to trigger an incremental review. This is useful when automatic reviews are disabled for the repository.
  • @coderabbitai full review to do a full review from scratch and review all the files again.
  • @coderabbitai summary to regenerate the summary of the PR.
  • @coderabbitai resolve resolve all the CodeRabbit review comments.
  • @coderabbitai configuration to show the current CodeRabbit configuration for the repository.
  • @coderabbitai help to get help.

Other keywords and placeholders

  • Add @coderabbitai ignore anywhere in the PR description to prevent this PR from being reviewed.
  • Add @coderabbitai summary to generate the high-level summary at a specific location in the PR description.
  • Add @coderabbitai anywhere in the PR title to generate the title automatically.

CodeRabbit Configuration File (.coderabbit.yaml)

  • You can programmatically configure CodeRabbit by adding a .coderabbit.yaml file to the root of your repository.
  • Please see the configuration documentation for more information.
  • If your editor has YAML language server enabled, you can add the path at the top of this file to enable auto-completion and validation: # yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json

Documentation and Community

  • Visit our Documentation for detailed information on how to use CodeRabbit.
  • Join our Discord Community to get help, request features, and share feedback.
  • Follow us on X/Twitter for updates and announcements.

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 0

🧹 Outside diff range and nitpick comments (1)
packages/desktop-client/src/hooks/useResizeObserver.ts (1)

6-6: Consider adding cleanup logic using useEffect.

While the typing is correct, consider adding a cleanup effect to properly dispose of the ResizeObserver when the component unmounts.

Here's a suggested implementation:

 import { useRef, useCallback } from 'react';
+import { useRef, useCallback, useEffect } from 'react';

 export function useResizeObserver<T extends Element>(
   func: (contentRect: DOMRectReadOnly) => void,
 ): (el: T) => void {
   const observer = useRef<ResizeObserver | undefined>(undefined);
+  
+  useEffect(() => {
+    return () => {
+      observer.current?.disconnect();
+    };
+  }, []);

   if (!observer.current) {
     observer.current = new ResizeObserver(entries => {
📜 Review details

Configuration used: CodeRabbit UI
Review profile: CHILL

📥 Commits

Reviewing files that changed from the base of the PR and between 0696c81 and d17df4f.

⛔ Files ignored due to path filters (1)
  • upcoming-release-notes/3859.md is excluded by !**/*.md
📒 Files selected for processing (1)
  • packages/desktop-client/src/hooks/useResizeObserver.ts (1 hunks)
🔇 Additional comments (3)
packages/desktop-client/src/hooks/useResizeObserver.ts (3)

3-5: LGTM! Excellent type safety improvement.

The addition of the generic type parameter <T extends Element> and the corresponding return type (el: T) => void provides better type safety and enables proper type inference when using this hook with specific element types.


13-17: LGTM! Well-implemented callback with proper type safety.

The callback implementation is robust with:

  • Proper type safety using the generic parameter T
  • Defensive programming using optional chaining
  • Correct ResizeObserver options

3-5: Verify existing usage compatibility.

The stricter typing might affect existing usage of this hook. Let's verify all current implementations remain compatible.

✅ Verification successful

All existing usages are compatible with the stricter typing

The verification shows that all current usages of useResizeObserver in the codebase are compatible with the stricter typing:

  • MonthPicker.tsx: Uses it with a callback that receives rect: DOMRectReadOnly
  • BudgetSummaries.tsx: Uses it with a callback that receives rect: DOMRectReadOnly
  • Sidebar.tsx: Uses it with a callback that receives rect: DOMRectReadOnly

All implementations follow the same pattern and already comply with the stricter type definition.

🏁 Scripts executed

The following scripts were executed for the analysis:

Script:

#!/bin/bash
# Search for all useResizeObserver usage
rg "useResizeObserver" --type ts --type tsx -B 2 -A 2

Length of output: 81


Script:

#!/bin/bash
# Search for all useResizeObserver usage with ripgrep, without file type restrictions
rg "useResizeObserver" -B 2 -A 2

Length of output: 3540

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 0

🧹 Outside diff range and nitpick comments (1)
packages/desktop-client/src/components/budget/BudgetSummaries.tsx (1)

Line range hint 34-38: LGTM! Consider adding explicit return type for the callback.

The addition of HTMLDivElement generic type parameter improves type safety by ensuring the resize observer is correctly typed for the div element it observes.

Consider adding an explicit return type to the callback for better type documentation:

  const containerRef = useResizeObserver<HTMLDivElement>(
-   useCallback(rect => {
+   useCallback((rect: DOMRectReadOnly): void => {
      setWidthState(rect.width);
    }, []),
  );
📜 Review details

Configuration used: CodeRabbit UI
Review profile: CHILL

📥 Commits

Reviewing files that changed from the base of the PR and between d17df4f and 04fb3fc.

📒 Files selected for processing (2)
  • packages/desktop-client/src/components/budget/BudgetSummaries.tsx (1 hunks)
  • packages/desktop-client/src/components/sidebar/Sidebar.tsx (1 hunks)
🔇 Additional comments (1)
packages/desktop-client/src/components/sidebar/Sidebar.tsx (1)

64-66: LGTM! Type parameter matches the element usage.

The addition of HTMLDivElement type parameter correctly specifies the type of element being observed, which aligns with its usage for width measurements.

Let's verify that the View component renders as HTMLDivElement:

✅ Verification successful

Type parameter HTMLDivElement is correctly used

The verification confirms that the View component is implemented as a div element and uses forwardRef<HTMLDivElement, ViewProps>, making the HTMLDivElement type parameter in useResizeObserver perfectly aligned with its usage.

🏁 Scripts executed

The following scripts were executed for the analysis:

Script:

#!/bin/bash
# Description: Verify View component implementation
# Expected: View component should render as a div element

# Search for View component implementation
ast-grep --pattern 'const View = $_'

Length of output: 1502

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.

2 participants