Rules Hub
Code Ruleset
← Back to all rules
Rule priority, scope & exceptions
Use this to align rules with the senior-level structure (P0/P1/P2, scope, exceptions/tradeoffs).
frontend ruleP2stack specificStack: react
reactjsxchildren
Match direct children returns to the component contract
Use a fragment when grouping or an element-only contract requires it; returning children directly is valid with compatible types.
PR: hegnar-bellsheep-web · org-mining-2026-06Created: Jun 17, 2026
Bad example
Old codetsx
| 1 | if (!params) return children; |
Explanation (EN)
A broad children type may not satisfy an intentionally element-only return contract.
Objašnjenje (HR)
Good example
New codetsx
| 1 | if (!params) return <>{children}</>; |
Explanation (EN)
Objašnjenje (HR)
Notes (EN)
Wrap children only when an actual API/type contract requires an element or grouping, and verify the installed React/TypeScript support.
Exceptions / Tradeoffs (EN)
Modern components can return ReactNode directly. An unnecessary fragment can affect identity in nested shape transitions; do not add one solely because children are not JSX.Element.