react-doctor/no-layout-transition-inline

Review inline transitions of layout properties and preserve the distinction between visual movement and real document reflow

Validation prompt

Confirm the detector match and collect the required evidence before deciding whether an edit is warranted.

The detector reports a statically resolved inline style.transition or style.transitionProperty that explicitly names width, height, a min/max size variant, padding, or margin (including side suffixes). It deliberately skips values containing all and cannot inspect stylesheet rules or dynamic strings. Confirm the property is actually interpolated with a positive duration, then inspect the rendered contract: whether siblings must reflow, intrinsic content must reveal, the hit area or clipping changes, and whether a production trace shows material layout cost. A grid-track transition is an intrinsic-size technique that can still perform layout; it is not a compositor fix.

Evidence boundary

The diagnostic proves only that the detector’s modeled source pattern matched. It does not prove runtime impact, product intent, rendered failure, or that one remediation is correct.

Establish the environment, repository policy, exceptions, and required rendered or runtime evidence before deciding the occurrence.

The design tag controls activation and discovery. It does not determine the rule’s proof class.

Record one outcome:

• Confirmed failure: The required evidence establishes the violation.
• Rejected: A documented exception or false-positive predicate applies.
• Needs evidence: Named evidence can still be collected.
• Unavailable: Required evidence cannot be collected in this run.
• Waived with evidence: An authorized, scoped exception applies to an established failure.
• Observation: The review records an optional tradeoff without claiming a defect.

A waiver records its scope, authority, evidence, and review condition. It is not a pass or false positive.

Default severity is registry metadata. Use the occurrence’s JSON severity after repository configuration when ordering real findings.

Fix prompt

Apply this candidate correction only after the required evidence confirms the risk.

Choose the smallest behavior-preserving fix. For a purely visual offset or reveal, establish final geometry and use transform, opacity, or a suitable clip while preserving transform origin, clipping, hit testing, and other transform owners; these properties are broadly compositor-eligible, not guaranteed free. When siblings or intrinsic content must reflow, keep the layout state change and either make it immediate, use a scoped intrinsic-size technique such as a grid-track transition, or use measured layout projection where the installed library supports it. Do not replace width, height, margin, or padding with scale or translate when that changes text geometry, document flow, focus geometry, or interaction. Re-profile when performance is the reason for editing. See https://web.dev/articles/animations-guide

Repository-wide copy prompt

Use this repository-wide prompt only after validating each occurrence. For one occurrence, use the guidance above.