FE-1295: Add avatar to ds

[alex-e-leon]

🌟 What is the purpose of this PR?

Rebuild Avatar component in DS. Note the old Avatar component that this replaces was not previously used anywhere, so this is a safe update.

Pre-Merge Checklist 🚀

🚢 Has this modified a publishable library?

This PR:

• does not modify any publishable blocks or libraries, or modifications do not need publishing

📜 Does this require a change to the docs?

The changes in this PR:

• are internal and do not require a docs change

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
petrinaut	Ready	Preview	Jul 31, 2026 4:55pm

2 Skipped Deployments

Project	Deployment	Actions	Updated (UTC)
hash	Ignored	Preview	Jul 31, 2026 4:55pm
hashdotdesign-tokens	Ignored	Preview	Jul 31, 2026 4:55pm

[cursor]

PR Summary

Medium Risk
Breaking API and export changes in a publishable library (minor bump), though the prior Avatar reportedly had no consumers; adoption will need prop migrations.

Overview
Replaces the Ark UI–based Avatar with a custom implementation and a new minor public API (@hashintel/ds-components changeset).

API: Required alt and structured placeholder (initials | icon | custom); sizes align with form tokens (xxs–lg, custom via --avatar-size); tone (neutral | brand); optional interactivity as button (onClick) or link (href). Removed pixel string sizes, freeform fallback, status indicator, onStatusChange, and exported AvatarProps.

Behavior & UI: Manual load/error handling keeps the placeholder visible until the image loads (including cached images); images use referrerPolicy="no-referrer". Styling moves to avatar.recipe.ts (sva) with hover/focus for interactive avatars. Adds solid user icon for placeholder icons.

Stories: Moved from Legacy to Components/Avatar with matrix stories for placeholders, sizes, and image edge cases. Package entry now exports Avatar only (no AvatarProps type).

^{Reviewed by Cursor Bugbot for commit 1d7891c. Bugbot is set up for automated code reviews on this repo. Configure here.}

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

Want reviews to match your repository better? Bugbot Learning can learn team-specific rules from PR activity. A team admin can enable Learning in the Cursor dashboard.

^{Reviewed by Cursor Bugbot for commit acc9e8c. Configure here.}