@pie-players/pie-assessment-toolkit 0.2.0

package/dist/services/I18nService.d.ts

@@ -0,0 +1,121 @@
+/**
+ * I18nService
+ *
+ * Internationalization service with hybrid loading strategy.
+ * Manages translations, locale switching, and RTL/LTR direction.
+ *
+ * Features:
+ * - Subscriber/listener pattern for reactive updates
+ * - Hybrid loading: Bundle English, lazy-load other locales
+ * - Interpolation: {variable} syntax
+ * - Pluralization: ICU-style plural rules
+ * - RTL detection: Automatic based on locale
+ * - TypedEventBus integration: Emit locale change events
+ * - Fallback to English for missing keys
+ *
+ * Part of PIE Assessment Toolkit.
+ */
+import type { I18nConfig, II18nService, PluralTranslation, TranslationBundle } from "@pie-players/pie-players-shared/i18n";
+export type { I18nConfig, II18nService, PluralTranslation, TranslationBundle };
+/**
+ * I18nService
+ *
+ * Manages internationalization with reactive state updates.
+ */
+export declare class I18nService implements II18nService {
+    private locale;
+    private fallbackLocale;
+    private direction;
+    private translations;
+    private listeners;
+    private loadingPromises;
+    private config;
+    constructor(config?: I18nConfig);
+    /**
+     * Initialize i18n with locale and loading strategy
+     */
+    initialize(config: I18nConfig): Promise<void>;
+    /**
+     * Translate a key with optional interpolation
+     *
+     * @param key Translation key (e.g., 'common.save')
+     * @param params Optional parameters for interpolation
+     * @returns Translated string
+     */
+    t(key: string, params?: Record<string, any>): string;
+    /**
+     * Translate with pluralization
+     *
+     * @param key Translation key
+     * @param count Count for pluralization
+     * @param params Optional parameters for interpolation
+     * @returns Translated string with plural form
+     */
+    tn(key: string, count: number, params?: Record<string, any>): string;
+    /**
+     * Get current locale
+     */
+    getLocale(): string;
+    /**
+     * Change locale (triggers async loading if needed)
+     *
+     * @param locale Locale code (e.g., 'en', 'es', 'zh', 'ar')
+     */
+    setLocale(locale: string): Promise<void>;
+    /**
+     * Get current text direction
+     */
+    getDirection(): "ltr" | "rtl";
+    /**
+     * Get available locales
+     */
+    getAvailableLocales(): string[];
+    /**
+     * Check if locale is loaded
+     */
+    isLocaleLoaded(locale: string): boolean;
+    /**
+     * Subscribe to locale/translation changes
+     * Returns unsubscribe function
+     */
+    subscribe(listener: () => void): () => void;
+    /**
+     * Check if a translation key exists
+     */
+    hasKey(key: string): boolean;
+    /**
+     * Notify all listeners of state change
+     */
+    private notifyListeners;
+    /**
+     * Apply locale and notify listeners
+     */
+    private applyLocale;
+    /**
+     * Apply direction to DOM
+     */
+    private applyDOMDirection;
+    /**
+     * Load translations for a locale
+     */
+    private loadTranslationsForLocale;
+    /**
+     * Get translation for a key
+     */
+    private getTranslation;
+    /**
+     * Interpolate variables in translation string
+     * Replaces {variable} with params.variable
+     */
+    private interpolate;
+    /**
+     * Select plural form based on count and locale
+     * Simplified implementation - real implementation would use Intl.PluralRules
+     */
+    private selectPluralForm;
+    /**
+     * Detect browser locale
+     */
+    private detectBrowserLocale;
+}
+//# sourceMappingURL=I18nService.d.ts.map

