[WIP] Wishlist 2.x refactoring plan

[Wojdylak]

Summary

This PR contains the refactoring plan for migrating the Wishlist Plugin to 2.x. It is a working document — not meant to be merged, will be closed when the work is complete.

We are breaking down PR #20 into smaller, focused PRs while improving on its approach based on lessons learned from 3 production projects (dafre, elesto, solenne).

Progress

• PR 0 — Refactor remove commands to accept wishlist object instead of token (refactor-remove-product-command) Refactor remove commands to accept wishlist object instead of token  #64
• PR 1 — Replace add-to-wishlist button with WishlistButtonComponent LiveComponent (add-live-component) Replace add-to-wishlist with WishlistButtonComponent LiveComponent  #65
• PR 2 — CachedWishlistsResolver (in-memory cache decorator)
• PR 3 — Wishlist CRUD LiveComponents (create/edit/remove with modals)
• PR 4 — Wishlist Details item actions (remove item, clear wishlist)
• PR 5 — Bulk/Collective actions (add to cart, remove selected, copy)
• PR 6 — Import/Export improvements
• PR 7 — Routing cleanup (/wishlist/ → /wishlists/)
• PR 8 — Header widget with item count badge
• PR 9 — UX improvements (back navigation, translations)

Key architectural decisions

• Wishlist token is not unique — all anonymous wishlists share the same cookie token. We use ID + resolver for ownership.
• Resolver is the ownership gate — only returns current user's wishlists. No direct repository access for wishlist lookup in components.
• Authorization in controllers, not handlers — handlers are pure business logic.
• Commands use setWishlist() pattern — both add and remove, consistent interface.
• One component for cards and product page — WishlistButtonComponent with optional variant awareness.
• Dispatch existing commands via MessageBus — no direct persistence in components.

How to continue

See WISHLIST_REFACTOR_PLAN.md for the full plan with details on each PR, what was done, what's left, and architecture notes.