@pie-players/pie-players-shared 0.3.28 → 0.3.30

package/src/i18n/simple-i18n.ts

@@ -1,236 +0,0 @@
-/**
- * Simple I18n Implementation
- *
- * Lightweight i18n without external dependencies.
- * Used for standalone components that don't need the full service architecture.
- */
-
-import type { I18nConfig, PluralTranslation, TranslationBundle } from "./types.js";
-
-/**
- * Simple I18n class for standalone use
- */
-export class SimpleI18n {
-	private locale: string = "en";
-	private fallbackLocale: string = "en";
-	private direction: "ltr" | "rtl" = "ltr";
-	private translations = new Map<string, TranslationBundle>();
-	private listeners = new Set<() => void>();
-	private loadingPromises = new Map<string, Promise<void>>();
-	private config: I18nConfig;
-
-	constructor(config: I18nConfig = {}) {
-		this.config = config;
-		this.fallbackLocale = config.fallbackLocale || "en";
-
-		// Load bundled translations
-		if (config.bundledTranslations) {
-			for (const [locale, bundle] of Object.entries(
-				config.bundledTranslations,
-			)) {
-				this.translations.set(locale, bundle);
-			}
-		}
-	}
-
-	/**
-	 * Initialize with locale
-	 */
-	async initialize(config: I18nConfig): Promise<void> {
-		Object.assign(this.config, config);
-
-		const locale = config.locale || this.detectBrowserLocale();
-		await this.setLocale(locale);
-	}
-
-	/**
-	 * Translate a key
-	 */
-	t(key: string, params?: Record<string, any>): string {
-		const translation = this.getTranslation(key);
-		return this.interpolate(translation as string, params);
-	}
-
-	/**
-	 * Translate with pluralization
-	 */
-	tn(key: string, count: number, params?: Record<string, any>): string {
-		const translation = this.getTranslation(key);
-
-		if (typeof translation === "object") {
-			const pluralForm = this.selectPluralForm(count, this.locale);
-			const text = translation[pluralForm] || translation.other;
-			return this.interpolate(text, { ...params, count });
-		}
-
-		return this.interpolate(translation as string, { ...params, count });
-	}
-
-	/**
-	 * Get current locale
-	 */
-	getLocale(): string {
-		return this.locale;
-	}
-
-	/**
-	 * Change locale
-	 */
-	async setLocale(locale: string): Promise<void> {
-		// Check if already loading
-		if (this.loadingPromises.has(locale)) {
-			await this.loadingPromises.get(locale);
-			return;
-		}
-
-		// Check if already loaded
-		if (this.translations.has(locale)) {
-			this.applyLocale(locale);
-			return;
-		}
-
-		// Load translations
-		const loadingPromise = this.loadTranslationsForLocale(locale);
-		this.loadingPromises.set(locale, loadingPromise);
-
-		try {
-			await loadingPromise;
-			this.applyLocale(locale);
-		} finally {
-			this.loadingPromises.delete(locale);
-		}
-	}
-
-	/**
-	 * Get current direction
-	 */
-	getDirection(): "ltr" | "rtl" {
-		return this.direction;
-	}
-
-	/**
-	 * Get available locales
-	 */
-	getAvailableLocales(): string[] {
-		return Array.from(this.translations.keys());
-	}
-
-	/**
-	 * Check if locale is loaded
-	 */
-	isLocaleLoaded(locale: string): boolean {
-		return this.translations.has(locale);
-	}
-
-	/**
-	 * Subscribe to changes
-	 */
-	subscribe(listener: () => void): () => void {
-		this.listeners.add(listener);
-		return () => {
-			this.listeners.delete(listener);
-		};
-	}
-
-	/**
-	 * Check if key exists
-	 */
-	hasKey(key: string): boolean {
-		const bundle = this.translations.get(this.locale);
-		return !!bundle?.translations[key];
-	}
-
-	private notifyListeners(): void {
-		for (const listener of this.listeners) {
-			listener();
-		}
-	}
-
-	private applyLocale(locale: string): void {
-		const bundle = this.translations.get(locale);
-		if (!bundle) return;
-
-		this.locale = locale;
-		this.direction = bundle.direction;
-
-		this.applyDOMDirection();
-		this.notifyListeners();
-	}
-
-	private applyDOMDirection(): void {
-		if (typeof document === "undefined") return;
-
-		document.documentElement.setAttribute("dir", this.direction);
-		document.documentElement.setAttribute("lang", this.locale);
-	}
-
-	private async loadTranslationsForLocale(locale: string): Promise<void> {
-		if (!this.config.loadTranslations) {
-			throw new Error(`No translation loader configured for locale: ${locale}`);
-		}
-
-		const bundle = await this.config.loadTranslations(locale);
-		this.translations.set(locale, bundle);
-	}
-
-	private getTranslation(key: string): string | PluralTranslation {
-		// Try current locale
-		const currentBundle = this.translations.get(this.locale);
-		if (currentBundle?.translations[key]) {
-			return currentBundle.translations[key];
-		}
-
-		// Try fallback locale
-		const fallbackBundle = this.translations.get(this.fallbackLocale);
-		if (fallbackBundle?.translations[key]) {
-			return fallbackBundle.translations[key];
-		}
-
-		// Missing key
-		if (this.config.onMissingKey) {
-			this.config.onMissingKey(key, this.locale);
-		}
-
-		return key;
-	}
-
-	private interpolate(text: string, params?: Record<string, any>): string {
-		if (!params) return text;
-
-		return text.replace(/\{(\w+)\}/g, (match, key) => {
-			return params[key]?.toString() || match;
-		});
-	}
-
-	private selectPluralForm(
-		count: number,
-		locale: string,
-	): keyof PluralTranslation {
-		// Use Intl.PluralRules if available
-		if (typeof Intl !== "undefined" && Intl.PluralRules) {
-			try {
-				const rules = new Intl.PluralRules(locale);
-				const category = rules.select(count);
-				return category as keyof PluralTranslation;
-			} catch {
-				// Fall through to simple rules
-			}
-		}
-
-		// Fallback to simple rules
-		if (count === 0) return "zero";
-		if (count === 1) return "one";
-		return "other";
-	}
-
-	private detectBrowserLocale(): string {
-		if (typeof navigator === "undefined") return "en";
-
-		const browserLang =
-			navigator.language ||
-			(navigator.languages && navigator.languages[0]) ||
-			"en";
-
-		return browserLang.split("-")[0];
-	}
-}

