Add a marketplace watchlist and favorites rail for saved listings

[1nonlypiece]

📌 Description

Browsers of src/app/marketplace/page.tsx cannot save listings to revisit later; there's no favorites/watchlist concept on MarketplaceCard.

This issue adds a watchlist: a star/save toggle on cards and a 'Saved' rail that surfaces watched listings.

🎯 Requirements and Context

This is a feature / enhancement task for the CommitLabs frontend (Next.js + TypeScript). It must be implemented cleanly, fully typed, accessible, and well tested — and must not regress existing behavior.

• Add an accessible save/unsave toggle on MarketplaceCard with clear pressed state.
• Persist watched listing ids (user preferences API or local) and render a Saved rail/section.
• Reflect saved state consistently across grid, quick-view, and the rail.
• Handle removed/sold listings in the watchlist gracefully.

🛠️ Suggested Execution

1. Fork the repo and create a branch

git checkout -b feature/marketplace-watchlist

2. Implement the change

• Primary files to add or modify:
  • src/components/MarketplaceCard.tsx — save toggle.
  • src/app/marketplace/page.tsx — Saved rail.
  • src/components/marketplace/WatchlistRail.tsx — new component.
• Add focused tests in src/components/marketplace/Watchlist.test.tsx using Jest / Vitest + React Testing Library (happy-dom), covering rendering, interaction, and the edge cases below.
• Add documentation in docs/MARKETPLACE_WATCHLIST.md describing the feature, props/API, accessibility behavior, and a usage example; cross-link it from the relevant README/docs.
• Keep the diff small and reviewer-friendly; reuse existing primitives, hooks, and the typed API client instead of duplicating logic.

3. Cover edge cases

• save/unsave persists
• sold listing handled in rail
• state consistent across views
• toggle accessible pressed state

4. Test and commit

• Run the suite (e.g. pnpm test / pnpm vitest run) and ensure new lines are covered.
• Verify keyboard navigation, focus handling, and prefers-reduced-motion where relevant.

Example commit message

feat: marketplace watchlist and saved listings rail

✅ Guidelines

• Minimum 95% test coverage on the new/changed lines.
• Clear, reviewer-friendly documentation (props/API + usage example + accessibility notes).
• No regressions to existing components, routes, or tests.
• Fully typed (no any), accessible (labels, roles, live regions where relevant).
• Timeframe: 96 hours.

🏷️ Labels

type-feature · type-enhancement · area-frontend · MAYBE REWARDED · GRANTFOX OSS · OFFICIAL CAMPAIGN

💬 Community & Support

• Join the CommitLabs contributor Discord to coordinate, ask questions, and get unblocked fast: https://discord.gg/WV7tdYkJk
• Please introduce yourself in the channel before you start so we can avoid duplicate work, pair you with a reviewer, and get your PR merged quickly.
• Maintainers actively triage this channel and aim for fast, clear, respectful reviews — reach out any time you're blocked.

[mikewheeleer]

I would like to work on this issue, and I have good knowledge of smart contacts and Sorabani Rust. Kindly assign it to me.

[1nonlypiece]

This issue is now yours to work on. Feel free to swing by our Discord if you need any pointers or want to connect with the team: https://discord.gg/jzgTqSbZX

[grantfox-oss]

🦊 GrantFox — @mikewheeleer has been assigned to this issue as part of the Official Campaign | FWC26 campaign!

Next steps:

1. Open a Pull Request referencing this issue (e.g., Closes #935)
2. Your PR will be reviewed by the Commitlabs-Org maintainers

Good luck! Track your progress on GrantFox.

[grantfox-oss]

🎉 This issue has been marked as completed on GrantFox!

@mikewheeleer's PR #1716 was approved and merged by @1nonlypiece.

🏆 @mikewheeleer: You earned 45 FoxPoints for this contribution! Your current tier: Specialist (4,076 total points). Track your full progress on GrantFox.

👏 Great work, @mikewheeleer! Keep contributing to Commitlabs-Org.