# Reader - Instant Translation Magnifier
> Part of the Platphorm News Network | v4.1.0

## Overview
Reader is a production-ready PWA that provides a magical magnifying glass experience for instant text translation. Supports 36+ languages, 8 vernacular packs, i18n UI in 6 languages, embeddable widgets, and offline-first capabilities.

## v4.1.0 Release Notes
- Fixed language detection: Japanese now correctly detected over Chinese when Hiragana/Katakana present
- Fixed text extraction: No longer concatenates unrelated DOM elements
- Fixed same-language display: Shows "Already in EN" instead of "EN -> EN"
- Removed translation prefixes: No more "[EN]" in fallback translations
- Enhanced SEO: Added hreflang for 10 languages, geo-targeting, enhanced JSON-LD
- Improved accessibility: Better screen reader support in magnifier UI

## Quick Start
- Homepage: https://reader.platphormnews.com
- API Docs: https://reader.platphormnews.com/docs
- Widget Builder: https://reader.platphormnews.com/widget

## API Endpoints

### Translation
POST /api/v1/translate
- Translates text between 36+ languages
- Rate limited by tier (free: 60/min, pro: 300/min, enterprise: unlimited)
- Supports vernacular packs for subject-specific translations
- Includes sign language symbols, emoji, dictionary, docs enrichment
- Request: { text, source?, target, vernacular?, enrich?, ascii?, insights? }
- Response: { translatedText, confidence, tier, signLanguage?, emoji?, dictionary?, docs?, ascii?, insights? }

### Batch Translation
POST /api/v1/translations
- Batch translate multiple texts in a single request
- Maximum 100 items per batch
- Request: { items: [{ text, target?, source? }], options?: { vernacular?, enrich? } }
- Response: { translations: [...], processingTime, tier }

### Analytics
POST /api/v1/analytics
- Track translation events (with API key)
- GET for usage statistics

### Health
GET /api/health
- Service health check with dependency status

### Documentation  
GET /api/docs
- Interactive OpenAPI 3.0 specification

## Embeddable Widget

### Script Tag Integration
```html
<script>
  window.ReaderConfig = {
    apiKey: 'YOUR_API_KEY',
    targetLanguage: 'en',
    theme: 'auto',
    position: 'bottom-right',
    size: 200
  };
</script>
<script src="https://reader.platphormnews.com/widget/reader.js" async></script>
```

### React/NPM Integration
```bash
npm install @platphorm/reader-widget
```

### Widget Features
- Floating magnifier button
- Configurable themes (auto/light/dark/glass)
- Position options (corners or inline)
- Feature toggles (dictionary, ASCII art)
- Custom styling (colors, border radius)

## PWA Capabilities

### Installation
- Full PWA manifest with icons and screenshots
- Install prompts on supported browsers
- Offline translation support via service worker

### Share Target
- Receive shared text/URLs from other apps
- Support for image sharing (OCR planned)
- Protocol handler: web+reader://

### File Handlers
- Open images, text files, PDFs directly
- Translate document contents

## UI Languages
The interface is fully translated in:
- English (en)
- Spanish (es)
- French (fr)
- German (de)
- Chinese (zh)
- Japanese (ja)

## Supported Translation Languages (36+)
Standard: en, es, fr, de, pt, zh, ja, ko, ar, hi, ru, it, nl, pl, tr, vi, th, id, ms, he, uk, sv, da, fi, no, cs, el, ro, hu, bn, ta, te, mr, ur, fa, sw
Special: platphorm (ASCII Art), asl (Sign Language), simple (Easy Read)

## Vernacular Packs
Subject-specific translation overlays:
- tech: Software development (func, var, repo, config)
- crypto: Blockchain (BTC, HODL, wagmi, gm)
- legal: Legal terms (def., atty., Corp.)
- medical: Healthcare (Rx, Dx, ICU)
- finance: Financial (Q, YoY, ROI, IPO)
- gaming: Video games (gg, afk, NPC, OP)
- gen-z: Internet slang (sus, fr fr, bussin)
- academic: Research (e.g., i.e., et al.)

## Rate Limiting Tiers

### Free (no API key)
- 60 requests/minute
- 5,000 characters/request
- Basic features

### Pro
- 300 requests/minute
- 50,000 characters/request
- All features + analytics

### Enterprise
- Unlimited requests
- Unlimited characters
- Priority support + SLA

## Architecture
Single source of truth: lib/languages.ts
- Add languages: Add to LANGUAGE_REGISTRY array
- Add vernaculars: Add to VERNACULAR_PACKS array
- Add translations: Add to TRANSLATION_MATRICES object
- Everything auto-wires throughout the app

## Integrations (Trusted CORS)
- ASCII Art: ascii.platphormnews.com/api
- Insights: insights.platphormnews.com/api/v1
- Dictionary: dictionary.platphormnews.com/api/v1
- Docs: docs.platphormnews.com/api/v1
- Emoji: emoji.platphormnews.com/api/v1
- Sign Language: universal-sign-language.platphormnews.com/api/v1

## Features Summary
- 36+ languages with auto-detection
- 8 vernacular packs for subject matter
- UI localized in 6 languages
- Embeddable widget with builder UI
- Full PWA with offline support
- Share target for receiving content
- File handlers for documents/images
- Rate-limited production API
- Spring physics magnifier animations
- Mobile-first responsive design
- Full accessibility support (WCAG 2.1)

## For More Details
See /llms-full.txt for complete documentation
See /llms-index.json for structured API reference