Skip to content

fix(types): avoid merging component instance into $props in ComponentInstance #12870

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

Merged
merged 3 commits into from
May 20, 2025

Conversation

jh-leong
Copy link
Member

@jh-leong jh-leong commented Feb 13, 2025

close #12751

Previously, ComponentInstance incorrectly merged the component instance into $props, causing $props to contain an extra $xxx field.

This fix ensures that when defineComponent() is used, ComponentInstance directly resolves to the correct instance type instead of wrapping it in ComponentPublicInstance.

Summary by CodeRabbit

  • Tests

    • Added new test cases to verify event handler typing and property structure for component instances, ensuring correct type inference and error detection.
  • Refactor

    • Improved type definitions for component instances to enhance type inference and consistency, including renaming generic parameters and refining conditional type logic. No impact on runtime behavior.

Copy link

github-actions bot commented Feb 13, 2025

Size Report

Bundles

File Size Gzip Brotli
runtime-dom.global.prod.js 101 kB 38.3 kB 34.5 kB
vue.global.prod.js 159 kB 58.5 kB 52 kB

Usages

Name Size Gzip Brotli
createApp (CAPI only) 46.6 kB 18.2 kB 16.7 kB
createApp 54.5 kB 21.2 kB 19.4 kB
createSSRApp 58.8 kB 23 kB 20.9 kB
defineCustomElement 59.5 kB 22.8 kB 20.8 kB
overall 68.6 kB 26.4 kB 24.1 kB

Copy link

pkg-pr-new bot commented Feb 13, 2025

Open in StackBlitz

@vue/compiler-core

npm i https://pkg.pr.new/@vue/compiler-core@12870

@vue/compiler-dom

npm i https://pkg.pr.new/@vue/compiler-dom@12870

@vue/compiler-sfc

npm i https://pkg.pr.new/@vue/compiler-sfc@12870

@vue/compiler-ssr

npm i https://pkg.pr.new/@vue/compiler-ssr@12870

@vue/runtime-core

npm i https://pkg.pr.new/@vue/runtime-core@12870

@vue/reactivity

npm i https://pkg.pr.new/@vue/reactivity@12870

@vue/runtime-dom

npm i https://pkg.pr.new/@vue/runtime-dom@12870

@vue/server-renderer

npm i https://pkg.pr.new/@vue/server-renderer@12870

@vue/shared

npm i https://pkg.pr.new/@vue/shared@12870

vue

npm i https://pkg.pr.new/vue@12870

@vue/compat

npm i https://pkg.pr.new/@vue/compat@12870

commit: a9e6672

@edison1105 edison1105 added ready to merge The PR is ready to be merged. 🔨 p3-minor-bug Priority 3: this fixes a bug, but is an edge case that only affects very specific usage. labels Feb 13, 2025
Copy link

coderabbitai bot commented May 19, 2025

Walkthrough

This change refines type inference for component instances by updating the ComponentInstance and Component type aliases in the runtime core, ensuring correct handling of types returned by defineComponent(). Additionally, a new type-level test is added to verify that $props does not incorrectly include nested $props properties.

Changes

File(s) Change Summary
packages/runtime-core/src/component.ts Refined ComponentInstance and Component type aliases: renamed generics, added conditional logic to prevent nested $props.
packages-private/dts-test/componentInstance.test-d.tsx Added a new test block to assert correct typing of $props and absence of nested $props in component instances.

Sequence Diagram(s)

sequenceDiagram
    participant Dev as Developer
    participant TypeSystem as TypeScript Type System
    participant Component as Component (from defineComponent)
    
    Dev->>TypeSystem: Instantiate ComponentInstance<typeof Component>
    TypeSystem->>Component: Check if type has $props property
    alt Has $props
        TypeSystem-->>Dev: Return type as-is (no nested $props)
    else No $props
        TypeSystem-->>Dev: Construct ComponentPublicInstance type
    end
Loading

Assessment against linked issues

