1

openspec/changes/archive/2026-02-17-fix-stats-chart-bugs/specs/chart-label-overlay/spec.md

@@ -0,0 +1,21 @@
+## ADDED Requirements
+
+### Requirement: Pie chart direct category labeling
+The pie chart SHALL display category names directly on or adjacent to their corresponding sectors.
+
+#### Scenario: Category labels rendered on pie sectors
+- **WHEN** the expense category pie chart is displayed
+- **THEN** each sector SHALL display its category name as a label
+- **AND** the label SHALL be positioned to not obscure the sector
+
+#### Scenario: Labels adapt to sector size
+- **GIVEN** a category represents less than 5% of total expenses
+- **WHEN** the pie chart renders
+- **THEN** the label for that small sector MAY be hidden to avoid clutter
+- **AND** the category SHALL still be identifiable via tooltip on hover
+
+#### Scenario: Label visibility in dark mode
+- **GIVEN** the application is in dark mode
+- **WHEN** the pie chart displays labels on sectors
+- **THEN** the label text color SHALL provide sufficient contrast against the sector color
+- **AND** labels SHALL remain readable against both light and dark sector colors