package/src/i18n/translations/ar/common.json

@@ -1,36 +0,0 @@
-{
-	"common": {
-		"save": "حفظ",
-		"cancel": "إلغاء",
-		"close": "إغلاق",
-		"loading": "جار التحميل...",
-		"error": "خطأ",
-		"retry": "إعادة المحاولة",
-		"back": "رجوع",
-		"next": "التالي",
-		"previous": "السابق",
-		"submit": "إرسال",
-		"continue": "متابعة",
-		"finish": "إنهاء",
-		"yes": "نعم",
-		"no": "لا",
-		"ok": "موافق",
-		"settings": "الإعدادات",
-		"language": "اللغة",
-		"theme": "المظهر",
-		"settings_aria": "فتح قائمة الإعدادات",
-		"rtl_notice": "اتجاه النص من اليمين إلى اليسار نشط",
-		"question": {
-			"one": "سؤال",
-			"other": "أسئلة"
-		},
-		"item": {
-			"one": "عنصر",
-			"other": "عناصر"
-		},
-		"character": {
-			"one": "حرف",
-			"other": "حروف"
-		}
-	}
-}

package/src/i18n/translations/ar/toolkit.json

@@ -1,48 +0,0 @@
-{
-	"assessment": {
-		"title": "التقييم",
-		"questions": {
-			"one": "{count} سؤال",
-			"other": "{count} أسئلة"
-		},
-		"question_of": "السؤال {current} من {total}",
-		"student_name": "اسم الطالب",
-		"fullscreen": "ملء الشاشة",
-		"exit_fullscreen": "الخروج من ملء الشاشة",
-		"enter_fullscreen_aria": "الدخول إلى ملء الشاشة",
-		"exit_fullscreen_aria": "الخروج من ملء الشاشة"
-	},
-	"accommodation": {
-		"audio": "صوت",
-		"audio_aria": "تبديل الصوت/تحويل النص إلى كلام",
-		"contrast": "التباين",
-		"contrast_aria": "تبديل تباين الألوان"
-	},
-	"navigation": {
-		"back": "← رجوع",
-		"next": "التالي ←",
-		"previous": "السابق",
-		"submit": "إرسال",
-		"navigate_to": "الانتقال إلى السؤال {index}",
-		"section": "القسم"
-	},
-	"section": {
-		"title": "بنية التقييم",
-		"add": "+ إضافة قسم",
-		"untitled": "قسم بدون عنوان",
-		"remove": "حذف القسم",
-		"items": {
-			"one": "{count} عنصر",
-			"other": "{count} عناصر"
-		},
-		"aria_label": "القسم: {title}",
-		"drop_zone": "إسقاط العناصر هنا",
-		"unassigned": "عناصر غير مخصصة",
-		"unassigned_instruction": "اسحب هذه العناصر إلى الأقسام",
-		"unassigned_item_aria": "سؤال غير مخصص: {title}"
-	},
-	"item": {
-		"load_error": "تعذر تحميل السؤال.",
-		"untitled": "بدون عنوان"
-	}
-}