package/dist/services/I18nService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"I18nService.d.ts","sourceRoot":"","sources":["../../src/services/I18nService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EACX,UAAU,EACV,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,EACjB,MAAM,sCAAsC,CAAC;AAM9C,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,CAAC;AAE/E;;;;GAIG;AACH,qBAAa,WAAY,YAAW,YAAY;IAC/C,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,cAAc,CAAgB;IACtC,OAAO,CAAC,SAAS,CAAwB;IACzC,OAAO,CAAC,YAAY,CAAwC;IAC5D,OAAO,CAAC,SAAS,CAAyB;IAC1C,OAAO,CAAC,eAAe,CAAoC;IAC3D,OAAO,CAAC,MAAM,CAAa;gBAEf,MAAM,GAAE,UAAe;IAiBnC;;OAEG;IACG,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IASnD;;;;;;OAMG;IACH,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM;IAKpD;;;;;;;OAOG;IACH,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM;IAYpE;;OAEG;IACH,SAAS,IAAI,MAAM;IAInB;;;;OAIG;IACG,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA6B9C;;OAEG;IACH,YAAY,IAAI,KAAK,GAAG,KAAK;IAI7B;;OAEG;IACH,mBAAmB,IAAI,MAAM,EAAE;IAI/B;;OAEG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAIvC;;;OAGG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAO3C;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAK5B;;OAEG;IACH,OAAO,CAAC,eAAe;IAIvB;;OAEG;IACH,OAAO,CAAC,WAAW;IAiBnB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAWzB;;OAEG;YACW,yBAAyB;IAmBvC;;OAEG;IACH,OAAO,CAAC,cAAc;IA4BtB;;;OAGG;IACH,OAAO,CAAC,WAAW;IAQnB;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAqBxB;;OAEG;IACH,OAAO,CAAC,mBAAmB;CAW3B"}

package/dist/services/I18nService.js

