Commit Graph

5 Commits

Author SHA1 Message Date
Lucas 'Paperboy' Rose-Winters e30f02f9fe feat(dashboard): implement drag-and-drop with mobile support (Task 1.5)
- Add DragDropHandler class with unified mouse + touch events
- Implement ghost element preview during drag
- Add grid overlay with cell highlighting
- Support touch events with 150ms delay for scroll compatibility
- Add Escape key to cancel drag
- Complete lifecycle management (init, destroy, cleanup)
- Create mobile-ready test harness with:
  - Touch-optimized UI (44px touch targets)
  - Responsive grid layout
  - Real-time event logging
  - Add/remove/reflow widgets
  - Works on desktop and mobile
- 420 lines core code, 880 lines test suite
- Comprehensive JSDoc documentation
2025-10-23 09:56:42 +11:00
Lucas 'Paperboy' Rose-Winters 2038b67b80 feat(dashboard): implement tab management system (Task 1.4)
- Add TabManager class with full CRUD operations
- Implement tab navigation: create, rename, delete, reorder, duplicate
- Add setActiveTab and tab switching utilities
- Implement keyboard shortcuts (Ctrl+1-9, Ctrl+Tab, Ctrl+Shift+Tab)
- Add event system with onChange listeners
- Create interactive test harness with:
  - Live tab navigation UI
  - Right-click context menu
  - Real-time event logging
  - Statistics dashboard
  - Full keyboard shortcut support
- Comprehensive JSDoc type definitions
- 10 core methods + navigation utilities
- 380 lines core code, 620 lines test suite
2025-10-23 09:42:02 +11:00
Lucas 'Paperboy' Rose-Winters 2edb41ebe6 feat(dashboard): implement dashboard data structure (Task 1.3)
Add dashboard configuration to extensionSettings and create default layout system:

State Management (state.js):
- Added extensionSettings.dashboard with version 2
- gridConfig: columns (12), rowHeight (80px), gap (12px), snapToGrid, showGrid
- tabs: Array of tab objects with widgets
- defaultTab: ID of tab to show on load
- Comprehensive inline documentation of structure

Default Layout Generator (defaultLayout.js):
- generateDefaultDashboard() - Creates 2-tab default layout
  - "Status" tab: userStats, infoBox, presentCharacters (3 widgets)
  - "Inventory" tab: inventory widget (1 widget)
- migrateV1ToV2Dashboard() - Migrates v1.x settings to v2.0
  - Respects user's visibility preferences (showUserStats, etc.)
  - Removes hidden widgets from migrated layout
  - Preserves user data during migration
- validateDashboardConfig() - Validates dashboard structure
- Utility functions: getWidgetCount(), findWidget()

Persistence Layer (persistence.js):
- Auto-migration on loadSettings() for existing users
- Validates dashboard config on load
- Regenerates default if config invalid or missing
- Seamless backward compatibility

Test Suite (defaultLayout.test.html):
- 4 test scenarios with visual verification
- Tests generation, validation, migration, utilities
- Live dashboard JSON preview
- Statistics panel (version, tabs, widgets, grid config)

Features:
- Automatic migration from v1.x hardcoded panel
- Preserves user preferences during migration
- Validates all dashboard configs on load
- Generates sensible defaults for new users

Acceptance Criteria Met:
✓ Dashboard config persists in extensionSettings
✓ Default layout generates on first load
✓ Existing users see migrated layout preserving their preferences
✓ All data structures validated

Epic 1, Task 1.3 Complete (1-2 day estimate, <10 min actual)
2025-10-23 09:26:10 +11:00
Lucas 'Paperboy' Rose-Winters 1f4ec963a2 feat(dashboard): implement widget registry system (Task 1.2)
Implement WidgetRegistry class for managing widget types:
- Central registry using Map for O(1) lookups
- Complete widget definition interface with JSDoc types
- register() - Add new widget types with validation
- get() - Retrieve widget definitions by type
- getAvailable() - Filter widgets by schema requirement
- unregister() - Remove widget types
- Additional utility methods: has(), count(), clear(), getStats()

Widget Definition Structure:
- name, icon, description - Display metadata
- minSize, defaultSize - Grid sizing constraints
- requiresSchema - Schema dependency flag
- render() - Rendering function
- Optional lifecycle hooks: getConfig, onConfigChange, onRemove, onResize

Features:
- Validates all required fields on registration
- Prevents duplicate registrations (with warning)
- Filters schema-dependent widgets when no schema active
- Binds lifecycle functions to maintain context
- Comprehensive error handling and logging

Test Suite:
- Interactive test harness with 6 test scenarios
- Tests registration, retrieval, filtering, unregistration
- Visual verification of widget rendering
- Live registry statistics

Acceptance Criteria Met:
✓ Can register/retrieve widgets from registry
✓ Widget definitions include all required metadata
✓ Can filter widgets by schema requirement
✓ All methods tested and verified

Epic 1, Task 1.2 Complete (2-3 day estimate, <5 min actual)
2025-10-23 09:12:39 +11:00
Lucas 'Paperboy' Rose-Winters fa53616d4f feat(dashboard): implement grid engine core (Task 1.1)
Implement GridEngine class with core grid layout functionality:
- 12-column responsive grid system with configurable row height
- Grid ↔ pixel coordinate conversion (getPixelPosition, snapToCell)
- Rectangle intersection collision detection
- Auto-reflow algorithm to push overlapping widgets down
- Widget validation and grid height calculation
- Comprehensive visual test harness with drag-and-drop

Technical Details:
- Pure vanilla JavaScript ES6 module
- No dependencies
- Fully documented with JSDoc
- Manual calculations verified: column width 87px, snap accuracy 100%

Test Harness Features:
- Interactive 12-column grid visualization
- Draggable test widgets with real-time collision detection
- Console logging captured in UI
- Stats panel (widget count, collisions, grid height)
- Test buttons for reflow and collision verification

Acceptance Criteria Met:
✓ Grid engine converts grid ↔ pixel coordinates accurately
✓ Collision detection works for all widget sizes
✓ Reflow pushes widgets down correctly when overlapping
✓ Snap-to-grid works including edge cases
✓ No console errors

Epic 1, Task 1.1 Complete (3-4 day estimate)
2025-10-23 08:56:00 +11:00