Merge pull request #50, JS,-TS, & ARIA support

more JS to TS stuff

ARIA support for every component

Author: Stan2032

ARCHITECTURE.md

@@ -8,42 +8,46 @@ The Global Anti-CCP Resistance Hub is a **static React single-page application (
 
 ```
 src/data/*.json ─────┐
-src/pages/*.jsx ─────┤   npm run build     dist/
-src/components/*.jsx ─┼─  ────────────── →  ├── index.html
+src/pages/*.tsx ─────┤   npm run build     dist/
+src/components/*.tsx ─┼─  ────────────── →  ├── index.html
 src/locales/*.json ──┤   (Vite + Rollup)   ├── assets/
-src/index.css ───────┘                     │   ├── index-*.js      (305KB / 97KB gzip)
+src/index.css ───────┘                     │   ├── index-*.js      (310KB / 99KB gzip)
                                            │   ├── index-*.css     (86KB / 15KB gzip)
                                            │   ├── vendor-react-*  (11KB)
                                            │   ├── vendor-router-* (35KB)
-                                           │   ├── vendor-motion-* (116KB)
                                            │   └── [81 lazy chunks]
                                            └── (static assets)
 ```
 
 ### Key Build Features
-- **Manual chunks**: React, React Router, and Framer Motion split into cacheable vendor bundles
+- **100% TypeScript**: Entire codebase is TypeScript — 0 JavaScript/JSX files remain (360+ .ts/.tsx files)
+- **Manual chunks**: React and React Router split into cacheable vendor bundles
 - **Lazy loading**: 81 sub-components loaded on demand (all page bundles under 50KB)
 - **Base path**: Configurable via `VITE_BASE_PATH` env var — defaults to `/` for Cloudflare, set to `/global-anti-ccp-resistance-hub/` for GitHub Pages
 
 ---
 
 ## Routing
 
-React Router v7 handles all client-side navigation. Routes are defined in `src/App.jsx`.
+React Router v7 handles all client-side navigation. Routes are defined in `src/App.tsx`.
 
 ```
 /                        → Dashboard
-/intelligence-feeds      → IntelligenceFeeds (3 tabs: Live Feeds, Regional, CCP Ops)
-/political-prisoners     → PoliticalPrisoners
-/security-center         → SecurityCenter (5 tabs, includes ChinaExitBan)
-/educational-resources   → EducationalResources (7 tabs, includes ConfuciusInstitutes)
+/intelligence            → IntelligenceFeeds (3 tabs: Live Feeds, Regional, CCP Ops)
+/prisoners               → PoliticalPrisoners
+/security                → SecurityCenter (tabs: Overview, Tools, Guides, Quiz, Report)
+/education               → EducationCenter (tabs: Resources, Media, Guides, Tactics)
 /take-action             → TakeAction
-/community-support       → CommunitySupport
-/resistance-resources    → ResistanceResources
-/resistance-directory    → ResistanceDirectory
+/community               → CommunitySupport
+/resources               → ResistanceResources
+/directory               → ResistanceDirectory
 /data-sources            → DataSources
 /profiles                → ProfilesIndex (links to all 15 profiles)
 /profiles/:slug          → Individual profile pages (15 total)
+/campaigns               → Redirect → /take-action
+/communications          → Redirect → /security
+/tactics                 → Redirect → /education
+/threats                 → Redirect → /intelligence
 ```
 
 SPA routing on Cloudflare is handled by `wrangler.jsonc` (`not_found_handling: "single-page-application"`). On GitHub Pages, a `404.html` redirect handles deep links.
@@ -56,28 +60,31 @@ All structured content lives in `src/data/` as JSON files. Components import the
 
 ```
 src/data/
-├── political_prisoners_research.json     # 62 prisoners with status, dates, sources
-├── sanctions_tracker.json                # 35 sanctions across US/EU/UK/CA/AU
+├── political_prisoners_research.json     # 64 prisoners with status, dates, sources
+├── sanctions_tracker.json                # 47 sanctions across US/EU/UK/CA/AU
+├── sanctioned_officials_research.json    # 34 CCP officials under international sanctions
+├── forced_labor_companies_research.json  # 30 companies linked to forced labor
 ├── detention_facilities_research.json    # 11 facilities with coordinates, capacity
-├── sanctioned_officials_research.json    # CCP officials under international sanctions
-├── forced_labor_companies_research.json  # Companies linked to forced labor
-├── confucius_institutes_research.json    # Confucius Institutes worldwide
-├── timeline_events.json                  # 31 events from 1989–2026
+├── timeline_events.json                  # 40 events from 1989–2026
 ├── security_center_data.json             # Security tools and recommendations
 ├── data_sources.json                     # RSS sources and source categories
 ├── academic_experts_research.json        # Expert researchers
 ├── human_rights_orgs_research.json       # Organizations directory
 ├── international_responses_research.json # Government responses
 ├── police_stations_research.json         # CCP overseas police stations
 ├── recent_news_research.json             # Recent developments
-├── ccpTactics.js                         # CCP tactics documentation
-├── researchData.js                       # General research data
-└── liveDataSources.js                    # Live data source configurations
+├── recent_updates.json                   # Platform changelog entries
+├── emergency_alerts.json                 # Active emergency alerts
+├── live_data_feeds.json                  # Live data source configurations
+├── live_statistics.json                  # Live statistics data
+├── educational_modules.json              # Educational content modules
+├── legal_cases_research.json             # Legal cases data
+└── take_action_steps.json                # Action step guides
 ```
 
 ### Why JSON?
 - **Verifiable**: Every entry has source URLs that can be checked
-- **Testable**: 631 automated tests validate data integrity (required fields, valid URLs, no CCP sources)
+- **Testable**: 3,602 automated tests validate data integrity (required fields, valid URLs, no CCP sources)
 - **No runtime dependency**: Data is bundled into JavaScript — the site works offline after initial load
 - **Git-auditable**: All changes go through PR review
 
@@ -87,9 +94,9 @@ src/data/
 
 ### Page Layout
 ```
-App.jsx
+App.tsx
 ├── Header (navigation, language selector, mobile menu)
-├── Sidebar (desktop navigation)
+├── Sidebar (desktop navigation — 7 items)
 ├── <Routes>
 │   ├── Dashboard
 │   ├── IntelligenceFeeds
@@ -99,7 +106,7 @@ App.jsx
 │   ├── SecurityCenter
 │   │   ├── Tab: Overview
 │   │   ├── Tab: Tools
-│   │   ├── Tab: Exit Ban Guide (ChinaExitBan)
+│   │   ├── Tab: Guides (ChinaExitBan, WhistleblowerGuide)
 │   │   ├── Tab: Quiz
 │   │   └── Tab: Report (IncidentReportForm)
 │   ├── profiles/:slug → Profile pages (5-tab layout each)
@@ -109,7 +116,7 @@ App.jsx
 
 ### Lazy Loading
 All page-level components and heavy sub-components use `React.lazy()` + `<Suspense>`:
-```jsx
+```tsx
 const Dashboard = lazy(() => import('./pages/Dashboard'));
 ```
 
@@ -123,8 +130,8 @@ const Dashboard = lazy(() => import('./pages/Dashboard'));
 ## Supabase Integration (Optional)
 
 When `VITE_SUPABASE_URL` and `VITE_SUPABASE_ANON_KEY` are configured:
-- `src/services/supabaseClient.js` creates a Supabase client
-- `src/services/supabaseService.js` provides helpers for 4 form types:
+- `src/services/supabaseClient.ts` creates a Supabase client
+- `src/services/supabaseService.ts` provides helpers for 4 form types:
   - `submitIncidentReport()` → `incident_reports` table
   - `submitVolunteerSignup()` → `volunteer_signups` table
   - `submitNewsletterSubscription()` → `newsletter_subscribers` table
@@ -136,30 +143,33 @@ When not configured, the client is `null` and forms display "Coming Soon" notice
 
 ## CCP Influence Detection
 
-`src/services/sourceLinks.js` contains a centralized system for detecting CCP state media:
+Centralized system in `src/utils/sourceLinks.ts` for detecting CCP state media:
 - 21 state media outlet names (e.g., Xinhua, CGTN, People's Daily, Global Times)
 - 13 blocked domains (e.g., xinhuanet.com, cgtn.com, globaltimes.cn)
 - 15 elevated-risk entries requiring extra scrutiny
 - 4 utility functions: `isCCPSource()`, `isElevatedRisk()`, `getSourceRiskLevel()`, `validateSources()`
-- 37 dedicated tests in `src/test/ccp-influence-detection.test.js`
+- 37 dedicated tests in `src/test/ccp-influence-detection.test.ts`
 
 ---
 
 ## Testing Strategy
 
-631 tests across 34 files using Vitest + jsdom + React Testing Library.
+3,602 tests across 192 files using Vitest + jsdom + React Testing Library.
 
 | Category | Files | What it tests |
 |----------|-------|---------------|
-| Data integrity | 8 files | JSON fields, valid URLs, no CCP sources, chronological order |
-| Component tests | 10 files | React components render, user interactions, form submissions |
-| Accessibility | 1 file | ARIA labels, keyboard nav, contrast ratios |
-| Design system | 1 file | Scans all JSX for prohibited CSS patterns |
-| URL health | 1 file | No CCP domains, no insecure HTTP URLs in data |
+| Data integrity | 15+ files | JSON fields, valid URLs, no CCP sources, chronological order, cross-dataset consistency |
+| Component tests | 60+ files | React components render, user interactions, form submissions |
+| Accessibility | 3 files | ARIA labels, keyboard nav, contrast ratios, heading hierarchy |
+| Design system | 1 file | Scans all TSX for prohibited CSS patterns (8 automated checks) |
+| URL health | 2 files | No CCP domains, no insecure HTTP URLs in data, HTTPS validation |
 | i18n | 1 file | All 8 locales have identical key sets |
-| Security | 2 files | CSP headers, WebRTC leak detection |
-| Services | 2 files | Supabase service, live data service |
-| Other | 8 files | Sitemap, manifest/PWA, routes, utilities |
+| Security | 3 files | CSP headers, WebRTC leak detection, supabase key validation |
+| Performance | 3 files | Bundle size budget, performance resilience, responsive layout |
+| TypeScript purity | 1 file | Enforces 0 JS/JSX files, no @ts-nocheck, strict mode |
+| Services | 4 files | Supabase service, live data service, data API, source links |
+| Profile pages | 15 files | All 15 profile pages render with correct data |
+| Other | 80+ files | Sitemap, manifest/PWA, routes, utilities, defensive coding, import hygiene |
 
 ---
 

README.md

@@ -32,12 +32,12 @@ This platform serves as a centralized resource for:
 - CCP Operations tab with detention facility mapping and overseas police stations
 
 ### Sanctions Tracker
-- 35 sanctioned individuals/entities across US, EU, UK, Canada, and Australia
+- 47 sanctioned individuals/entities across US, EU, UK, Canada, and Australia
 - Source URLs linking to official government registries (US Treasury SDN, UK FCDO, EU Council)
 - Structured JSON data in `src/data/sanctions_tracker.json`
 
 ### Political Prisoners Database
-- 62 documented political prisoners with source URLs in `src/data/political_prisoners_research.json`
+- 64 documented political prisoners with source URLs in `src/data/political_prisoners_research.json`
 - Status tracking (imprisoned, disappeared, deceased)
 - Action items for advocacy
 
@@ -56,7 +56,7 @@ This platform serves as a centralized resource for:
 - Information control and censorship
 
 ### CCP Influence Detection
-- Centralized system in `src/services/sourceLinks.js`
+- Centralized system in `src/utils/sourceLinks.ts`
 - 21 state media names + 13 domains in the never-cite blocklist
 - 15 elevated-risk entries for sources requiring extra scrutiny
 - 4 utility functions, 37 dedicated tests
@@ -93,14 +93,15 @@ This is a **static React SPA** — all data is compiled into the JavaScript bund
 
 ```
 src/
-├── pages/              # 10 main pages + 15 profiles in profiles/
-├── components/         # 100+ React components (lazy-loaded)
-├── data/               # 17 JSON/JS data files (the source of truth)
-├── services/           # Supabase client, live data service, source links
+├── pages/              # 10 main pages + 16 profiles in profiles/
+├── components/         # 109 React components (lazy-loaded)
+├── data/               # 20 JSON data files (the source of truth)
+├── services/           # Supabase client, data API, live data service, auth
 ├── hooks/              # useDocumentTitle, useLiveData, useWebRTCLeakCheck
 ├── contexts/           # ThemeContext, LanguageContext, SocketContext (stub)
 ├── locales/            # 8 locale JSON files (en, zh-CN, zh-TW, vi, ko, ja, ug, bo)
-└── test/               # 34 Vitest test files, 631 tests
+├── utils/              # dateUtils, sourceLinks, logger, encryption
+└── test/               # 192 Vitest test files, 3,602 tests
 ```
 
 ### Data Flow
@@ -109,13 +110,13 @@ All structured content lives in `src/data/` as JSON files:
 
 | File | Content | Used by |
 |------|---------|---------|
-| `political_prisoners_research.json` | 62 prisoners with sources | PoliticalPrisoners page |
+| `political_prisoners_research.json` | 64 prisoners with sources | PoliticalPrisoners page |
 | `sanctions_tracker.json` | 47 sanctions entries | SanctionsTracker component |
 | `detention_facilities_research.json` | 11 facilities with coordinates | DetentionFacilities component |
 | `sanctioned_officials_research.json` | 34 CCP officials tracked | CCPOfficials component |
-| `forced_labor_companies_research.json` | Companies linked to forced labor | ForcedLaborTracker component |
-| `timeline_events.json` | 31 events (1989–2026) | InteractiveTimeline component |
-| `confucius_institutes_research.json` | Confucius Institutes data | ConfuciusInstitutes component |
+| `forced_labor_companies_research.json` | 30 companies linked to forced labor | ForcedLaborTracker component |
+| `timeline_events.json` | 40 events (1989–2026) | InteractiveTimeline component |
+| `legal_cases_research.json` | Legal cases data | LegalCaseTracker component |
 | `security_center_data.json` | Security tools & recommendations | SecurityCenter page |
 | `data_sources.json` | 11 RSS sources + 4 source categories | DataSources page |
 
@@ -139,7 +140,7 @@ Components import JSON directly — Vite bundles it at build time. No API calls
 ### Frontend (Static SPA)
 - **React 19** with **Vite 7** — fast builds, hot module replacement
 - **TailwindCSS 3** for styling (terminal/ASCII aesthetic)
-- **Framer Motion** for animations
+- **100% TypeScript** — zero JavaScript/JSX files remain (360+ .ts/.tsx files)
 - **React Router v7** for client-side navigation
 - **Lucide React** for icons
 - **Custom i18n** system with JSON locale files (8 languages, 194 keys each)
@@ -173,13 +174,13 @@ npm run dev             # Start dev server at http://localhost:5173
 
 ### Build
 ```bash
-npm run build           # Produces dist/ (~305KB main bundle, 97KB gzipped)
+npm run build           # Produces dist/ (~310KB main bundle, 99KB gzipped)
 npm run preview         # Preview production build locally
 ```
 
 ### Testing
 ```bash
-npm test                # Run all 631 tests across 34 files
+npm test                # Run all 3,602 tests across 192 files
 npm run test:watch      # Watch mode for development
 ```