[kkafar]

Requested by Kacper

Description

Follow-up to the #4921 review: a core consumer must be able to provide its own container item, so the item contracts are public API of the core. #4921 makes the tabs' contracts public. This PR does the same for Stack v5, whose item contract #4914 introduced as internal.

Before: StackContainerItem and the types it names were internal, so #4914 also had to make StackScreen, StackHost and their view managers internal.

After: the item contract and the types it names are public, and StackScreen, StackHost and their view managers are public again, as before #4914. Visibility only, no behavioural change.

Follow-up to https://github.com/software-mansion/react-native-screens-labs/issues/1905 (A5).

Stacked on #4976.

Changes

• Public: StackContainerItem and the types its members name: PreventNativeDismissChangeObserver, OnHeaderConfigurationAttachListener, StackHeaderDelegate, StackHeaderConfigurationProviding, StackHeaderConfigurationObserver, StackHeaderInvalidationFlags, StackHeaderType, StackHeaderCollapsedTitleGravityMode and TextAppearance (core.common.text).
• StackHeaderToolbarMenuController (named by StackHeaderConfigurationProviding.toolbarMenuController) is now a public class with an internal constructor. All its members were already internal, so its menu model and update types stay internal.
• StackScreen, StackHost, StackScreenViewManager and StackHostViewManager are public again.

Left internal, for the public API task: StackContainer and StackContainerDelegate (internal since before #4914), StackHeaderConfig and its view manager. A core consumer can implement StackContainerItem, but it can't create a container yet.

Test plan

Run locally:

• yarn lint-android (layer check + spotlessCheck) passes.
• :react-native-screens:compileDebugKotlin succeeds.

On device (Android, FabricExample, release build of this branch, Pixel 3a API 34 emulator):

• Detox: every Android-applicable file in FabricExample/e2e/single-feature-tests/stack-v5/ (14 suites; the -ios files are iOS-only): 213 tests pass. test-stack-lift-on-scroll-android failed once ("should restore lift for the undefined (default) value") and passed on two re-runs; a visibility-only change can't affect it. Crash buffer empty.
• Tabs Detox on the same build (the change sits on top of the A6 PRs): 11 suites, 66 tests pass.

Checklist

• Included code example that can be used to test this change.
• For visual changes, included screenshots / GIFs / recordings documenting the change.
• For API changes, updated relevant public types.
• Ensured that CI passes

---

Generated by Claude Code

[coderabbitai]

Important

Draft PR not reviewed

Draft PRs are not automatically reviewed by default.

• Trigger a manual review

To automatically review draft PRs, update your CodeRabbit configuration:

reviews:
  auto_review:
    drafts: true

• Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

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.}