feat(plugin): transparentWrappers option for design-system passthrough wrappers

[billouboq]

Summary

This PR adds a transparentWrappers plugin option that lets users register design-system components as transparent passthrough wrappers for ancestor classification.

Motivation

Design systems commonly wrap View/Text in thin passthrough components (HStack, VStack, typography components) that render children straight into the host without introducing a React Native Text wrapper. Today, any View/Text under such a component classifies as having an 'unknown' ancestor and bails out — even though the wrapper is provably safe by construction.

The existing escape hatches (dangerouslyOptimize*WithUnknownAncestors) are all-or-nothing and unsafe by design. transparentWrappers is the targeted alternative: the user vouches for specific (module, export) pairs and declares which host they render to.

At Beedeez (React Native app, ~2 100 source files, design-system based UI), registering 8 wrapper components removed every "unresolved ancestor" bail under our stacks/typography wrappers with no behavioral change, verified on device.

API

[
  'react-native-boost/plugin',
  {
    transparentWrappers: [
      {
        module: '@acme/design-system',
        components: {
          HStack: 'view', // classifies like a View ancestor
          Body: 'text',   // classifies like a Text ancestor (inline context, still bails)
        },
      },
    ],
  },
]

• 'view' → descendants classify the wrapper as 'safe', like a real View
• 'text' → descendants classify it as 'text', like a real Text (so nested elements correctly keep bailing)
• Matching is on the imported name (alias-proof), named imports only
• Unregistered components keep the existing 'unknown' behavior

Tests

• New transparent-ds-ancestor fixtures for both optimizers:
  • registered 'view' wrapper → child optimizes
  • registered 'text' wrapper → child bails ("has Text ancestor")
  • unregistered component → keeps bailing (default fixture run pins the negative)
• Full suite passes (371 tests), tsc --noEmit clean, pnpm build clean

Notes

• Docs for the option come from the PluginOptions JSDoc (AutoOptionSections)
• Out of scope (possible follow-ups): namespace imports, resolving a manifest file shipped by the design system

🤖 Generated with Claude Code

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment

Project	Deployment	Actions	Updated (UTC)
react-native-boost-docs	Skipped		Jul 6, 2026 8:27am

[coderabbitai]

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: a8669e30-0b5f-43d9-b265-d11d5ed34f4e

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}