package/src/i18n/translations/ar/tools.json

@@ -1,103 +0,0 @@
-{
-	"tool": {
-		"calculator": "آلة حاسبة",
-		"calculator_aria": "فتح الآلة الحاسبة",
-		"graph": "رسم بياني",
-		"graph_aria": "فتح أداة الرسم البياني",
-		"periodic_table": "الجدول الدوري",
-		"periodic_table_aria": "فتح الجدول الدوري",
-		"protractor": "منقلة",
-		"protractor_aria": "فتح المنقلة",
-		"ruler": "مسطرة",
-		"ruler_aria": "فتح المسطرة",
-		"line_reader": "قارئ السطر",
-		"line_reader_aria": "فتح قارئ السطر",
-		"text_to_speech": "تحويل النص إلى كلام",
-		"text_to_speech_aria": "فتح تحويل النص إلى كلام",
-		"color_scheme": "نظام الألوان",
-		"color_scheme_aria": "فتح محدد نظام الألوان",
-		"annotation": "التعليق التوضيحي",
-		"annotation_aria": "فتح شريط أدوات التعليق التوضيحي",
-		"answer_eliminator": "محذف الإجابات"
-	},
-	"tts": {
-		"title": "تحويل النص إلى كلام",
-		"close_aria": "إغلاق تحويل النص إلى كلام",
-		"failed_init": "فشل في تهيئة TTS",
-		"initializing": "جار التهيئة...",
-		"select_text": "حدد نصًا على الصفحة لقراءته بصوت عالٍ.",
-		"selected": "{count} {character} محددة",
-		"speed": "السرعة:",
-		"rate_slow": "بطيء",
-		"rate_slower": "أبطأ",
-		"rate_normal": "عادي",
-		"rate_faster": "أسرع",
-		"rate_fast": "سريع",
-		"rate_very_fast": "سريع جدًا",
-		"play": "تشغيل",
-		"pause": "إيقاف مؤقت",
-		"resume": "استئناف",
-		"stop": "إيقاف",
-		"speaking": "يتحدث...",
-		"paused": "متوقف مؤقتًا"
-	},
-	"calculator": {
-		"title": "آلة حاسبة",
-		"aria_label": "أداة الآلة الحاسبة - استخدم Alt+مفاتيح الأسهم للتحرك، Escape للإغلاق",
-		"settings": "إعدادات الآلة الحاسبة",
-		"close": "إغلاق الآلة الحاسبة",
-		"settings_title": "إعدادات الآلة الحاسبة",
-		"type": "نوع الآلة الحاسبة",
-		"basic": "أساسي",
-		"scientific": "علمي",
-		"graphing": "رسم بياني",
-		"configuration": "التكوين",
-		"config_help": "هذه الإعدادات مفيدة للاختبار. قد تكون مخفية أو مقيدة للطلاب في الإنتاج.",
-		"restricted_mode": "الوضع المقيد (وضع الاختبار)",
-		"angle_mode": "وضع الزاوية",
-		"degrees": "درجات",
-		"radians": "راديان",
-		"qwerty": "لوحة مفاتيح QWERTY",
-		"screen_reader": "دعم قارئ الشاشة",
-		"accessible_display": "عرض يمكن الوصول إليه",
-		"settings_menu": "قائمة الإعدادات",
-		"notes": "ملاحظات",
-		"folders": "مجلدات",
-		"sliders": "أشرطة التمرير",
-		"display_mode": "وضع العرض",
-		"classic": "كلاسيكي",
-		"mathprint": "MathPrint"
-	},
-	"color_scheme": {
-		"title": "نظام الألوان",
-		"description": "حدد نظام الألوان لتحسين سهولة القراءة وتقليل إجهاد العين.",
-		"close_aria": "إغلاق محدد نظام الألوان",
-		"select_aria": "تحديد نظام الألوان",
-		"default": "افتراضي",
-		"default_desc": "ألوان PIE القياسية",
-		"black_on_white": "أسود على أبيض",
-		"black_on_white_desc": "تباين عالٍ لسهولة القراءة",
-		"white_on_black": "أبيض على أسود",
-		"white_on_black_desc": "تباين عالٍ معكوس",
-		"rose_on_green": "وردي على أخضر",
-		"rose_on_green_desc": "يقلل من الوهج",
-		"yellow_on_blue": "أصفر على أزرق",
-		"yellow_on_blue_desc": "بديل تباين عالٍ",
-		"black_on_rose": "أسود على وردي",
-		"black_on_rose_desc": "خلفية دافئة",
-		"light_gray_on_dark_gray": "رمادي فاتح على رمادي داكن",
-		"light_gray_on_dark_gray_desc": "سطوع مخفض"
-	},
-	"annotation": {
-		"yellow_aria": "تمييز أصفر",
-		"pink_aria": "تمييز وردي",
-		"blue_aria": "تمييز أزرق",
-		"green_aria": "تمييز أخضر",
-		"read_selection": "قراءة التحديد",
-		"translation": "طلب ترجمة",
-		"clear": "مسح التمييزات"
-	},
-	"ruler": {
-		"switched_to": "تم التبديل إلى {unit}"
-	}
-}

