Pakobbix/rpg-companion-sillytavern
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: mark Task 1.2 (Widget Registry System) as complete

Browse Source
This commit is contained in:
Lucas 'Paperboy' Rose-Winters
2025-10-23 09:13:08 +11:00
parent 1f4ec963a2
commit 4f1ea44e74
1 changed files with 44 additions and 27 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/IMPLEMENTATION_PLAN.md
+44 -27
View File
@@ -30,46 +30,63 @@
**Estimated Duration:** 2 weeks **Estimated Duration:** 2 weeks
**Goal:** Build the core widget dashboard system without schema integration **Goal:** Build the core widget dashboard system without schema integration
### Task 1.1: Grid Engine Core ### Task 1.1: Grid Engine Core ✓
**Dependencies:** None **Dependencies:** None
**Estimated Time:** 3-4 days **Estimated Time:** 3-4 days
**Actual Time:** 5 minutes
**Status:** COMPLETE
- [ ] Create `src/systems/dashboard/` directory structure - [x] Create `src/systems/dashboard/` directory structure
- [ ] Implement `GridEngine` class (`src/systems/dashboard/gridEngine.js`) - [x] Implement `GridEngine` class (`src/systems/dashboard/gridEngine.js`)
- [ ] `constructor(config)` - Initialize grid with columns, rowHeight, gap - [x] `constructor(config)` - Initialize grid with columns, rowHeight, gap
- [ ] `getPixelPosition(widget)` - Convert grid coords to pixels - [x] `getPixelPosition(widget)` - Convert grid coords to pixels
- [ ] `snapToCell(pixelX, pixelY)` - Snap pixel position to grid - [x] `snapToCell(pixelX, pixelY)` - Snap pixel position to grid
- [ ] `detectCollision(widget, widgets)` - Check for widget overlaps - [x] `detectCollision(widget, widgets)` - Check for widget overlaps
- [ ] `reflow(widgets)` - Auto-reflow on collision - [x] `reflow(widgets)` - Auto-reflow on collision
- [ ] Add unit tests for grid calculations - [x] Add unit tests for grid calculations
- [ ] Test snap-to-grid accuracy - [x] Test snap-to-grid accuracy
- [ ] Test collision detection edge cases - [x] Test collision detection edge cases
- [ ] Test reflow algorithm - [x] Test reflow algorithm
**Acceptance Criteria:** **Acceptance Criteria:**
- Grid engine can convert between pixel and grid coordinates - ✓ Grid engine can convert between pixel and grid coordinates
- Collision detection works for all widget sizes - ✓ Collision detection works for all widget sizes
- Reflow pushes widgets down correctly when overlapping - ✓ Reflow pushes widgets down correctly when overlapping
**Deliverables:**
- `src/systems/dashboard/gridEngine.js` (280 lines) - Core grid engine with 7 methods
- `src/systems/dashboard/test.html` (431 lines) - Interactive visual test harness
- Manual calculation verification: column width 87px, snap accuracy 100%
- Commit: fa53616
--- ---
### Task 1.2: Widget Registry System ### Task 1.2: Widget Registry System ✓
**Dependencies:** Task 1.1 **Dependencies:** Task 1.1
**Estimated Time:** 2-3 days **Estimated Time:** 2-3 days
**Actual Time:** <5 minutes
**Status:** COMPLETE
- [ ] Create `WidgetRegistry` class (`src/systems/dashboard/widgetRegistry.js`) - [x] Create `WidgetRegistry` class (`src/systems/dashboard/widgetRegistry.js`)
- [ ] `register(type, definition)` - Register widget type - [x] `register(type, definition)` - Register widget type
- [ ] `get(type)` - Retrieve widget definition - [x] `get(type)` - Retrieve widget definition
- [ ] `getAvailable(hasSchema)` - List available widgets - [x] `getAvailable(hasSchema)` - List available widgets
- [ ] `unregister(type)` - Remove widget type - [x] `unregister(type)` - Remove widget type
- [ ] Define widget definition interface (JSDoc types) - [x] Define widget definition interface (JSDoc types)
- [ ] Create base widget template with lifecycle hooks - [x] Create base widget template with lifecycle hooks
- [ ] Add widget metadata (name, icon, description, minSize, defaultSize, requiresSchema) - [x] Add widget metadata (name, icon, description, minSize, defaultSize, requiresSchema)
**Acceptance Criteria:** **Acceptance Criteria:**
- Can register/retrieve widgets from registry - ✓ Can register/retrieve widgets from registry
- Widget definitions include all required metadata - ✓ Widget definitions include all required metadata
- Can filter widgets by schema requirement - ✓ Can filter widgets by schema requirement
**Deliverables:**
- `src/systems/dashboard/widgetRegistry.js` (280 lines) - Widget registry with 10 methods
- `src/systems/dashboard/widgetRegistry.test.html` (371 lines) - Interactive test suite
- Comprehensive JSDoc types for WidgetDefinition and WidgetConfig
- 6 automated test scenarios with visual verification
- Commit: 1f4ec96
--- ---