@@ -0,0 +1,276 @@
+/**
+ * I18nService
+ *
+ * Internationalization service with hybrid loading strategy.
+ * Manages translations, locale switching, and RTL/LTR direction.
+ *
+ * Features:
+ * - Subscriber/listener pattern for reactive updates
+ * - Hybrid loading: Bundle English, lazy-load other locales
+ * - Interpolation: {variable} syntax
+ * - Pluralization: ICU-style plural rules
+ * - RTL detection: Automatic based on locale
+ * - TypedEventBus integration: Emit locale change events
+ * - Fallback to English for missing keys
+ *
+ * Part of PIE Assessment Toolkit.
+ */
+import { createLogger } from "../utils/logger";
+const log = createLogger("I18nService");
+/**
+ * I18nService
+ *
+ * Manages internationalization with reactive state updates.
+ */
+export class I18nService {
+    locale = "en";
+    fallbackLocale = "en";
+    direction = "ltr";
+    translations = new Map();
+    listeners = new Set();
+    loadingPromises = new Map();
+    config;
+    constructor(config = {}) {
+        this.config = config;
+        this.fallbackLocale = config.fallbackLocale || "en";
+        log("I18nService initialized", { fallbackLocale: this.fallbackLocale });
+        // Load bundled translations (English by default)
+        if (config.bundledTranslations) {
+            for (const [locale, bundle] of Object.entries(config.bundledTranslations)) {
+                this.translations.set(locale, bundle);
+                log(`Loaded bundled translations for: ${locale}`);
+            }
+        }
+    }
+    /**
+     * Initialize i18n with locale and loading strategy
+     */
+    async initialize(config) {
+        Object.assign(this.config, config);
+        const locale = config.locale || this.detectBrowserLocale();
+        log(`Initializing with locale: ${locale}`);
+        await this.setLocale(locale);
+    }
+    /**
+     * Translate a key with optional interpolation
+     *
+     * @param key Translation key (e.g., 'common.save')
+     * @param params Optional parameters for interpolation
+     * @returns Translated string
+     */
+    t(key, params) {
+        const translation = this.getTranslation(key);
+        return this.interpolate(translation, params);
+    }
+    /**
+     * Translate with pluralization
+     *
+     * @param key Translation key
+     * @param count Count for pluralization
+     * @param params Optional parameters for interpolation
+     * @returns Translated string with plural form
+     */
+    tn(key, count, params) {
+        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, { ...params, count });
+    }
+    /**
+     * Get current locale
+     */
+    getLocale() {
+        return this.locale;
+    }
+    /**
+     * Change locale (triggers async loading if needed)
+     *
+     * @param locale Locale code (e.g., 'en', 'es', 'zh', 'ar')
+     */
+    async setLocale(locale) {
+        log(`Setting locale to: ${locale}`);
+        // Check if already loading
+        if (this.loadingPromises.has(locale)) {
+            log(`Locale ${locale} is already loading, waiting...`);
+            await this.loadingPromises.get(locale);
+            return;
+        }
+        // Check if already loaded
+        if (this.translations.has(locale)) {
+            log(`Locale ${locale} already loaded`);
+            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 text direction
+     */
+    getDirection() {
+        return this.direction;
+    }
+    /**
+     * Get available locales
+     */
+    getAvailableLocales() {
+        return Array.from(this.translations.keys());
+    }
+    /**
+     * Check if locale is loaded
+     */
+    isLocaleLoaded(locale) {
+        return this.translations.has(locale);
+    }
+    /**
+     * Subscribe to locale/translation changes
+     * Returns unsubscribe function
+     */
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => {
+            this.listeners.delete(listener);
+        };
+    }
+    /**
+     * Check if a translation key exists
+     */
+    hasKey(key) {
+        const bundle = this.translations.get(this.locale);
+        return !!bundle?.translations[key];
+    }
+    /**
+     * Notify all listeners of state change
+     */
+    notifyListeners() {
+        this.listeners.forEach((listener) => listener());
+    }
+    /**
+     * Apply locale and notify listeners
+     */
+    applyLocale(locale) {
+        const bundle = this.translations.get(locale);
+        if (!bundle) {
+            log(`No bundle found for locale: ${locale}`, "warn");
+            return;
+        }
+        const previousLocale = this.locale;
+        this.locale = locale;
+        this.direction = bundle.direction;
+        log(`Applied locale: ${locale} (direction: ${this.direction})`);
+        this.applyDOMDirection();
+        this.notifyListeners();
+    }
+    /**
+     * Apply direction to DOM
+     */
+    applyDOMDirection() {
+        if (typeof document === "undefined")
+            return;
+        document.documentElement.setAttribute("dir", this.direction);
+        document.documentElement.setAttribute("lang", this.locale);
+        log(`Applied DOM attributes: dir="${this.direction}" lang="${this.locale}"`);
+    }
+    /**
+     * Load translations for a locale
+     */
+    async loadTranslationsForLocale(locale) {
+        if (!this.config.loadTranslations) {
+            throw new Error(`No translation loader configured for locale: ${locale}`);
+        }
+        log(`Loading translations for: ${locale}`);
+        try {
+            const bundle = await this.config.loadTranslations(locale);
+            this.translations.set(locale, bundle);
+            log(`Loaded translations for: ${locale} (${Object.keys(bundle.translations).length} keys)`);
+        }
+        catch (error) {
+            log(`Failed to load translations for: ${locale}`, "error");
+            throw error;
+        }
+    }
+    /**
+     * Get translation for a key
+     */
+    getTranslation(key) {
+        // 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]) {
+            if (this.config.debug) {
+                log(`Using fallback translation for key: ${key}`);
+            }
+            return fallbackBundle.translations[key];
+        }
+        // Missing key handling
+        if (this.config.onMissingKey) {
+            this.config.onMissingKey(key, this.locale);
+        }
+        if (this.config.debug) {
+            log(`Missing translation key: ${key} (locale: ${this.locale})`, "warn");
+        }
+        return key;
+    }
+    /**
+     * Interpolate variables in translation string
+     * Replaces {variable} with params.variable
+     */
+    interpolate(text, params) {
+        if (!params)
+            return text;
+        return text.replace(/\{(\w+)\}/g, (match, key) => {
+            return params[key]?.toString() || match;
+        });
+    }
+    /**
+     * Select plural form based on count and locale
+     * Simplified implementation - real implementation would use Intl.PluralRules
+     */
+    selectPluralForm(count, locale) {
+        // 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;
+            }
+            catch (error) {
+                log(`Failed to use Intl.PluralRules for locale: ${locale}`, "warn");
+            }
+        }
+        // Fallback to simple rules
+        if (count === 0)
+            return "zero";
+        if (count === 1)
+            return "one";
+        return "other";
+    }
+    /**
+     * Detect browser locale
+     */
+    detectBrowserLocale() {
+        if (typeof navigator === "undefined")
+            return "en";
+        const browserLang = navigator.language ||
+            (navigator.languages && navigator.languages[0]) ||
+            "en";
+        // Extract language code (e.g., 'en-US' -> 'en')
+        return browserLang.split("-")[0];
+    }
+}
+//# sourceMappingURL=I18nService.js.map

