fix: lazy bundle HMR set correct entryName

[upupming]

This fix follows #2048 but for non standalone lazy bundles. We now will pass the snapshotCreator function from BTS to MTS but miss the correct globDynamicComponentEntry field. It will fail to execute __SetCSSId for lazy bundle.

Summary by CodeRabbit

• New Features

  • Added a lazy-loaded component example with Suspense fallback.

• Bug Fixes

  • Fixed CSS loss during hot module replacement for lazy bundles.

• Style

  • Minor layout and styling adjustments for suspense and lazy component UI.

• Tests

  • Added tests covering non-standalone lazy bundle snapshot behavior.

_{✏️ Tip: You can customize this high-level summary in your review settings.}

Checklist

• Tests updated (or not required).
• Documentation updated (or not required).
• Changeset added, and when a BREAKING CHANGE occurs, it needs to be clearly marked (or not required).

[changeset-bot]

🦋 Changeset detected

Latest commit: 8b25961

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
@lynx-js/react	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[coderabbitai]

📝 Walkthrough

Walkthrough

Adds a DEV_ONLY_SetSnapshotEntryName snapshot operation and apply logic to patch lazy-bundle entry names for HMR, introduces a lazy-loaded example component with CSS, and adds test coverage and a changeset documenting the fix.

Changes

Cohort / File(s)	Summary
Changeset documentation \.changeset/itchy-candies-smoke.md	Adds a changeset entry documenting a patch bump for @lynx-js/react and a fix for lazy bundle HMR losing CSS.
Example lazy-loaded component examples/react-lazy-bundle/src/LazyComponent.tsx, examples/react-lazy-bundle/src/LazyComponent.css	New default-exported LazyComponent and associated CSS (.LazyComponent bold, yellow).
App component modifications examples/react-lazy-bundle/src/App.tsx, examples/react-lazy-bundle/src/App.css	Adds lazy + Suspense usage to load LazyComponent with a fallback and minor spacing CSS for .Suspense.
Snapshot operation definition packages/react/runtime/src/lifecycle/patch/snapshotPatch.ts	Introduces DEV_ONLY_SetSnapshotEntryName operation (enum value 102) and parameter descriptor.
Snapshot patch application packages/react/runtime/src/lifecycle/patch/snapshotPatchApply.ts	Adds handler to apply DEV_ONLY_SetSnapshotEntryName: replaces globDynamicComponentEntry placeholder with the provided entryName and re-evaluates snapshot function (dev-only).
Snapshot creation flow packages/react/runtime/src/snapshot.ts	Emits DEV_ONLY_SetSnapshotEntryName patch when creating lazy-bundle snapshots with a non-default entryName in dev/JS context.
Test coverage packages/react/runtime/__test__/snapshotPatch.test.jsx	Adds test case(s) exercising non-standalone lazy-bundle snapshot patching and reapplication; duplicate test block appears in diff.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

Possibly related PRs

• fix(webpack/external): globDynamicComponentEntry is not defined #2058 — touches the same globDynamicComponentEntry runtime identifier and the HMR entry-name resolution for lazy bundles.
• fix: undefined factory error when loading a standalone lazy bundle after hydration #2048 — related snapshot patching changes for lazy bundles and DEV_ONLY snapshot operations.
• refactor: impl __SNAPSHOT__ at runtime #1736 — earlier runtime snapshot/patching adjustments that overlap with snapshot machinery changes.

Suggested reviewers

• HuJean
• hzy

Poem

🐰 I hopped through patches, swift and bright,
Replaced a name to keep styles right.
Lazy loads bloom in Suspense's light,
HMR hums through day and night. 🎨✨

🚥 Pre-merge checks | ✅ 2 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 25.00% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (2 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title 'fix: lazy bundle HMR set correct entryName' directly and specifically describes the main change—fixing the lazy bundle HMR mechanism to properly set the entryName parameter.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing touches

• 📝 Generate docstrings

---

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 and usage tips.}

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ All tests successful. No failed tests found.

📢 Thoughts on this report? Let us know!

[codspeed-hq]

CodSpeed Performance Report

Merging this PR will degrade performance by 11.06%

_{Comparing feat/DEV_ONLY_SetSnapshotEntryName (8b25961) with main (444f83b)}

Summary

⚡ 1 improved benchmark
❌ 1 regressed benchmark
✅ 61 untouched benchmarks
⏩ 3 skipped benchmarks¹

⚠️ Please fix the performance issues or acknowledge them on CodSpeed.

Performance Changes

	Benchmark	BASE	HEAD	Efficiency
❌	transform 1000 view elements	41.7 ms	46.9 ms	-11.06%
⚡	basic-performance-nest-level-100	7.6 ms	7.1 ms	+6.99%

Footnotes

1. 3 benchmarks were skipped, so the baseline results were used instead. If they were deleted from the codebase, click here and archive them to remove them from the performance reports. ↩

[relativeci]

Web Explorer

#7346 Bundle Size — 384.14KiB (0%).

8b25961(current) vs 0efda9d main#7342(baseline)

Bundle metrics  no changes

	Current #7346	Baseline #7342
Initial JS	154.12KiB	154.12KiB
Initial CSS	35.05KiB	35.05KiB
Cache Invalidation	0%	0%
Chunks	8	8
Assets	8	8
Modules	238	238
Duplicate Modules	16	16
Duplicate Code	2.99%	2.99%
Packages	4	4
Duplicate Packages	0	0

Bundle size by type  no changes

	Current #7346	Baseline #7342
JS	252.07KiB	252.07KiB
Other	97.02KiB	97.02KiB
CSS	35.05KiB	35.05KiB

Bundle analysis report Branch feat/DEV_ONLY_SetSnapshotEntryNa... Project dashboard

---

^{Generated by RelativeCI Documentation Report issue}