FE-1304: add badge to ds

[alex-e-leon]

🌟 What is the purpose of this PR?

Adds badge component

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)
hash	Ready	Preview	Aug 10, 2026 8:46am
hashdotdesign-tokens	Ready	Preview	Aug 10, 2026 8:46am
petrinaut	Ready	Preview	Aug 10, 2026 8:46am

[cursor]

PR Summary

Medium Risk
This is a breaking API change for any consumer of the old inline Badge (minor bump in changeset); overlay behavior is new but limited to ds-components with no app imports found yet.

Overview
Badge is redesigned from an inline label chip (children, colorScheme, sizes, icons) into a notification-style overlay: wrap any anchor in children, pass counts/labels via content, and control corner position, alignTo="circle" for avatars, hide, and numeric max capping (default 99+).

Layout is split into BaseBadge (relative wrap + container-query corner placement) and a badgeRecipe-styled pill (Chip colors, square/round, dot when content is omitted). BaseBadge is exported from the package; BadgeProps is no longer exported from main.ts.

Avatar now treats shape as optional with default circle, matching typical usage with badge stories.

Ladle stories move from Legacy to Components/Badge and document colors, content variants, and positioning across icons, buttons, avatars, and text.

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