package/dist/services/I18nService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"I18nService.js","sourceRoot":"","sources":["../../src/services/I18nService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAQH,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,MAAM,GAAG,GAAG,YAAY,CAAC,aAAa,CAAC,CAAC;AAKxC;;;;GAIG;AACH,MAAM,OAAO,WAAW;IACf,MAAM,GAAW,IAAI,CAAC;IACtB,cAAc,GAAW,IAAI,CAAC;IAC9B,SAAS,GAAkB,KAAK,CAAC;IACjC,YAAY,GAAG,IAAI,GAAG,EAA6B,CAAC;IACpD,SAAS,GAAG,IAAI,GAAG,EAAc,CAAC;IAClC,eAAe,GAAG,IAAI,GAAG,EAAyB,CAAC;IACnD,MAAM,CAAa;IAE3B,YAAY,SAAqB,EAAE;QAClC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC,cAAc,IAAI,IAAI,CAAC;QAEpD,GAAG,CAAC,yBAAyB,EAAE,EAAE,cAAc,EAAE,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC;QAExE,iDAAiD;QACjD,IAAI,MAAM,CAAC,mBAAmB,EAAE,CAAC;YAChC,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAC5C,MAAM,CAAC,mBAAmB,CAC1B,EAAE,CAAC;gBACH,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;gBACtC,GAAG,CAAC,oCAAoC,MAAM,EAAE,CAAC,CAAC;YACnD,CAAC;QACF,CAAC;IACF,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU,CAAC,MAAkB;QAClC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAEnC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAC3D,GAAG,CAAC,6BAA6B,MAAM,EAAE,CAAC,CAAC;QAE3C,MAAM,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;IAED;;;;;;OAMG;IACH,CAAC,CAAC,GAAW,EAAE,MAA4B;QAC1C,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;QAC7C,OAAO,IAAI,CAAC,WAAW,CAAC,WAAqB,EAAE,MAAM,CAAC,CAAC;IACxD,CAAC;IAED;;;;;;;OAOG;IACH,EAAE,CAAC,GAAW,EAAE,KAAa,EAAE,MAA4B;QAC1D,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;QAE7C,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE,CAAC;YACrC,MAAM,UAAU,GAAG,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;YAC7D,MAAM,IAAI,GAAG,WAAW,CAAC,UAAU,CAAC,IAAI,WAAW,CAAC,KAAK,CAAC;YAC1D,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;QACrD,CAAC;QAED,OAAO,IAAI,CAAC,WAAW,CAAC,WAAqB,EAAE,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IACtE,CAAC;IAED;;OAEG;IACH,SAAS;QACR,OAAO,IAAI,CAAC,MAAM,CAAC;IACpB,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,SAAS,CAAC,MAAc;QAC7B,GAAG,CAAC,sBAAsB,MAAM,EAAE,CAAC,CAAC;QAEpC,2BAA2B;QAC3B,IAAI,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YACtC,GAAG,CAAC,UAAU,MAAM,iCAAiC,CAAC,CAAC;YACvD,MAAM,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YACvC,OAAO;QACR,CAAC;QAED,0BAA0B;QAC1B,IAAI,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YACnC,GAAG,CAAC,UAAU,MAAM,iBAAiB,CAAC,CAAC;YACvC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;YACzB,OAAO;QACR,CAAC;QAED,oBAAoB;QACpB,MAAM,cAAc,GAAG,IAAI,CAAC,yBAAyB,CAAC,MAAM,CAAC,CAAC;QAC9D,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;QAEjD,IAAI,CAAC;YACJ,MAAM,cAAc,CAAC;YACrB,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAC1B,CAAC;gBAAS,CAAC;YACV,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACrC,CAAC;IACF,CAAC;IAED;;OAEG;IACH,YAAY;QACX,OAAO,IAAI,CAAC,SAAS,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,mBAAmB;QAClB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED;;OAEG;IACH,cAAc,CAAC,MAAc;QAC5B,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACtC,CAAC;IAED;;;OAGG;IACH,SAAS,CAAC,QAAoB;QAC7B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC7B,OAAO,GAAG,EAAE;YACX,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACjC,CAAC,CAAC;IACH,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,GAAW;QACjB,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAClD,OAAO,CAAC,CAAC,MAAM,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC;IACpC,CAAC;IAED;;OAEG;IACK,eAAe;QACtB,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC;IAClD,CAAC;IAED;;OAEG;IACK,WAAW,CAAC,MAAc;QACjC,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC7C,IAAI,CAAC,MAAM,EAAE,CAAC;YACb,GAAG,CAAC,+BAA+B,MAAM,EAAE,EAAE,MAAM,CAAC,CAAC;YACrD,OAAO;QACR,CAAC;QAED,MAAM,cAAc,GAAG,IAAI,CAAC,MAAM,CAAC;QACnC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;QAElC,GAAG,CAAC,mBAAmB,MAAM,gBAAgB,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC;QAEhE,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACzB,IAAI,CAAC,eAAe,EAAE,CAAC;IACxB,CAAC;IAED;;OAEG;IACK,iBAAiB;QACxB,IAAI,OAAO,QAAQ,KAAK,WAAW;YAAE,OAAO;QAE5C,QAAQ,CAAC,eAAe,CAAC,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QAC7D,QAAQ,CAAC,eAAe,CAAC,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAE3D,GAAG,CACF,gCAAgC,IAAI,CAAC,SAAS,WAAW,IAAI,CAAC,MAAM,GAAG,CACvE,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,yBAAyB,CAAC,MAAc;QACrD,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CAAC,gDAAgD,MAAM,EAAE,CAAC,CAAC;QAC3E,CAAC;QAED,GAAG,CAAC,6BAA6B,MAAM,EAAE,CAAC,CAAC;QAE3C,IAAI,CAAC;YACJ,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;YAC1D,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YACtC,GAAG,CACF,4BAA4B,MAAM,KAAK,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,MAAM,QAAQ,CACtF,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,GAAG,CAAC,oCAAoC,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC;YAC3D,MAAM,KAAK,CAAC;QACb,CAAC;IACF,CAAC;IAED;;OAEG;IACK,cAAc,CAAC,GAAW;QACjC,qBAAqB;QACrB,MAAM,aAAa,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACzD,IAAI,aAAa,EAAE,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC;YACtC,OAAO,aAAa,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;QACxC,CAAC;QAED,sBAAsB;QACtB,MAAM,cAAc,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAClE,IAAI,cAAc,EAAE,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC;YACvC,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;gBACvB,GAAG,CAAC,uCAAuC,GAAG,EAAE,CAAC,CAAC;YACnD,CAAC;YACD,OAAO,cAAc,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;QACzC,CAAC;QAED,uBAAuB;QACvB,IAAI,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;YAC9B,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAC5C,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YACvB,GAAG,CAAC,4BAA4B,GAAG,aAAa,IAAI,CAAC,MAAM,GAAG,EAAE,MAAM,CAAC,CAAC;QACzE,CAAC;QAED,OAAO,GAAG,CAAC;IACZ,CAAC;IAED;;;OAGG;IACK,WAAW,CAAC,IAAY,EAAE,MAA4B;QAC7D,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QAEzB,OAAO,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;YAChD,OAAO,MAAM,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,IAAI,KAAK,CAAC;QACzC,CAAC,CAAC,CAAC;IACJ,CAAC;IAED;;;OAGG;IACK,gBAAgB,CACvB,KAAa,EACb,MAAc;QAEd,oCAAoC;QACpC,IAAI,OAAO,IAAI,KAAK,WAAW,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrD,IAAI,CAAC;gBACJ,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;gBAC3C,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACrC,OAAO,QAAmC,CAAC;YAC5C,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBAChB,GAAG,CAAC,8CAA8C,MAAM,EAAE,EAAE,MAAM,CAAC,CAAC;YACrE,CAAC;QACF,CAAC;QAED,2BAA2B;QAC3B,IAAI,KAAK,KAAK,CAAC;YAAE,OAAO,MAAM,CAAC;QAC/B,IAAI,KAAK,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QAC9B,OAAO,OAAO,CAAC;IAChB,CAAC;IAED;;OAEG;IACK,mBAAmB;QAC1B,IAAI,OAAO,SAAS,KAAK,WAAW;YAAE,OAAO,IAAI,CAAC;QAElD,MAAM,WAAW,GAChB,SAAS,CAAC,QAAQ;YAClB,CAAC,SAAS,CAAC,SAAS,IAAI,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;YAC/C,IAAI,CAAC;QAEN,gDAAgD;QAChD,OAAO,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAClC,CAAC;CACD"}

