@pie-players/pie-players-shared 0.2.0

package/dist/i18n/translations/zh/tools.json

@@ -0,0 +1,109 @@
+{
+    "tool": {
+        "calculator": "计算器",
+        "calculator_aria": "打开计算器",
+        "graph": "图表",
+        "graph_aria": "打开图表工具",
+        "periodic_table": "元素周期表",
+        "periodic_table_aria": "打开元素周期表",
+        "protractor": "量角器",
+        "protractor_aria": "打开量角器",
+        "ruler": "尺子",
+        "ruler_aria": "打开尺子",
+        "line_reader": "行阅读器",
+        "line_reader_aria": "打开行阅读器",
+        "magnifier": "文本放大镜",
+        "magnifier_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": "图形",
+        "ti_84": "TI-84 Plus CE",
+        "ti_108": "TI-108 小学",
+        "ti_34": "TI-34 MultiView",
+        "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": "朗读选择",
+        "dictionary": "字典查询",
+        "translation": "翻译请求",
+        "clear": "清除高亮"
+    },
+    "ruler": {
+        "switched_to": "已切换到 {unit}"
+    }
+}

package/dist/i18n/types.d.ts

@@ -0,0 +1,58 @@
+/**
+ * I18n Type Definitions
+ *
+ * Shared types for internationalization system.
+ * Defined in players-shared to avoid circular dependencies.
+ */
+/**
+ * Plural translation forms
+ * Follows ICU MessageFormat plural rules
+ */
+export interface PluralTranslation {
+    zero?: string;
+    one: string;
+    few?: string;
+    many?: string;
+    other: string;
+}
+/**
+ * Translation bundle structure
+ */
+export interface TranslationBundle {
+    locale: string;
+    translations: Record<string, string | PluralTranslation>;
+    direction: "ltr" | "rtl";
+}
+/**
+ * I18n configuration
+ */
+export interface I18nConfig {
+    /** Initial locale (default: browser language) */
+    locale?: string;
+    /** Fallback locale (default: 'en') */
+    fallbackLocale?: string;
+    /** Translation loader function */
+    loadTranslations?: (locale: string) => Promise<TranslationBundle>;
+    /** Bundled translations (for hybrid loading) */
+    bundledTranslations?: Record<string, TranslationBundle>;
+    /** Missing key handler */
+    onMissingKey?: (key: string, locale: string) => void;
+    /** Debug mode */
+    debug?: boolean;
+}
+/**
+ * I18nService interface
+ */
+export interface II18nService {
+    initialize(config: I18nConfig): Promise<void>;
+    t(key: string, params?: Record<string, any>): string;
+    tn(key: string, count: number, params?: Record<string, any>): string;
+    getLocale(): string;
+    setLocale(locale: string): Promise<void>;
+    getDirection(): "ltr" | "rtl";
+    getAvailableLocales(): string[];
+    isLocaleLoaded(locale: string): boolean;
+    subscribe(listener: () => void): () => void;
+    hasKey(key: string): boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/i18n/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/i18n/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB,CAAC,CAAC;IACzD,SAAS,EAAE,KAAK,GAAG,KAAK,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IAC1B,iDAAiD;IACjD,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,sCAAsC;IACtC,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,kCAAkC;IAClC,gBAAgB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAElE,gDAAgD;IAChD,mBAAmB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAExD,0BAA0B;IAC1B,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAErD,iBAAiB;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC5B,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC;IACrD,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC;IACrE,SAAS,IAAI,MAAM,CAAC;IACpB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,YAAY,IAAI,KAAK,GAAG,KAAK,CAAC;IAC9B,mBAAmB,IAAI,MAAM,EAAE,CAAC;IAChC,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;IACxC,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IAC5C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CAC7B"}

package/dist/i18n/types.js

@@ -0,0 +1,8 @@
+/**
+ * I18n Type Definitions
+ *
+ * Shared types for internationalization system.
+ * Defined in players-shared to avoid circular dependencies.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/i18n/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/i18n/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/i18n/use-i18n-standalone.svelte.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Standalone i18n Composable
+ *
+ * Lightweight i18n for standalone components that don't use the service architecture.
+ * Creates its own internal I18nService instance with hybrid loading.
+ *
+ * Use this when:
+ * - Building standalone components (tools, players) without full toolkit integration
+ * - You want simple i18n without dependency injection
+ *
+ * Use `useI18n()` when:
+ * - Working within the full assessment toolkit architecture
+ * - You need centralized locale management across the application
+ *
+ * @example
+ * ```svelte
+ * <script lang="ts">
+ *   import { useI18nStandalone } from '@pie-players/pie-players-shared/i18n';
+ *
+ *   const i18n = useI18nStandalone({ locale: 'en' });
+ * </script>
+ *
+ * <button>{i18n.t('common.save')}</button>
+ * <span dir={i18n.direction}>{i18n.tn('assessment.questions', 10)}</span>
+ * ```
+ */
+import { SimpleI18n } from "./simple-i18n";
+/**
+ * Standalone i18n configuration
+ */
+export interface UseI18nStandaloneConfig {
+    /** Initial locale (default: browser language) */
+    locale?: string;
+    /** Fallback locale (default: 'en') */
+    fallbackLocale?: string;
+    /** Debug mode */
+    debug?: boolean;
+}
+/**
+ * Create a standalone i18n instance
+ *
+ * @param config Configuration options
+ * @returns Reactive i18n interface
+ */
+export declare function useI18nStandalone(config?: UseI18nStandaloneConfig): {
+    /**
+     * Current locale (reactive)
+     */
+    readonly locale: string;
+    /**
+     * Current text direction (reactive)
+     */
+    readonly direction: "ltr" | "rtl";
+    /**
+     * Loading state (reactive)
+     */
+    readonly isLoading: boolean;
+    /**
+     * Translate function
+     */
+    t: (key: string, params?: Record<string, any>) => string;
+    /**
+     * Translate with pluralization
+     */
+    tn: (key: string, count: number, params?: Record<string, any>) => string;
+    /**
+     * Change locale
+     */
+    setLocale: (newLocale: string) => Promise<void>;
+    /**
+     * Get available locales
+     */
+    readonly availableLocales: string[];
+    /**
+     * Check if locale is loaded
+     */
+    isLocaleLoaded(loc: string): boolean;
+    /**
+     * Check if translation key exists
+     */
+    hasKey(key: string): boolean;
+    /**
+     * Access underlying service (for advanced use cases)
+     */
+    readonly service: SimpleI18n;
+};
+//# sourceMappingURL=use-i18n-standalone.svelte.d.ts.map

package/dist/i18n/use-i18n-standalone.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-i18n-standalone.svelte.d.ts","sourceRoot":"","sources":["../../src/i18n/use-i18n-standalone.svelte.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACvC,iDAAiD;IACjD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iBAAiB;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,GAAE,uBAA4B;IAuEpE;;OAEG;;IAKH;;OAEG;;IAKH;;OAEG;;IAKH;;OAEG;aAnDY,MAAM,WAAW,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAG,MAAM;IAsD5D;;OAEG;cAhDE,MAAM,SACJ,MAAM,WACJ,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAC1B,MAAM;IAgDR;;OAEG;2BA3CgC,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;IA8CzD;;OAEG;;IAKH;;OAEG;wBACiB,MAAM,GAAG,OAAO;IAIpC;;OAEG;gBACS,MAAM,GAAG,OAAO;IAI5B;;OAEG;;EAKJ"}

package/dist/i18n/use-i18n-standalone.svelte.js

@@ -0,0 +1,151 @@
+/**
+ * Standalone i18n Composable
+ *
+ * Lightweight i18n for standalone components that don't use the service architecture.
+ * Creates its own internal I18nService instance with hybrid loading.
+ *
+ * Use this when:
+ * - Building standalone components (tools, players) without full toolkit integration
+ * - You want simple i18n without dependency injection
+ *
+ * Use `useI18n()` when:
+ * - Working within the full assessment toolkit architecture
+ * - You need centralized locale management across the application
+ *
+ * @example
+ * ```svelte
+ * <script lang="ts">
+ *   import { useI18nStandalone } from '@pie-players/pie-players-shared/i18n';
+ *
+ *   const i18n = useI18nStandalone({ locale: 'en' });
+ * </script>
+ *
+ * <button>{i18n.t('common.save')}</button>
+ * <span dir={i18n.direction}>{i18n.tn('assessment.questions', 10)}</span>
+ * ```
+ */
+import { BUNDLED_TRANSLATIONS, loadTranslations } from "./loader";
+import { SimpleI18n } from "./simple-i18n";
+/**
+ * Create a standalone i18n instance
+ *
+ * @param config Configuration options
+ * @returns Reactive i18n interface
+ */
+export function useI18nStandalone(config = {}) {
+    let locale = $state(config.locale || "en");
+    let direction = $state("ltr");
+    let isLoading = $state(false);
+    // Create internal service instance
+    const service = new SimpleI18n({
+        locale: config.locale,
+        fallbackLocale: config.fallbackLocale || "en",
+        bundledTranslations: BUNDLED_TRANSLATIONS,
+        loadTranslations,
+        debug: config.debug,
+    });
+    // Initialize service
+    $effect(() => {
+        service
+            .initialize({
+            locale: config.locale,
+            fallbackLocale: config.fallbackLocale || "en",
+            bundledTranslations: BUNDLED_TRANSLATIONS,
+            loadTranslations,
+            debug: config.debug,
+        })
+            .then(() => {
+            locale = service.getLocale();
+            direction = service.getDirection();
+        });
+    });
+    // Subscribe to service changes
+    $effect(() => {
+        const unsubscribe = service.subscribe(() => {
+            locale = service.getLocale();
+            direction = service.getDirection();
+        });
+        return unsubscribe;
+    });
+    /**
+     * Translate a key with optional interpolation
+     */
+    function t(key, params) {
+        return service.t(key, params);
+    }
+    /**
+     * Translate with pluralization
+     */
+    function tn(key, count, params) {
+        return service.tn(key, count, params);
+    }
+    /**
+     * Change locale (async)
+     */
+    async function setLocale(newLocale) {
+        isLoading = true;
+        try {
+            await service.setLocale(newLocale);
+        }
+        finally {
+            isLoading = false;
+        }
+    }
+    return {
+        /**
+         * Current locale (reactive)
+         */
+        get locale() {
+            return locale;
+        },
+        /**
+         * Current text direction (reactive)
+         */
+        get direction() {
+            return direction;
+        },
+        /**
+         * Loading state (reactive)
+         */
+        get isLoading() {
+            return isLoading;
+        },
+        /**
+         * Translate function
+         */
+        t,
+        /**
+         * Translate with pluralization
+         */
+        tn,
+        /**
+         * Change locale
+         */
+        setLocale,
+        /**
+         * Get available locales
+         */
+        get availableLocales() {
+            return service.getAvailableLocales();
+        },
+        /**
+         * Check if locale is loaded
+         */
+        isLocaleLoaded(loc) {
+            return service.isLocaleLoaded(loc);
+        },
+        /**
+         * Check if translation key exists
+         */
+        hasKey(key) {
+            return service.hasKey(key);
+        },
+        /**
+         * Access underlying service (for advanced use cases)
+         */
+        get service() {
+            return service;
+        },
+    };
+}
+//# sourceMappingURL=use-i18n-standalone.svelte.js.map

package/dist/i18n/use-i18n-standalone.svelte.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-i18n-standalone.svelte.js","sourceRoot":"","sources":["../../src/i18n/use-i18n-standalone.svelte.ts"],"names":[],"mappings":"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"}

package/dist/i18n/use-i18n.svelte.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Svelte 5 Composable for i18n
+ *
+ * Provides reactive translation functions and locale state.
+ * Uses Svelte 5 runes for reactivity.
+ *
+ * Usage in a Svelte 5 component:
+ * ```svelte
+ * <script lang="ts">
+ *   import { useI18n } from '@pie-players/pie-players-shared/i18n';
+ *
+ *   let { player } = $props();
+ *   const i18n = useI18n(() => player.getI18nService());
+ * </script>
+ *
+ * <button>{i18n.t('common.save')}</button>
+ * <span dir={i18n.direction}>
+ *   {i18n.tn('assessment.questions', totalQuestions)}
+ * </span>
+ * ```
+ */
+import type { II18nService } from "./types";
+/**
+ * Svelte 5 composable for internationalization
+ *
+ * @param getService - Function that returns the I18nService instance (reactive)
+ * @returns Object with reactive locale, direction, and translation functions
+ */
+export declare function useI18n(getService: () => II18nService | undefined): {
+    /**
+     * Current locale (reactive)
+     */
+    readonly locale: string;
+    /**
+     * Current text direction (reactive)
+     */
+    readonly direction: "ltr" | "rtl";
+    /**
+     * Loading state (reactive)
+     */
+    readonly isLoading: boolean;
+    /**
+     * Translate function
+     */
+    t: (key: string, params?: Record<string, any>) => string;
+    /**
+     * Translate with pluralization
+     */
+    tn: (key: string, count: number, params?: Record<string, any>) => string;
+    /**
+     * Change locale
+     */
+    setLocale: (newLocale: string) => Promise<void>;
+    /**
+     * Get available locales
+     */
+    readonly availableLocales: string[];
+    /**
+     * Check if locale is loaded
+     */
+    isLocaleLoaded(loc: string): boolean;
+    /**
+     * Check if translation key exists
+     */
+    hasKey(key: string): boolean;
+};
+//# sourceMappingURL=use-i18n.svelte.d.ts.map

package/dist/i18n/use-i18n.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-i18n.svelte.d.ts","sourceRoot":"","sources":["../../src/i18n/use-i18n.svelte.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,UAAU,EAAE,MAAM,YAAY,GAAG,SAAS;IA2EhE;;OAEG;;IAKH;;OAEG;;IAKH;;OAEG;;IAKH;;OAEG;aA/DY,MAAM,WAAW,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAG,MAAM;IAkE5D;;OAEG;cAtDE,MAAM,SACJ,MAAM,WACJ,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAC1B,MAAM;IAsDR;;OAEG;2BA9CgC,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;IAiDzD;;OAEG;;IAKH;;OAEG;wBACiB,MAAM,GAAG,OAAO;IAIpC;;OAEG;gBACS,MAAM,GAAG,OAAO;EAI7B"}

package/dist/i18n/use-i18n.svelte.js

@@ -0,0 +1,144 @@
+/**
+ * Svelte 5 Composable for i18n
+ *
+ * Provides reactive translation functions and locale state.
+ * Uses Svelte 5 runes for reactivity.
+ *
+ * Usage in a Svelte 5 component:
+ * ```svelte
+ * <script lang="ts">
+ *   import { useI18n } from '@pie-players/pie-players-shared/i18n';
+ *
+ *   let { player } = $props();
+ *   const i18n = useI18n(() => player.getI18nService());
+ * </script>
+ *
+ * <button>{i18n.t('common.save')}</button>
+ * <span dir={i18n.direction}>
+ *   {i18n.tn('assessment.questions', totalQuestions)}
+ * </span>
+ * ```
+ */
+/**
+ * Svelte 5 composable for internationalization
+ *
+ * @param getService - Function that returns the I18nService instance (reactive)
+ * @returns Object with reactive locale, direction, and translation functions
+ */
+export function useI18n(getService) {
+    let locale = $state("en");
+    let direction = $state("ltr");
+    let isLoading = $state(false);
+    // Get service instance reactively
+    const service = $derived(getService());
+    // Subscribe to service changes
+    $effect(() => {
+        if (service) {
+            // Initialize state from service
+            locale = service.getLocale();
+            direction = service.getDirection();
+            // Subscribe to changes
+            const unsubscribe = service.subscribe(() => {
+                locale = service.getLocale();
+                direction = service.getDirection();
+            });
+            // Cleanup subscription
+            return unsubscribe;
+        }
+        // Return no-op cleanup if service is undefined
+        return () => { };
+    });
+    /**
+     * Translate a key with optional interpolation
+     *
+     * @param key Translation key (e.g., 'common.save')
+     * @param params Optional parameters for interpolation
+     * @returns Translated string
+     */
+    function t(key, params) {
+        if (!service)
+            return key;
+        return service.t(key, 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
+     */
+    function tn(key, count, params) {
+        if (!service)
+            return key;
+        return service.tn(key, count, params);
+    }
+    /**
+     * Change locale (async)
+     *
+     * @param newLocale Locale code (e.g., 'en', 'es', 'zh', 'ar')
+     */
+    async function setLocale(newLocale) {
+        if (!service)
+            return;
+        isLoading = true;
+        try {
+            await service.setLocale(newLocale);
+        }
+        finally {
+            isLoading = false;
+        }
+    }
+    // Return reactive getters and functions
+    return {
+        /**
+         * Current locale (reactive)
+         */
+        get locale() {
+            return locale;
+        },
+        /**
+         * Current text direction (reactive)
+         */
+        get direction() {
+            return direction;
+        },
+        /**
+         * Loading state (reactive)
+         */
+        get isLoading() {
+            return isLoading;
+        },
+        /**
+         * Translate function
+         */
+        t,
+        /**
+         * Translate with pluralization
+         */
+        tn,
+        /**
+         * Change locale
+         */
+        setLocale,
+        /**
+         * Get available locales
+         */
+        get availableLocales() {
+            return service?.getAvailableLocales() || [];
+        },
+        /**
+         * Check if locale is loaded
+         */
+        isLocaleLoaded(loc) {
+            return service?.isLocaleLoaded(loc) || false;
+        },
+        /**
+         * Check if translation key exists
+         */
+        hasKey(key) {
+            return service?.hasKey(key) || false;
+        },
+    };
+}
+//# sourceMappingURL=use-i18n.svelte.js.map

package/dist/i18n/use-i18n.svelte.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-i18n.svelte.js","sourceRoot":"","sources":["../../src/i18n/use-i18n.svelte.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAIH;;;;;GAKG;AACH,MAAM,UAAU,OAAO,CAAC,UAA0C;IACjE,IAAI,MAAM,GAAG,MAAM,CAAS,IAAI,CAAC,CAAC;IAClC,IAAI,SAAS,GAAG,MAAM,CAAgB,KAAK,CAAC,CAAC;IAC7C,IAAI,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAE9B,kCAAkC;IAClC,MAAM,OAAO,GAAG,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;IAEvC,+BAA+B;IAC/B,OAAO,CAAC,GAAG,EAAE;QACZ,IAAI,OAAO,EAAE,CAAC;YACb,gCAAgC;YAChC,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;YAC7B,SAAS,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;YAEnC,uBAAuB;YACvB,MAAM,WAAW,GAAG,OAAO,CAAC,SAAS,CAAC,GAAG,EAAE;gBAC1C,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;gBAC7B,SAAS,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;YACpC,CAAC,CAAC,CAAC;YAEH,uBAAuB;YACvB,OAAO,WAAW,CAAC;QACpB,CAAC;QACD,+CAA+C;QAC/C,OAAO,GAAG,EAAE,GAAE,CAAC,CAAC;IACjB,CAAC,CAAC,CAAC;IAEH;;;;;;OAMG;IACH,SAAS,CAAC,CAAC,GAAW,EAAE,MAA4B;QACnD,IAAI,CAAC,OAAO;YAAE,OAAO,GAAG,CAAC;QACzB,OAAO,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC/B,CAAC;IAED;;;;;;;OAOG;IACH,SAAS,EAAE,CACV,GAAW,EACX,KAAa,EACb,MAA4B;QAE5B,IAAI,CAAC,OAAO;YAAE,OAAO,GAAG,CAAC;QACzB,OAAO,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IACvC,CAAC;IAED;;;;OAIG;IACH,KAAK,UAAU,SAAS,CAAC,SAAiB;QACzC,IAAI,CAAC,OAAO;YAAE,OAAO;QAErB,SAAS,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC;YACJ,MAAM,OAAO,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QACpC,CAAC;gBAAS,CAAC;YACV,SAAS,GAAG,KAAK,CAAC;QACnB,CAAC;IACF,CAAC;IAED,wCAAwC;IACxC,OAAO;QACN;;WAEG;QACH,IAAI,MAAM;YACT,OAAO,MAAM,CAAC;QACf,CAAC;QAED;;WAEG;QACH,IAAI,SAAS;YACZ,OAAO,SAAS,CAAC;QAClB,CAAC;QAED;;WAEG;QACH,IAAI,SAAS;YACZ,OAAO,SAAS,CAAC;QAClB,CAAC;QAED;;WAEG;QACH,CAAC;QAED;;WAEG;QACH,EAAE;QAEF;;WAEG;QACH,SAAS;QAET;;WAEG;QACH,IAAI,gBAAgB;YACnB,OAAO,OAAO,EAAE,mBAAmB,EAAE,IAAI,EAAE,CAAC;QAC7C,CAAC;QAED;;WAEG;QACH,cAAc,CAAC,GAAW;YACzB,OAAO,OAAO,EAAE,cAAc,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC;QAC9C,CAAC;QAED;;WAEG;QACH,MAAM,CAAC,GAAW;YACjB,OAAO,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC;QACtC,CAAC;KACD,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export * from "./config/profile";
+export * from "./instrumentation";
+export * from "./loader-config";
+export * from "./loaders";
+export * from "./object";
+export * from "./pie";
+export type { AssessmentAuthoringCallbacks, AssessmentEntity, AssessmentItemRef, AssessmentMode, AssessmentSection, ConfigEntity, Env, ItemConfig, ItemEntity, OutcomeResponse, PassageEntity, PieController, PieModel, QtiAssessmentSection, QuestionEntity, RubricBlock, SectionQuestionRef, TestPart, } from "./types";
+export { editorPostFix } from "./types";
+export * from "./ui/focus-trap";
+export * from "./ui/safe-storage";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AAEzB,cAAc,OAAO,CAAC;AACtB,YAAY,EACX,4BAA4B,EAC5B,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,YAAY,EACZ,GAAG,EACH,UAAU,EACV,UAAU,EACV,eAAe,EACf,aAAa,EACb,aAAa,EACb,QAAQ,EACR,oBAAoB,EACpB,cAAc,EACd,WAAW,EACX,kBAAkB,EAClB,QAAQ,GACR,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC"}