## link (`poetry_link`)

A styled navigational hyperlink.

Class: Poetry::Ui::Link::Component - BEM block `poetry-ui-link`.
Content block REQUIRED (the visible link text) - a blockless call raises.
- `underline:` (symbol) - one of hover|always|none, default "hover" - When the underline appears; :none suits links styled by their container.
- `current:` (boolean) - default false - Marks this link as the current page via aria-current=page.
- `external:` (boolean) - default false - Opens in a new tab with rel="noopener noreferrer" - never hand-write target=_blank.
- `href:` (string) - required - The destination URL.
- PART `link` - The rendered <a> - the whole component; current: marks it aria-current=page
In blocks: `section-card`, `top-nav` - for a screen, start from the block (MCP compose/describe_block, or `bin/rails g poetry:block`), not from scratch.
- RULE: Use poetry_link for navigation - poetry_button for actions (never an <a> styled by hand).
- RULE: Mark the active nav item with current: true (aria-current), never with a bespoke class.
- RULE: external: true handles target/rel safely - never hand-write target=_blank.