package/dist/services/PNPMapper.d.ts

@@ -0,0 +1,71 @@
+/**
+ * PNP Mapper - Maps QTI 3.0 PNP support IDs to PIE tool identifiers
+ *
+ * Provides bidirectional mapping between QTI 3.0 Personal Needs Profile (PNP)
+ * support identifiers and PIE tool IDs. Supports custom extensions via registration.
+ *
+ * Part of PIE Assessment Toolkit.
+ */
+/**
+ * Standard QTI 3.0 PNP support → PIE tool ID mapping
+ *
+ * Maps industry-standard PNP support identifiers to corresponding PIE tools.
+ * Based on IMS Global QTI 3.0 specification.
+ */
+export declare const PNP_TO_PIE_TOOL_MAP: Record<string, string>;
+/**
+ * Reverse mapping for debugging/export (PIE tool ID → PNP support ID)
+ */
+export declare const PIE_TOOL_TO_PNP_MAP: Record<string, string>;
+/**
+ * Map PNP support ID to PIE tool ID
+ *
+ * @param supportId QTI 3.0 PNP support identifier
+ * @returns PIE tool ID or null if no mapping exists
+ *
+ * @example
+ * mapPNPSupportToToolId('textToSpeech') // Returns: 'pie-tool-text-to-speech'
+ * mapPNPSupportToToolId('calculator')   // Returns: 'pie-tool-calculator'
+ * mapPNPSupportToToolId('unknown')      // Returns: null
+ */
+export declare function mapPNPSupportToToolId(supportId: string): string | null;
+/**
+ * Map PIE tool ID back to PNP support ID
+ *
+ * Useful for exporting or debugging tool configurations.
+ *
+ * @param toolId PIE tool identifier
+ * @returns QTI 3.0 PNP support ID or null if no mapping exists
+ *
+ * @example
+ * mapToolIdToPNPSupport('pie-tool-text-to-speech') // Returns: 'textToSpeech'
+ */
+export declare function mapToolIdToPNPSupport(toolId: string): string | null;
+/**
+ * Register custom PNP support mapping
+ *
+ * Allows products to extend the standard PNP vocabulary with custom tools.
+ * Custom supports should use 'x-' prefix per IMS convention.
+ *
+ * @param supportId PNP support identifier (e.g., 'x-pie-periodic-table')
+ * @param toolId PIE tool identifier (e.g., 'pie-tool-periodic-table')
+ *
+ * @example
+ * registerCustomPNPMapping('x-pie-periodic-table', 'pie-tool-periodic-table');
+ * registerCustomPNPMapping('x-pie-graph', 'pie-tool-graphing');
+ */
+export declare function registerCustomPNPMapping(supportId: string, toolId: string): void;
+/**
+ * Get all registered PNP support IDs
+ *
+ * @returns Array of all PNP support identifiers (standard + custom)
+ */
+export declare function getAllPNPSupports(): string[];
+/**
+ * Check if a PNP support is registered
+ *
+ * @param supportId PNP support identifier to check
+ * @returns true if mapping exists
+ */
+export declare function isPNPSupportRegistered(supportId: string): boolean;
+//# sourceMappingURL=PNPMapper.d.ts.map