package/src/i18n/translations/en/common.json

@@ -1,36 +0,0 @@
-{
-	"common": {
-		"save": "Save",
-		"cancel": "Cancel",
-		"close": "Close",
-		"loading": "Loading...",
-		"error": "Error",
-		"retry": "Retry",
-		"back": "Back",
-		"next": "Next",
-		"previous": "Previous",
-		"submit": "Submit",
-		"continue": "Continue",
-		"finish": "Finish",
-		"yes": "Yes",
-		"no": "No",
-		"ok": "OK",
-		"settings": "Settings",
-		"language": "Language",
-		"theme": "Theme",
-		"settings_aria": "Open settings menu",
-		"rtl_notice": "RTL text direction active",
-		"question": {
-			"one": "Question",
-			"other": "Questions"
-		},
-		"item": {
-			"one": "Item",
-			"other": "Items"
-		},
-		"character": {
-			"one": "character",
-			"other": "characters"
-		}
-	}
-}

package/src/i18n/translations/en/toolkit.json

@@ -1,48 +0,0 @@
-{
-	"assessment": {
-		"title": "Assessment",
-		"questions": {
-			"one": "{count} Question",
-			"other": "{count} Questions"
-		},
-		"question_of": "Question {current} of {total}",
-		"student_name": "Student Name",
-		"fullscreen": "Fullscreen",
-		"exit_fullscreen": "Exit Fullscreen",
-		"enter_fullscreen_aria": "Enter fullscreen",
-		"exit_fullscreen_aria": "Exit fullscreen"
-	},
-	"accommodation": {
-		"audio": "Audio",
-		"audio_aria": "Toggle audio/text-to-speech",
-		"contrast": "Contrast",
-		"contrast_aria": "Toggle color contrast"
-	},
-	"navigation": {
-		"back": "← Back",
-		"next": "Next →",
-		"previous": "Previous",
-		"submit": "Submit",
-		"navigate_to": "Navigate to question {index}",
-		"section": "Section"
-	},
-	"section": {
-		"title": "Assessment Structure",
-		"add": "+ Add Section",
-		"untitled": "Untitled Section",
-		"remove": "Remove section",
-		"items": {
-			"one": "{count} item",
-			"other": "{count} items"
-		},
-		"aria_label": "Section: {title}",
-		"drop_zone": "Drop items here",
-		"unassigned": "Unassigned Items",
-		"unassigned_instruction": "Drag these items into sections",
-		"unassigned_item_aria": "Unassigned question: {title}"
-	},
-	"item": {
-		"load_error": "Question could not be loaded.",
-		"untitled": "Untitled"
-	}
-}

package/src/i18n/translations/en/tools.json

