chore(react-avatar): archive the deprecated headless avatar package

[junghyeonsu]

@seed-design/react-avatar를 packages/archive로 옮기고 배포를 중단합니다. v3.0 대상이라 draft로 둡니다.

왜 지금이 아니라 v3.0인가

@seed-design/react가 /primitive 엔트리에서 이 패키지를 통째로 re-export하고 있습니다.

// packages/react/src/primitive.ts
export * from "@seed-design/react-avatar";

이걸 지우면 useAvatar·AvatarRoot·AvatarImage·AvatarFallback·useAvatarContext가 공개 API에서 사라집니다. 2.0 이후 breaking은 메이저에서만 하기로 되어 있어 v3.0에 답니다.

변경 내용

• packages/react-headless/avatar → packages/archive/avatar. packages/archive/*는 루트 workspaces glob에 없어서, 옮기는 것만으로 빌드·테스트·배포 대상에서 빠집니다.
• packages/react의 dependencies와 primitive.ts re-export 제거
• changeset: @seed-design/react major

영향 범위

스타일이 적용된 Avatar는 영향 없습니다. 이미 @seed-design/react-image 위에 올라가 있고 useAvatar를 쓴 적이 없습니다.

// packages/react/src/components/Avatar/Avatar.tsx
import { Image } from "@seed-design/react-image";

@seed-design/react/primitive에서 avatar 헤드리스를 직접 가져다 쓰던 경우에만 마이그레이션이 필요하고, 대응표는 changeset에 있습니다.

검증

• bun install — @seed-design/react에서 1개 패키지 제거됨
• bun --filter @seed-design/react build — 통과
• bun test packages/react — 920개 통과
• 레포 전체에 react-avatar 참조 없음 (아카이브된 패키지 자신 제외)

머지 전 확인할 것

• 레지스트리의 @seed-design/react-avatar를 deprecate 처리할지 (이 PR 범위 밖, 수동 작업)
• packages/archive/avatar/README.md의 상대 경로 (../image)는 fix(image-frame): stop hiding the image while it loads #1791 머지 후 리베이스하면 따라옵니다

관련: #1791 (같은 로딩 동작 수정을 useImage에만 반영하고 이 패키지는 손대지 않기로 한 PR)

🤖 Generated with Claude Code

[coderabbitai]

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: d0998d25-5166-4911-99fb-e08b219ba512

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

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

[changeset-bot]

🦋 Changeset detected

Latest commit: f91a361

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
@seed-design/react	Major

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[github-actions]

Alpha Preview (Stackflow SPA)

• Branch Preview URL: https://chore-archive-react-avatar.seed-design-stackflow-spa.pages.dev
• Preview URL: https://fa20ff90.seed-design-stackflow-spa.pages.dev
• Commit: f91a361

[github-actions]

Alpha Preview (Storybook)

• Branch Preview URL: https://chore-archive-react-avatar.seed-design-storybook.pages.dev
• Preview URL: https://936a13bc.seed-design-storybook.pages.dev
• Commit: f91a361

[github-actions]

Alpha Preview (Docs)

• Branch Preview URL: https://chore-archive-react-avatar.seed-design.pages.dev
• Preview URL: https://f1fcaba6.seed-design.pages.dev
• Commit: f91a361