package/dist/services/PNPMapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PNPMapper.d.ts","sourceRoot":"","sources":["../../src/services/PNPMapper.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAiBtD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAEtD,CAAC;AAEF;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAEtE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAEnE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,wBAAwB,CACvC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACZ,IAAI,CAGN;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,EAAE,CAE5C;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAEjE"}

package/dist/services/PNPMapper.js

@@ -0,0 +1,98 @@
+/**
+ * PNP Mapper - Maps QTI 3.0 PNP support IDs to PIE tool identifiers
+ *
+ * Provides bidirectional mapping between QTI 3.0 Personal Needs Profile (PNP)
+ * support identifiers and PIE tool IDs. Supports custom extensions via registration.
+ *
+ * Part of PIE Assessment Toolkit.
+ */
+/**
+ * Standard QTI 3.0 PNP support → PIE tool ID mapping
+ *
+ * Maps industry-standard PNP support identifiers to corresponding PIE tools.
+ * Based on IMS Global QTI 3.0 specification.
+ */
+export const PNP_TO_PIE_TOOL_MAP = {
+    // Standard QTI 3.0 PNP supports
+    textToSpeech: "pie-tool-text-to-speech",
+    calculator: "pie-tool-calculator",
+    ruler: "pie-tool-ruler",
+    protractor: "pie-tool-protractor",
+    highlighter: "pie-tool-annotation-toolbar",
+    lineReader: "pie-tool-line-reader",
+    magnifier: "pie-tool-magnifier",
+    colorContrast: "pie-theme-contrast",
+    answerMasking: "pie-tool-answer-eliminator",
+    dictionaryLookup: "pie-tool-dictionary",
+    // Common extensions (not in QTI standard but widely used)
+    graphingCalculator: "pie-tool-calculator",
+    scientificCalculator: "pie-tool-calculator",
+    basicCalculator: "pie-tool-calculator",
+};
+/**
+ * Reverse mapping for debugging/export (PIE tool ID → PNP support ID)
+ */
+export const PIE_TOOL_TO_PNP_MAP = Object.fromEntries(Object.entries(PNP_TO_PIE_TOOL_MAP).map(([pnp, tool]) => [tool, pnp]));
+/**
+ * Map PNP support ID to PIE tool ID
+ *
+ * @param supportId QTI 3.0 PNP support identifier
+ * @returns PIE tool ID or null if no mapping exists
+ *
+ * @example
+ * mapPNPSupportToToolId('textToSpeech') // Returns: 'pie-tool-text-to-speech'
+ * mapPNPSupportToToolId('calculator')   // Returns: 'pie-tool-calculator'
+ * mapPNPSupportToToolId('unknown')      // Returns: null
+ */
+export function mapPNPSupportToToolId(supportId) {
+    return PNP_TO_PIE_TOOL_MAP[supportId] || null;
+}
+/**
+ * Map PIE tool ID back to PNP support ID
+ *
+ * Useful for exporting or debugging tool configurations.
+ *
+ * @param toolId PIE tool identifier
+ * @returns QTI 3.0 PNP support ID or null if no mapping exists
+ *
+ * @example
+ * mapToolIdToPNPSupport('pie-tool-text-to-speech') // Returns: 'textToSpeech'
+ */
+export function mapToolIdToPNPSupport(toolId) {
+    return PIE_TOOL_TO_PNP_MAP[toolId] || null;
+}
+/**
+ * Register custom PNP support mapping
+ *
+ * Allows products to extend the standard PNP vocabulary with custom tools.
+ * Custom supports should use 'x-' prefix per IMS convention.
+ *
+ * @param supportId PNP support identifier (e.g., 'x-pie-periodic-table')
+ * @param toolId PIE tool identifier (e.g., 'pie-tool-periodic-table')
+ *
+ * @example
+ * registerCustomPNPMapping('x-pie-periodic-table', 'pie-tool-periodic-table');
+ * registerCustomPNPMapping('x-pie-graph', 'pie-tool-graphing');
+ */
+export function registerCustomPNPMapping(supportId, toolId) {
+    PNP_TO_PIE_TOOL_MAP[supportId] = toolId;
+    PIE_TOOL_TO_PNP_MAP[toolId] = supportId;
+}
+/**
+ * Get all registered PNP support IDs
+ *
+ * @returns Array of all PNP support identifiers (standard + custom)
+ */
+export function getAllPNPSupports() {
+    return Object.keys(PNP_TO_PIE_TOOL_MAP);
+}
+/**
+ * Check if a PNP support is registered
+ *
+ * @param supportId PNP support identifier to check
+ * @returns true if mapping exists
+ */
+export function isPNPSupportRegistered(supportId) {
+    return supportId in PNP_TO_PIE_TOOL_MAP;
+}
+//# sourceMappingURL=PNPMapper.js.map

