feat(attribute): Add HasImagesrcset trait and imagesrcset() method to manage imagesrcset attribute for HTML elements.

[terabytesoftw]

Pull Request

Q	A
Is bugfix?	❌
New feature?	✔️
Breaks BC?	❌

Summary by CodeRabbit

• New Features

  • Added support for the imagesrcset HTML attribute on elements, enabling responsive image source configuration for preload links. The attribute accepts multiple value types including strings, Stringable objects, and enums while maintaining immutability.

• Tests

  • Added comprehensive test coverage validating attribute storage, rendering behavior, and immutable instance creation.

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

[coderabbitai]

📝 Walkthrough

Walkthrough

The PR adds support for the HTML imagesrcset attribute through a new HasImagesrcset trait, introduces an IMAGESRCSET enum case to the Attribute enum, and provides comprehensive unit tests with data providers to verify attribute handling and immutability.

Changes

Cohort / File(s)	Summary
Attribute Support src/HasImagesrcset.php, src/Values/Attribute.php	Introduces the HasImagesrcset trait with an imagesrcset() method for managing the imagesrcset attribute on HTML elements, and adds a corresponding IMAGESRCSET enum case to the Attribute enum.
Test Coverage tests/HasImagesrcsetTest.php, tests/Support/Provider/ImagesrcsetProvider.php	Adds comprehensive unit tests verifying trait behavior (no attributes when unset, immutability on assignment, correct attribute storage) and a data provider supplying test cases covering empty strings, null values, attribute replacement, and various input formats.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

Possibly related PRs

• feat(attribute): Use package ui-awesome/html-mixin for mixin traits and update related imports accordingly. #16 — Refactors traits to use the shared addAttribute mixin pattern, directly aligning with the HasImagesrcset implementation that calls addAttribute(Attribute::IMAGESRCSET).
• feat(attribute): Add HasTarget trait and target() method to manage target attribute for HTML elements. #41 — Adds a new immutable trait and enum case to the same Attribute enum, following the identical architectural pattern as this PR.

Poem

🐰 With imagesrcset in hand, we preload with care,
New attributes bloom like carrots in the air,
Traits immutable, tests precise,
HTML attributes thrice as nice! 🌟

🚥 Pre-merge checks | ✅ 2 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 60.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 clearly and specifically describes the main change: adding a HasImagesrcset trait and imagesrcset() method to manage the imagesrcset attribute. This directly matches the actual changes across all modified files (trait definition, method implementation, enum addition, tests, and provider).

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

✨ Finishing touches

• 📝 Generate docstrings

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch feature_20

---

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