feat(attribute): Add HasName trait and name() method to manage name attribute for HTML elements.

[terabytesoftw]

Pull Request

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

Summary by CodeRabbit

• New Features
  • Added support for managing the name attribute on HTML elements with built-in validation against standard HTML metadata names including author, description, keywords, viewport, robots, theme-color, application-name, and more.

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

[terabytesoftw]

@coderabbitai review

[coderabbitai]

✅ Actions performed

Review triggered.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

[coderabbitai]

📝 Walkthrough

Walkthrough

A new public trait HasName is introduced with a name() method to manage the HTML name attribute. Supporting changes include a new MetaName enum containing 12 standard meta name tokens, a new Attribute::NAME enum case, and comprehensive unit tests with a data provider validating the trait's behavior.

Changes

Cohort / File(s)	Summary
Documentation CHANGELOG.md	Documented enhancement for new HasName trait (Enh #52).
Core Implementation src/HasName.php, src/Values/Attribute.php, src/Values/MetaName.php	Added HasName trait with name() method for managing name attribute; added Attribute::NAME enum case; added MetaName enum with 12 standard meta name tokens (application-name, author, description, viewport, etc.).
Tests tests/HasNameTest.php, tests/Support/Provider/NameProvider.php	Added comprehensive unit tests validating immutability, empty rendering, attribute setting, and validation error handling; added data provider with static test cases and MetaName/Attribute enum cases.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

Possibly related PRs

• feat(attribute): Add HasAs trait and as() method to manage as attribute for HTML elements. #42: Adds a new attribute trait with corresponding Attribute enum case (AS), following the same implementation pattern as HasName with NAME.
• feat(attribute): Add HasIntegrity trait and integrity() method to manage integrity attribute for HTML elements. #37: Introduces another Has<Attribute> trait (Integrity) and expands the Attribute enum, demonstrating the same architectural approach.
• feat(attribute): Use package ui-awesome/html-mixin for mixin traits and update related imports accordingly. #16: Establishes the foundational addAttribute-based HasAttributes mixin that the new HasName trait directly leverages for attribute management.

Poem

🐰 A name trait hops into the fray,
With MetaName tokens on display,
Each case immutable, no dismay,
HTML metadata finds a way—
Validation guards the names we say! ✨

🚥 Pre-merge checks | ✅ 2 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 50.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 pull request title clearly and specifically describes the main change: adding a HasName trait and name() method for managing the name attribute on HTML elements. It is directly aligned with all file changes in the changeset.

_{✏️ 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_25

---

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

[terabytesoftw]

@coderabbitai review

[coderabbitai]

✅ Actions performed

Review triggered.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.