package/dist/services/PNPMapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PNPMapper.js","sourceRoot":"","sources":["../../src/services/PNPMapper.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAA2B;IAC1D,gCAAgC;IAChC,YAAY,EAAE,yBAAyB;IACvC,UAAU,EAAE,qBAAqB;IACjC,KAAK,EAAE,gBAAgB;IACvB,UAAU,EAAE,qBAAqB;IACjC,WAAW,EAAE,6BAA6B;IAC1C,UAAU,EAAE,sBAAsB;IAClC,SAAS,EAAE,oBAAoB;IAC/B,aAAa,EAAE,oBAAoB;IACnC,aAAa,EAAE,4BAA4B;IAC3C,gBAAgB,EAAE,qBAAqB;IAEvC,0DAA0D;IAC1D,kBAAkB,EAAE,qBAAqB;IACzC,oBAAoB,EAAE,qBAAqB;IAC3C,eAAe,EAAE,qBAAqB;CACtC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAA2B,MAAM,CAAC,WAAW,CAC5E,MAAM,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CACrE,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,UAAU,qBAAqB,CAAC,SAAiB;IACtD,OAAO,mBAAmB,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC;AAC/C,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAc;IACnD,OAAO,mBAAmB,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC;AAC5C,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,wBAAwB,CACvC,SAAiB,EACjB,MAAc;IAEd,mBAAmB,CAAC,SAAS,CAAC,GAAG,MAAM,CAAC;IACxC,mBAAmB,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;AACzC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB;IAChC,OAAO,MAAM,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;AACzC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,SAAiB;IACvD,OAAO,SAAS,IAAI,mBAAmB,CAAC;AACzC,CAAC"}