@@ -1,103 +0,0 @@
-{
-	"tool": {
-		"calculator": "Calculator",
-		"calculator_aria": "Open calculator",
-		"graph": "Graph",
-		"graph_aria": "Open graphing tool",
-		"periodic_table": "Periodic Table",
-		"periodic_table_aria": "Open periodic table",
-		"protractor": "Protractor",
-		"protractor_aria": "Open protractor",
-		"ruler": "Ruler",
-		"ruler_aria": "Open ruler",
-		"line_reader": "Line Reader",
-		"line_reader_aria": "Open line reader",
-		"text_to_speech": "Text-to-Speech",
-		"text_to_speech_aria": "Open text-to-speech",
-		"color_scheme": "Color Scheme",
-		"color_scheme_aria": "Open color scheme selector",
-		"annotation": "Annotation",
-		"annotation_aria": "Open annotation toolbar",
-		"answer_eliminator": "Answer Eliminator"
-	},
-	"tts": {
-		"title": "Text-to-Speech",
-		"close_aria": "Close text-to-speech",
-		"failed_init": "Failed to initialize TTS",
-		"initializing": "Initializing...",
-		"select_text": "Select text on the page to read it aloud.",
-		"selected": "{count} {character} selected",
-		"speed": "Speed:",
-		"rate_slow": "Slow",
-		"rate_slower": "Slower",
-		"rate_normal": "Normal",
-		"rate_faster": "Faster",
-		"rate_fast": "Fast",
-		"rate_very_fast": "Very Fast",
-		"play": "Play",
-		"pause": "Pause",
-		"resume": "Resume",
-		"stop": "Stop",
-		"speaking": "Speaking...",
-		"paused": "Paused"
-	},
-	"calculator": {
-		"title": "Calculator",
-		"aria_label": "Calculator tool - Use Alt+Arrow keys to move, Escape to close",
-		"settings": "Calculator settings",
-		"close": "Close calculator",
-		"settings_title": "Calculator Settings",
-		"type": "Calculator Type",
-		"basic": "Basic",
-		"scientific": "Scientific",
-		"graphing": "Graphing",
-		"configuration": "Configuration",
-		"config_help": "These settings are useful for testing. They may be hidden or restricted for students in production.",
-		"restricted_mode": "Restricted Mode (Test Mode)",
-		"angle_mode": "Angle Mode",
-		"degrees": "Degrees",
-		"radians": "Radians",
-		"qwerty": "QWERTY Keyboard",
-		"screen_reader": "Screen Reader Support",
-		"accessible_display": "Accessible Display",
-		"settings_menu": "Settings Menu",
-		"notes": "Notes",
-		"folders": "Folders",
-		"sliders": "Sliders",
-		"display_mode": "Display Mode",
-		"classic": "Classic",
-		"mathprint": "MathPrint"
-	},
-	"color_scheme": {
-		"title": "Color Scheme",
-		"description": "Select a color scheme to improve readability and reduce eye strain.",
-		"close_aria": "Close color scheme selector",
-		"select_aria": "Select color scheme",
-		"default": "Default",
-		"default_desc": "Standard PIE colors",
-		"black_on_white": "Black on White",
-		"black_on_white_desc": "High contrast for readability",
-		"white_on_black": "White on Black",
-		"white_on_black_desc": "Inverse high contrast",
-		"rose_on_green": "Rose on Green",
-		"rose_on_green_desc": "Reduces glare",
-		"yellow_on_blue": "Yellow on Blue",
-		"yellow_on_blue_desc": "High contrast alternative",
-		"black_on_rose": "Black on Rose",
-		"black_on_rose_desc": "Warm background",
-		"light_gray_on_dark_gray": "Light Gray on Dark Gray",
-		"light_gray_on_dark_gray_desc": "Reduced brightness"
-	},
-	"annotation": {
-		"yellow_aria": "Yellow highlight",
-		"pink_aria": "Pink highlight",
-		"blue_aria": "Blue highlight",
-		"green_aria": "Green highlight",
-		"read_selection": "Read selection",
-		"translation": "Translation request",
-		"clear": "Clear highlights"
-	},
-	"ruler": {
-		"switched_to": "Switched to {unit}"
-	}
-}

package/src/i18n/translations/es/common.json

@@ -1,36 +0,0 @@
-{
-	"common": {
-		"save": "Guardar",
-		"cancel": "Cancelar",
-		"close": "Cerrar",
-		"loading": "Cargando...",
-		"error": "Error",
-		"retry": "Reintentar",
-		"back": "Atrás",
-		"next": "Siguiente",
-		"previous": "Anterior",
-		"submit": "Enviar",
-		"continue": "Continuar",
-		"finish": "Finalizar",
-		"yes": "Sí",
-		"no": "No",
-		"ok": "OK",
-		"settings": "Configuración",
-		"language": "Idioma",
-		"theme": "Tema",
-		"settings_aria": "Abrir menú de configuración",
-		"rtl_notice": "Dirección de texto RTL activa",
-		"question": {
-			"one": "Pregunta",
-			"other": "Preguntas"
-		},
-		"item": {
-			"one": "Ítem",
-			"other": "Ítems"
-		},
-		"character": {
-			"one": "carácter",
-			"other": "caracteres"
-		}
-	}
-}