p19-bug-fixes

openspec/changes/p19-vj-defects/specs/indic-font-typography-improvement/spec.md

@@ -0,0 +1,32 @@
+## ADDED Requirements
+
+### Requirement: System uses smooth, readable Indic fonts
+The system SHALL use alternative Indic fonts that provide better readability and visual smoothness compared to the current Noto Sans Tamil and Noto Sans Malayalam fonts.
+
+#### Scenario: Tamil font is smooth and readable
+- **WHEN** Tamil content is displayed
+- **THEN** the font SHALL render with smooth edges without rough or pixelated appearance
+- **AND** the font SHALL maintain readability at various sizes (14px to 32px)
+- **AND** the font SHALL support all Tamil Unicode characters including conjuncts and ligatures
+
+#### Scenario: Malayalam font is smooth and readable
+- **WHEN** Malayalam content is displayed
+- **THEN** the font SHALL render with smooth edges without rough or pixelated appearance
+- **AND** the font SHALL maintain readability at various sizes (14px to 32px)
+- **AND** the font SHALL support all Malayalam Unicode characters including conjuncts and ligatures
+
+#### Scenario: Font loading is optimized
+- **WHEN** Indic fonts are loaded
+- **THEN** the fonts SHALL load asynchronously to prevent layout shift
+- **AND** a system font fallback SHALL display immediately while Indic fonts load
+- **AND** the font-display strategy SHALL be "swap" to ensure text remains visible
+
+#### Scenario: Font weights are available
+- **WHEN** Indic content requires different font weights
+- **THEN** at minimum regular (400) and bold (700) weights SHALL be available
+- **AND** the bold weight SHALL be visually distinguishable from regular
+
+#### Scenario: Font fallback chain is defined
+- **WHEN** Indic fonts fail to load or are not supported
+- **THEN** the system SHALL fall back through: preferred Indic font → Noto Sans [language] → system-ui → sans-serif
+- **AND** fallback fonts SHALL maintain similar character proportions to minimize layout shift