[jasmith-hs]

Description

Puts the truncatehtml void element preservation from #1366 behind a new built-in feature, PRESERVE_VOID_IN_TRUNCATE_HTML. The feature is inactive by default, so truncatehtml behaves exactly as it did before #1366 unless a consumer opts in.

• Inactive (default): every element with blank text is removed, including void elements such as <br>, <img> and <hr>, matching pre-Preserve void elements before the truncation point in truncatehtml #1366 output.
• Active: void elements before the truncation point are kept, along with blank parents that contain them (e.g. <p><img></p>). Void elements after the truncation point are still removed.

Enable it with:

FeatureConfig.newBuilder()
  .add(BuiltInFeatures.PRESERVE_VOID_IN_TRUNCATE_HTML, FeatureStrategies.ACTIVE)
  .build()

BRAVE

Backwards Compatibility

• Restores the pre-Preserve void elements before the truncation point in truncatehtml #1366 output by default, so existing templates render as they did before that change.
• The new behaviour is opt-in only.

Rollout and Rollback Plan

• Consumers enable PRESERVE_VOID_IN_TRUNCATE_HTML through FeatureConfig when ready. A DateTimeFeatureActivationStrategy or a custom strategy can be used for gradual rollout.
• Rollback: deactivate the feature, or revert this PR.

Automated Testing

• The existing void element tests from Preserve void elements before the truncation point in truncatehtml #1366 now run with the feature active.
• Added tests asserting void elements are removed when the feature is inactive, both under the length limit and before the truncation point.
• mvn clean verify passes locally (2247 tests, 0 failures).

Verification

• Covered by unit tests; no runtime verification beyond that.

Expect Dependencies to Fail

• None expected. The default output matches the behaviour before Preserve void elements before the truncation point in truncatehtml #1366.

REVIEWERS: Please review both the code changes and the answers above, and validate that they match the expectations for BRAVE

This description was authored by Claude Code.

🤖 Generated with Claude Code