[internal] Add JSDoc documentation for fastComponent and fastComponentRef

[Copilot]

The fastComponent and fastComponentRef wrapper functions lacked documentation explaining their performance optimization benefits, particularly the batched subscription optimization.

Changes

fastComponent documentation:

• Explains the performance optimization via shared instance context
• Documents how multiple useStore calls are batched into a single subscription
• Integrates execution flow details into the performance optimization description
• Includes requirements and best practices
• Provides practical example showing useStore batching

fastComponentRef documentation:

• Documents it as a convenience wrapper combining fastComponent with React.forwardRef
• Cross-references fastComponent for performance details
• Includes example with ref forwarding

Example

// Wrapping a component to enable optimized useStore batching
export const TooltipRoot = fastComponent(function TooltipRoot(props) {
  // These useStore calls share a single subscription
  const open = useStore(store, (state) => state.open);
  const disabled = useStore(store, (state) => state.disabled);
  const value = useStore(store, (state) => state.value);
  // ...
});

The documentation is positioned at the wrapper functions where developers will encounter it when wrapping their components, making it more discoverable and contextually appropriate. The documentation is concise and focused on explaining what the functions do and their technical implementation.

Original prompt

---

This section details on the original issue you should resolve

<issue_title>[docs] Add jsdoc for fast useStore</issue_title>
<issue_description>> Should we add documentation for the next person to explain when to use this and its limits?

Beyond contributor value, there also seems to be user value: in the eye of someone who is used to canonical React code, this is advanced, so it looks like an opportunity to teach them something, so to gain more trust from them in us.

Originally posted by @oliviertassinari in #3445 (comment)
</issue_description>

Comments on the Issue (you are @copilot in this section)

• Fixes [internal] Add jsdoc for fast useStore #3780

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

[netlify]

✅ Deploy Preview for base-ui ready!

Name	Link
🔨 Latest commit	f6ee5ec
🔍 Latest deploy log	https://app.netlify.com/projects/base-ui/deploys/696c0086be015700089680e6
😎 Deploy Preview	https://deploy-preview-3781--base-ui.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

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

[mui-bot]

Bundle size report

Bundle	Parsed size	Gzip size
@base-ui/react	0B(0.00%)	0B(0.00%)

Details of bundle changes

---

Check out the code infra dashboard for more information about this PR.

[romgrk]

@copilot Revert those changes and add documentation to fastComponent and fastComponentRef instead.

[Copilot]

@copilot Revert those changes and add documentation to fastComponent and fastComponentRef instead.

Done! Reverted the changes to useStore.ts and added comprehensive JSDoc documentation to fastComponent and fastComponentRef in fastHooks.ts instead. The documentation now explains the performance optimization, how it works, when to use it, and includes practical examples. (969013f)

[romgrk]

@copilot Remove the React 19 reference.

[Copilot]

Done! Removed all "React 19+" references from the documentation. (3c7b279)

[romgrk]

@copilot Make the How it works section much more compact and integrate it to the section before.