mtg-online-drafter/docs/development/CENTRAL.md

Development Status (Central)

Active Plans

• Enhance 3D Game View: Active. Transforming the battlefield into a fully immersive 3D environment.
• Deck Tester Feature: Completed. Implemented a dedicated view to parse custom decks and instantly launch the 3D game sandbox.
• Game Context Menu & Immersion: Completed. Implemented custom right-click menus and game-feel enhancements.

Recent Completions

• Game Battlefield & Manual Mode: Completed.
• Helm Chart Config: Completed.
• CSV Import Robustness: Completed. Enhanced CSV parser to dynamically map columns from headers, supporting custom user imports.
• Fix Socket Mixed Content: Completed. Resolved mixed content error in production by making socket connection URL environment-aware.
• Draft Rules & Pick Logic: Completed. Enforced 4-player minimum and "Pick 2" rule for 4-player drafts.
• Fix Pack Duplication: Completed. Enforced deep cloning and unique IDs for all draft packs to prevent opening identical packs.
• Reconnection & Auto-Pick: Completed. Implemented session persistence, seamless reconnection, and 30s auto-pick on disconnect.
• Draft Interface UI Polish: Completed. Redesigned the draft view for a cleaner, immersive, game-like experience with no unnecessary scrolls.
• Resizable Draft Interface: Completed. Implemented user-resizable pool panel and card sizes with persistence.
• Draft UI Zoom Zone: Completed. Implemented dedicated zoom zone for card preview.
• Host Disconnect Pause: Completed. Specific logic to pause game when host leaves.
• 2025-12-16-215000_anti_tampering.md: Implemented server-side validation for game actions.
• 2025-12-16-220000_session_persistence.md: Plan for session persistence and safer room exit logic.
• 2025-12-16-221000_lobby_improvements.md: Plan for kick functionality and exit button relocation.
• Fix Draft UI Layout: Completed. Fixed "Waiting for next pack" layout to be consistently full-screen.
• Draft Timer Enforcement: Completed. Implemented server-side 60s timer per pick, AFK auto-pick, and global draft timer loop.
• Pack Generation Update: Completed. Implemented new 15-slot Play Booster algorithm with lands, tokens, and wildcards.
• Card Metadata Enhancement: Completed. Extended Scryfall fetching and DraftCard interfaces to include full metadata (CMC, Oracle Text, etc.).
• Rich Metadata Expansion: Completed. Further expanded metadata to include legalities, finishes, artist, frame effects, and produced mana.
• Persist Metadata: Completed. Implemented IndexedDB persistence for Scryfall metadata to ensure offline availability and reduce API calls.
• Bulk Parse Feedback: Completed. Updated CubeManager to handle metadata generation properly and provide feedback on missing cards.
• Full Metadata Passthrough: Completed. DraftCard now includes a definition property containing the complete, raw Scryfall object for future-proofing and advanced algorithm usage.
• Server-Side Caching: Completed. Implemented logic to cache images and metadata on the server upon bulk parsing, and updated client to use local assets.
• Peasant Algorithm Implementation: Completed. Implemented Peasant-specific pack generation rules including slot logic for commons, uncommons, lands, and wildcards.
• Multi-Expansion Selection: Completed. Implemented searchable multi-select interface for "From Expansion" pack generation, allowing mixed-set drafts.
• Game Type Filter: Completed. Added Paper/Digital filter to the expansion selection list.
• Incremental Caching: Completed. Refactored data fetching to cache cards to the server incrementally per set, preventing PayloadTooLarge errors.
• Server Graceful Shutdown Fix: Completed. Implemented signal handling to ensure clean process exit on Ctrl+C.
• Cube Sticky Sidebar: Completed. Made the Cube Manager left sidebar sticky to improve usability with long pack lists.
• Cube Full Width Layout: Completed. Updated Cube Manager to use the full screen width.
• Cube Archidekt View: Completed. Implemented column-based stacked view for packs.
• Cube Mobile UI Fixes: Completed. Fixed overlapping elements and disabled hover previews on mobile.
• Mobile Long-Press Preview: Completed. Implemented long-press trigger for card magnification on small screens.
• Mobile Fullscreen Preview: Completed. Updated mobile preview to be a centered fullscreen overlay.
• Mobile Preview Animations: Completed. Implemented phase-in layout and phase-out animations for mobile preview.
• Mobile Preview Polish: Completed. Refined mobile enter/exit easing and added premium foil finish.
• Enhanced Foil Effects: Completed. implemented a multi-layer holographic sheen for foil cards.
• Rolling Rainbow Foil: Completed. Updated foil effect to feature a scrolling, milder rainbow shimmer.
• Card Visibility Boost: Completed. Added mild white overlay to all card previews for better visibility on dark backgrounds.
• Optimized Rolling Foil: Completed. Implemented continuous full-spectrum rainbow foil effect with mild white sheen.
• Metallic Foil Refinement: Completed. Adjusted foil to emphasize metallic shimmer/glare over rainbow color saturation.
• Circular Foil Animation: Completed. Replaced linear glare with a rotating gaussian circular sheen.
• Mild Foil Animation: Completed. Tuned down foil brightness and overlay intensity to be milder and consistent with non-foils.
• Pro Foil Implementation: Completed. Implemented advanced CSS-based holographic texture and animation.
• Universal Preview Animations: Completed. Enabled entrance/exit animations for card previews on all devices.
• Mobile Touch Interaction: Completed. Updated long-press logic to persist preview during finger movement, closing only on release.
• Entrance Animation Fix: Completed. Implemented 'isMounted' state to ensuring scale-in animation triggers correctly on first render.
• Foil Bug Fix: Completed. Fixed regression where foil animations applied to non-foil cards on desktop.
• Universal Foil Application: Completed. Applied foil animation to Grid View and Stack View card thumbnails.
• Smart Preview Suppression: Completed. Disabled hover preview for card elements that are already rendered large enough on screen.
• Compact Card Layout: Completed. Decreased card sizes in Grid and Stack views for a denser UI.
• View Scale Slider: Completed. Added a slider to dynamically adjust card dimensions, synced across Grid and Stack views.
• Dynamic Art Cropping: Completed. Implemented automatic switching to full-art/art-crop images when card size is reduced below readability threshold.
• Refined Preview Suppression: Completed. Adjusted suppression threshold to 200px to better support Stack View's pop-up behavior.
• Explicit Preview Suppression: Completed. Implemented strict preventPreview prop to enforce suppression logic reliably regardless of card overlap or DOM state.
• Synchronized Display Boundaries: Completed. Aligned "Art Crop" and "Preview Suppression" thresholds to 200px (50% slider value) for a unified UI behavior.
• Squared Art Crops: Completed. Enforced square aspect ratio for art-crop thumbnails to optimize visual density and stacking.
• Fix Expansion Generation Limit: Completed. Implemented "Unlimited Pool" mode for expansion drafts to allow generating large numbers of packs from singleton set data.
• Change Default Filter Flags: Completed. Updated client and server defaults for "Ignore Basic Lands", "Ignore Commander Sets", and "Ignore Tokens" to be unchecked (false).
• Sidebar Max Width: Completed. Constrained the left sidebar in Cube Manager to a maximum width of 400px on large screens to improve layout balance.
• Strict Pack Generation Logic: Succeeded. Enforced strict 14-card (Standard) and 13-card (Peasant) limits, removing fallback logic to prevent invalid pack generation.
• Toast Notification Replacement: Completed. Replaced invasive alerts with a custom Toast notification system for smoother UX.
• Enhanced Toast Visibility: Completed. Updated toasts to be top-center, animated, and highly visible with premium styling.
• Unified Toast Design: Completed. Refined toast aesthetics to match the global dark/slate theme with subtle colored accents.
• Animated Copy Button: Completed. Replaced copy toast with an in-place animated tick button for immediate feedback.