Objective Addressed Explanation
Prevent $props from containing nested $props properties in ComponentInstance<typeof Comp>['$props'] (#12751)
Ensure correct typing of event handler props and absence of extraneous $-prefixed properties in $props (#12751)

Poem

A hop and a skip through the type system’s maze,
No more nested $props to baffle or faze!
Event handlers are typed, the confusion is gone,
With type guards in place, we merrily hop on.
The code is now tidy, as every bunny prefers—
Hooray for clean typings and well-checked furs! 🐇✨

✨ Finishing Touches
  • 📝 Generate Docstrings

🪧 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.
    • Explain this complex logic.
    • 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 explain this code block.
    • @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 explain its main purpose.
    • @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.

Support

Need help? Create a ticket on our support page for assistance with any issues or questions.

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 generate docstrings to generate docstrings for this PR.
  • @coderabbitai generate sequence diagram to generate a sequence diagram of the changes in this 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

@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

🧹 Nitpick comments (1)
packages/runtime-core/src/component.ts (1)

129-131: Consider using specific object types instead of empty objects

While the use of {} as fallback types when the original types are unknown works functionally, it's generally better to use more specific object types.

Static analysis tools flag empty object types because {} represents "any non-nullable value" rather than an empty object. Consider using more specific types or use Record<string, never> for a truly empty object type if that's what's intended.

🧰 Tools
🪛 Biome (1.9.4)

[error] 129-129: Don't use '{}' as a type.

Prefer explicitly define the object shape. '{}' means "any non-nullable value".

(lint/complexity/noBannedTypes)


[error] 130-130: Don't use '{}' as a type.

Prefer explicitly define the object shape. '{}' means "any non-nullable value".

(lint/complexity/noBannedTypes)


[error] 131-131: Don't use '{}' as a type.

Prefer explicitly define the object shape. '{}' means "any non-nullable value".

(lint/complexity/noBannedTypes)

📜 Review details

Configuration used: CodeRabbit UI
Review profile: CHILL
Plan: Pro
Cache: Disabled due to data retention organization setting
Knowledge Base: Disabled due to data retention organization setting

📥 Commits

Reviewing files that changed from the base of the PR and between 163b365 and 2796013.

📒 Files selected for processing (2)
  • packages-private/dts-test/componentInstance.test-d.tsx (1 hunks)
  • packages/runtime-core/src/component.ts (2 hunks)
🧰 Additional context used
🧬 Code Graph Analysis (1)
packages-private/dts-test/componentInstance.test-d.tsx (1)
packages/runtime-core/src/component.ts (1)
  • ComponentInstance (113-135)
🪛 Biome (1.9.4)
packages/runtime-core/src/component.ts

[error] 129-129: Don't use '{}' as a type.

Prefer explicitly define the object shape. '{}' means "any non-nullable value".

(lint/complexity/noBannedTypes)


[error] 130-130: Don't use '{}' as a type.

Prefer explicitly define the object shape. '{}' means "any non-nullable value".

(lint/complexity/noBannedTypes)


[error] 131-131: Don't use '{}' as a type.

Prefer explicitly define the object shape. '{}' means "any non-nullable value".

(lint/complexity/noBannedTypes)


[error] 270-270: Don't use '{}' as a type.

Prefer explicitly define the object shape. '{}' means "any non-nullable value".

(lint/complexity/noBannedTypes)

🔇 Additional comments (3)
packages/runtime-core/src/component.ts (2)

118-134: Improved type inference for component instances returned by defineComponent()

This change correctly refines the ComponentInstance<T> type alias to handle components returned by defineComponent(). By renaming the parameter from Props to PropsOrInstance and adding a conditional type check, the type system now correctly differentiates between raw props and component instances.

The conditional check PropsOrInstance extends { $props: unknown } is an elegant solution that avoids double-wrapping the component instance in ComponentPublicInstance when it already has a $props property.

🧰 Tools
🪛 Biome (1.9.4)

[error] 129-129: Don't use '{}' as a type.

Prefer explicitly define the object shape. '{}' means "any non-nullable value".

(lint/complexity/noBannedTypes)


[error] 130-130: Don't use '{}' as a type.

Prefer explicitly define the object shape. '{}' means "any non-nullable value".

(lint/complexity/noBannedTypes)


[error] 131-131: Don't use '{}' as a type.

Prefer explicitly define the object shape. '{}' means "any non-nullable value".

(lint/complexity/noBannedTypes)


265-274: Properly propagated type parameter rename to Component interface

The parameter rename from Props to PropsOrInstance is correctly propagated throughout the related type definitions, ensuring consistency across the type system.

🧰 Tools
🪛 Biome (1.9.4)

[error] 270-270: Don't use '{}' as a type.

Prefer explicitly define the object shape. '{}' means "any non-nullable value".

(lint/complexity/noBannedTypes)

packages-private/dts-test/componentInstance.test-d.tsx (1)

141-154: Great test coverage for type correction in $props

This test case correctly verifies the fix for issue #12751 by ensuring:

  1. Component emits are properly typed in the component instance
  2. Event handlers are correctly typed in the $props object
  3. No nested $props property exists within the $props object itself

The test case is well-structured and properly uses the TypeScript @ts-expect-error annotation to verify that the fix prevents the nesting of $props within itself.

@edison1105
Copy link
Member

/ecosystem-ci run

@vuejs vuejs deleted a comment from jh-leong May 20, 2025
@vue-bot
Copy link
Contributor

vue-bot commented May 20, 2025

📝 Ran ecosystem CI: Open

suite result latest scheduled
nuxt success success
language-tools success success
pinia success success
primevue success success
quasar success success
vant success success
router success success
radix-vue success success
test-utils success success
vue-i18n success success
vitepress success success
vuetify success success
vue-simple-compiler success success
vueuse success success
vite-plugin-vue success success
vue-macros success success

@edison1105 edison1105 merged commit f44feed into vuejs:main May 20, 2025
14 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
🔨 p3-minor-bug Priority 3: this fixes a bug, but is an edge case that only affects very specific usage. ready to merge The PR is ready to be merged. scope: types
Projects
None yet
Development

Successfully merging this pull request may close these issues.

ComponentInstance<typeof Comp>['$props'] has invalid properties when used with strictFunctionTypes and defineModel
4 participants