@sveltekit-i18n/base 3.0.0-next.0 → 3.0.0-next.1

package/dist/I18n.svelte.d.ts

@@ -15,18 +15,15 @@ declare class I18nCore<ParserParams extends Parser.Params = any, ParserOutput =
     locales: Config.LocaleInput<LocaleUnion>[];
     initialized: boolean;
     /**
-     * Translates `key` for the active locale. Reactive wherever reads are
-     * tracked: the call reads the translation table and locale, so a component
-     * using `{i18n.t('key')}` re-renders when either changes.
+     * Translates `key` for the active locale. Reactive on two levels: the
+     * returned function reads the tables at CALL time, so a destructured `t`
+     * keeps translating against live state, and its identity is refreshed
+     * whenever the config, the tables or the locale change, so merely holding
+     * the reference is tracked too.
      */
     t: Translations.TranslationFunction<ParserParams, ParserOutput, TranslationSchema>;
     /** Like `t`, for an explicit locale. */
     l: Translations.LocalTranslationFunction<ParserParams, ParserOutput, TranslationSchema, LocaleUnion>;
-    /**
-     * Applies a config. Overridable extension seam — `sveltekit-i18n` wires its
-     * default parser by extending this method.
-     */
-    configLoader(config: Config.T<ParserParams, ParserOutput>): Promise<void>;
     /**
      * Public entry for (re)configuration. The failure is reported here and the
      * promise marked handled, so a fire-and-forget call cannot become an

package/dist/I18n.svelte.js

@@ -30,7 +30,7 @@ class I18nCore {
         // A constructor may return a substitute object: the instance is folded
         // through `config.extensions` left to right, so `new I18n(config)`
         // evaluates to the last extension's output. The extensions run after the
-        // synchronous part of `configLoader` — they receive a configured instance.
+        // synchronous part of the config load — they receive a configured instance.
         return (config?.extensions ?? []).reduce((acc, extension) => extension(acc), this);
     }
     // -- reactive reads ---------------------------------------------------------
@@ -66,42 +66,30 @@ class I18nCore {
     });
     initialized = $derived(this.#locale !== undefined && this.#route !== undefined && Object.keys(this.#translations).length > 0);
     /**
-     * Translates `key` for the active locale. Reactive wherever reads are
-     * tracked: the call reads the translation table and locale, so a component
-     * using `{i18n.t('key')}` re-renders when either changes.
+     * Translates `key` for the active locale. Reactive on two levels: the
+     * returned function reads the tables at CALL time, so a destructured `t`
+     * keeps translating against live state, and its identity is refreshed
+     * whenever the config, the tables or the locale change, so merely holding
+     * the reference is tracked too.
      */
-    t = (key, ...params) => {
-        const { parser, fallbackLocale, ...rest } = this.#config ?? {};
-        return translate({
-            parser,
-            key,
-            params,
-            translations: this.#translations,
-            locale: this.#locale,
-            fallbackLocale,
-            ...(hasOwn(rest, 'fallbackValue') ? { fallbackValue: rest.fallbackValue } : {}),
-        });
-    };
+    t = $derived.by(() => {
+        void this.#config;
+        void this.#translations;
+        void this.#locale;
+        return (key, ...params) => this.#translate(this.#locale, key, params);
+    });
     /** Like `t`, for an explicit locale. */
-    l = (locale, key, ...params) => {
-        const { parser, fallbackLocale, ...rest } = this.#config ?? {};
-        const [sanitizedLocale = locale] = this.#sanitize(locale);
-        return translate({
-            parser,
-            key,
-            params,
-            translations: this.#translations,
-            locale: sanitizedLocale,
-            fallbackLocale,
-            ...(hasOwn(rest, 'fallbackValue') ? { fallbackValue: rest.fallbackValue } : {}),
-        });
-    };
+    l = $derived.by(() => {
+        void this.#config;
+        void this.#translations;
+        return (locale, key, ...params) => {
+            const [sanitizedLocale = locale] = this.#sanitize(locale);
+            return this.#translate(sanitizedLocale, key, params);
+        };
+    });
     // -- configuration ----------------------------------------------------------
-    /**
-     * Applies a config. Overridable extension seam — `sveltekit-i18n` wires its
-     * default parser by extending this method.
-     */
-    async configLoader(config) {
+    /** Applies a config. The public entry is `loadConfig`. */
+    async #configLoader(config) {
         if (!config) {
             logger.error('No config provided!');
             return;
@@ -149,7 +137,7 @@ class I18nCore {
     loadConfig = (config) => {
         if (this.#inert('loadConfig'))
             return Promise.resolve();
-        const promise = this.configLoader(config);
+        const promise = this.#configLoader(config);
         promise.catch((error) => logError('Failed to load the i18n config.', error));
         return promise;
     };
@@ -268,6 +256,18 @@ class I18nCore {
         this.#pending = new Set();
     };
     // -- internals --------------------------------------------------------------
+    #translate(locale, key, params) {
+        const { parser, fallbackLocale, ...rest } = this.#config ?? {};
+        return translate({
+            parser,
+            key,
+            params,
+            translations: this.#translations,
+            locale,
+            fallbackLocale,
+            ...(hasOwn(rest, 'fallbackValue') ? { fallbackValue: rest.fallbackValue } : {}),
+        });
+    }
     /**
      * Resolves loader data for a locale and route WITHOUT applying it. Returns
      * `[]` when there is nothing to load. The `cache` expiry is evaluated by

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sveltekit-i18n/base",
-  "version": "3.0.0-next.0",
+  "version": "3.0.0-next.1",
   "description": "Base functionality of sveltekit-i18n library with a support for external message parsers.",
   "type": "module",
   "types": "./dist/index.d.ts",