@sveltekit-i18n/base 1.2.0 → 1.3.0

package/README.md

@@ -82,24 +82,22 @@ const config = ({
 export const { t, locale, locales, loading, loadTranslations } = new i18n(config);
 ```
 
-...load your translations in `__layout.svelte`...
+...load your translations in `+layout.js`...
 
-```svelte
-<script context="module">
-  import { locale, loadTranslations } from '$lib/translations';
+```js
+import { locale, loadTranslations } from '$lib/translations';
 
-  export const load = async ({ url }) => {
-    const { pathname } = url;
+export const load = async ({ url }) => {
+  const { pathname } = url;
 
-    const defaultLocale = 'en'; // get from cookie, user session, ...
+  const defaultLocale = 'en'; // get from cookie, user session, ...
     
-    const initLocale = locale.get() || defaultLocale; // set default if no locale already set
+  const initLocale = locale.get() || defaultLocale; // set default if no locale already set
 
-    await loadTranslations(initLocale, pathname); // keep this just before the `return`
+  await loadTranslations(initLocale, pathname); // keep this just before the `return`
 
-    return {};
-  }
-</script>
+  return {};
+}
 ```
 
 ...and include your translations within pages and components.

package/dist/index.cjs

@@ -1 +1 @@
-var x=Object.defineProperty,H=Object.defineProperties,M=Object.getOwnPropertyDescriptor,q=Object.getOwnPropertyDescriptors,B=Object.getOwnPropertyNames,v=Object.getOwnPropertySymbols;var R=Object.prototype.hasOwnProperty,N=Object.prototype.propertyIsEnumerable;var j=(s,e,t)=>e in s?x(s,e,{enumerable:!0,configurable:!0,writable:!0,value:t}):s[e]=t,l=(s,e)=>{for(var t in e||(e={}))R.call(e,t)&&j(s,t,e[t]);if(v)for(var t of v(e))N.call(e,t)&&j(s,t,e[t]);return s},d=(s,e)=>H(s,q(e));var m=(s,e)=>{var t={};for(var r in s)R.call(s,r)&&e.indexOf(r)<0&&(t[r]=s[r]);if(s!=null&&v)for(var r of v(s))e.indexOf(r)<0&&N.call(s,r)&&(t[r]=s[r]);return t};var G=(s,e)=>{for(var t in e)x(s,t,{get:e[t],enumerable:!0})},J=(s,e,t,r)=>{if(e&&typeof e=="object"||typeof e=="function")for(let a of B(e))!R.call(s,a)&&a!==t&&x(s,a,{get:()=>e[a],enumerable:!(r=M(e,a))||r.enumerable});return s};var Q=s=>J(x({},"__esModule",{value:!0}),s);var U={};G(U,{default:()=>w});module.exports=Q(U);var i=require("svelte/store");var F=["error","warn","debug"],O=({logger:s=console,level:e=F[1],prefix:t="[i18n]: "})=>F.reduce((r,a,o)=>d(l({},r),{[a]:n=>F.indexOf(e)>=o&&s[a](`${t}${n}`)}),{}),c=O({}),V=s=>{c=s};var z=g=>{var u=g,{parser:s,key:e,params:t,translations:r,locale:a,fallbackLocale:o}=u,n=m(u,["parser","key","params","translations","locale","fallbackLocale"]);if(!(e&&a))return c.warn("No translation key or locale provided. Skipping translation..."),"";let p=(r[a]||{})[e];return o&&p===void 0&&(p=(r[o]||{})[e]),n.hasOwnProperty("fallbackValue")&&p===void 0?n.fallbackValue:s.parse(p,t,a,e)},h=(...s)=>s.length?s.filter(e=>!!e).map(e=>{let t=`${e}`.toLowerCase();try{let[r]=Intl.Collator.supportedLocalesOf(e);if(!r)throw new Error(`'${e}' is non-standard.`);t=r}catch{c.warn(`Non-standard locale provided: '${e}'. Check your 'translations' and 'loaders' in i18n config...`)}return t}):[],S=(s,e)=>Object.keys(s||{}).reduce((t,r)=>{let a=s[r],o=e?`${e}.${r}`:`${r}`;return a&&typeof a=="object"?l(l({},t),S(a,o)):d(l({},t),{[o]:a})},{}),$=async s=>{try{return(await Promise.all(s.map(a=>{var o=a,{loader:t}=o,r=m(o,["loader"]);return new Promise(async n=>{let g;try{g=await t()}catch(u){c.error(`Failed to load translation. Verify your '${r.locale}' > '${r.key}' Loader.`),c.error(u)}n(d(l({loader:t},r),{data:g}))})}))).reduce((t,{key:r,data:a,locale:o})=>{if(!a)return t;let[n]=h(o);return d(l({},t),{[n]:S(d(l({},t[n]||{}),{[r]:a}))})},{})}catch(e){c.error(e)}return{}},E=s=>e=>{try{if(typeof e=="string")return e===s;if(typeof e=="object")return e.test(s)}catch{c.error("Invalid route config!")}return!1},W=(s,e)=>{let t=!0;try{t=Object.keys(s).filter(r=>s[r]!==void 0).every(r=>s[r]===e[r])}catch{}return t};var D=1e3*60*60*24,w=class{constructor(e){this.cachedAt=0;this.loadedKeys={};this.currentRoute=(0,i.writable)();this.config=(0,i.writable)();this.isLoading=(0,i.writable)(!1);this.promises=new Set;this.loading={subscribe:this.isLoading.subscribe,toPromise:(e,t)=>{let r=Array.from(this.promises).filter(a=>W({locale:h(e)[0],route:t},a)).map(({promise:a})=>a);return Promise.all(r)},get:()=>(0,i.get)(this.isLoading)};this.privateTranslations=(0,i.writable)({});this.translations={subscribe:this.privateTranslations.subscribe,get:()=>(0,i.get)(this.translations)};this.locales=d(l({},(0,i.derived)([this.config,this.privateTranslations],([e,t])=>{if(!e)return[];let{loaders:r=[]}=e,a=r.map(({locale:n})=>h(n)[0]),o=Object.keys(t).map(n=>h(n)[0]);return Array.from(new Set([...a,...o]))},[])),{get:()=>(0,i.get)(this.locales)});this.internalLocale=(0,i.writable)();this.loaderTrigger=(0,i.derived)([this.internalLocale,this.currentRoute],([e,t],r)=>{var a,o;e!==void 0&&t!==void 0&&(e!==((a=(0,i.get)(this.loaderTrigger))==null?void 0:a[0])||t!==((o=(0,i.get)(this.loaderTrigger))==null?void 0:o[1]))&&(c.debug("Triggering translation load..."),r([e,t]))},[]);this.localeHelper=(0,i.writable)();this.locale={subscribe:this.localeHelper.subscribe,forceSet:this.localeHelper.set,set:this.internalLocale.set,update:this.internalLocale.update,get:()=>(0,i.get)(this.locale)};this.initialized=(0,i.derived)([this.locale,this.currentRoute,this.privateTranslations],([e,t,r],a)=>{(0,i.get)(this.initialized)||a(e!==void 0&&t!==void 0&&!!Object.keys(r).length)});this.translation=(0,i.derived)([this.privateTranslations,this.locale,this.isLoading],([e,t,r],a)=>{let o=e[t];o&&Object.keys(o).length&&!r&&a(o)},{});this.t=d(l({},(0,i.derived)([this.config,this.translation],a=>{var[o]=a,n=o,{parser:e,fallbackLocale:t}=n,r=m(n,["parser","fallbackLocale"]);return(g,...u)=>z(l({parser:e,key:g,params:u,translations:this.translations.get(),locale:this.locale.get(),fallbackLocale:t},r.hasOwnProperty("fallbackValue")?{fallbackValue:r.fallbackValue}:{}))})),{get:(e,...t)=>(0,i.get)(this.t)(e,...t)});this.l=d(l({},(0,i.derived)([this.config,this.translations],o=>{var[n,...g]=o,u=n,{parser:e,fallbackLocale:t}=u,r=m(u,["parser","fallbackLocale"]),[a]=g;return(p,T,...C)=>z(l({parser:e,key:T,params:C,translations:a,locale:p,fallbackLocale:t},r.hasOwnProperty("fallbackValue")?{fallbackValue:r.fallbackValue}:{}))})),{get:(e,t,...r)=>(0,i.get)(this.l)(e,t,...r)});this.getLocale=e=>{if(!e)return"";let r=this.locales.get().find(a=>a===h(e)[0])||"";return h(r)[0]||""};this.setLocale=e=>{if(!e)return;let[t]=h(e);if(t!==(0,i.get)(this.internalLocale))return c.debug(`Setting '${t}' locale.`),this.internalLocale.set(t),this.loading.toPromise(e,(0,i.get)(this.currentRoute))};this.setRoute=e=>{if(e!==(0,i.get)(this.currentRoute)){c.debug(`Setting '${e}' route.`),this.currentRoute.set(e);let t=(0,i.get)(this.internalLocale);return this.loading.toPromise(t,e)}};this.loadConfig=async e=>{await this.configLoader(e)};this.getTranslationProps=async(e=this.locale.get(),t=(0,i.get)(this.currentRoute))=>{let r=(0,i.get)(this.config);if(!r||!e)return[];let a=this.translations.get(),{loaders:o,fallbackLocale:n="",cache:g=D}=r||{},u=Number.isNaN(+g)?D:+g;this.cachedAt?Date.now()>u+this.cachedAt&&(c.debug("Refreshing cache."),this.loadedKeys={},this.cachedAt=0):(c.debug("Setting cache timestamp."),this.cachedAt=Date.now());let[p,T]=h(e,n),C=a[p],I=a[T],k=(o||[]).map(K=>{var L=K,{locale:f}=L,b=m(L,["locale"]);return d(l({},b),{locale:h(f)[0]})}).filter(({routes:f})=>!f||(f||[]).some(E(t))).filter(({key:f,locale:b})=>b===p&&(!C||!(this.loadedKeys[p]||[]).includes(f))||n&&b===T&&(!I||!(this.loadedKeys[T]||[]).includes(f)));if(k.length){this.isLoading.set(!0),c.debug("Fetching translations...");let f=await $(k);this.isLoading.set(!1);let b=Object.keys(f).reduce((L,y)=>d(l({},L),{[y]:Object.keys(f[y])}),{}),K=k.filter(({key:L,locale:y})=>(b[y]||[]).some(P=>`${P}`.startsWith(L))).reduce((L,{key:y,locale:P})=>d(l({},L),{[P]:[...L[P]||[],y]}),{});return[f,K]}return[]};this.addTranslations=(e,t)=>{if(!e)return;c.debug("Adding translations...");let r=Object.keys(e||{});this.privateTranslations.update(a=>r.reduce((o,n)=>d(l({},o),{[n]:l(l({},o[n]||{}),S(e[n]))}),a)),r.forEach(a=>{let o=Object.keys(e[a]).map(n=>`${n}`.split(".")[0]);t&&(o=t[a]),this.loadedKeys[a]=Array.from(new Set([...this.loadedKeys[a]||[],...o||[]]))})};this.loader=async([e,t])=>{c.debug("Adding loader promise.");let r=(async()=>{let a=await this.getTranslationProps(e,t);a.length&&this.addTranslations(...a)})();this.promises.add({locale:e,route:t,promise:r}),r.then(()=>{let a=this.getLocale(e);a&&this.locale.get()!==a&&this.locale.forceSet(a)})};this.loadTranslations=(e,t=(0,i.get)(this.currentRoute)||"")=>{if(!!e)return this.setRoute(t),this.setLocale(e),this.loading.toPromise(e,t)};e&&this.loadConfig(e),this.loaderTrigger.subscribe(this.loader),this.isLoading.subscribe(async t=>{t&&this.promises.size&&(await this.loading.toPromise(),this.promises.clear(),c.debug("Loader promises have been purged."))})}async configLoader(e){if(!e)return c.error("No config provided!");let g=e,{initLocale:t,fallbackLocale:r,translations:a,log:o}=g,n=m(g,["initLocale","fallbackLocale","translations","log"]);o&&V(O(o)),[t]=h(t),[r]=h(r),c.debug("Setting config."),this.config.set(l({initLocale:t,fallbackLocale:r,translations:a},n)),a&&this.addTranslations(a),await this.loadTranslations(t)}};0&&(module.exports={});
+"use strict";var w=Object.defineProperty,I=Object.defineProperties,H=Object.getOwnPropertyDescriptor,q=Object.getOwnPropertyDescriptors,B=Object.getOwnPropertyNames,v=Object.getOwnPropertySymbols;var C=Object.prototype.hasOwnProperty,A=Object.prototype.propertyIsEnumerable;var j=(s,t,e)=>t in s?w(s,t,{enumerable:!0,configurable:!0,writable:!0,value:e}):s[t]=e,l=(s,t)=>{for(var e in t||(t={}))C.call(t,e)&&j(s,e,t[e]);if(v)for(var e of v(t))A.call(t,e)&&j(s,e,t[e]);return s},u=(s,t)=>I(s,q(t));var T=(s,t)=>{var e={};for(var a in s)C.call(s,a)&&t.indexOf(a)<0&&(e[a]=s[a]);if(s!=null&&v)for(var a of v(s))t.indexOf(a)<0&&A.call(s,a)&&(e[a]=s[a]);return e};var G=(s,t)=>{for(var e in t)w(s,e,{get:t[e],enumerable:!0})},J=(s,t,e,a)=>{if(t&&typeof t=="object"||typeof t=="function")for(let r of B(t))!C.call(s,r)&&r!==e&&w(s,r,{get:()=>t[r],enumerable:!(a=H(t,r))||a.enumerable});return s};var M=s=>J(w({},"__esModule",{value:!0}),s);var U={};G(U,{default:()=>x});module.exports=M(U);var n=require("svelte/store");var z=["error","warn","debug"],F=({logger:s=console,level:t=z[1],prefix:e="[i18n]: "})=>z.reduce((a,r,i)=>u(l({},a),{[r]:o=>z.indexOf(t)>=i&&s[r](`${e}${o}`)}),{}),g=F({}),V=s=>{g=s};var O=c=>{var d=c,{parser:s,key:t,params:e,translations:a,locale:r,fallbackLocale:i}=d,o=T(d,["parser","key","params","translations","locale","fallbackLocale"]);if(!(t&&r))return g.warn("No translation key or locale provided. Skipping translation..."),"";let f=(a[r]||{})[t];return i&&f===void 0&&(f=(a[i]||{})[t]),o.hasOwnProperty("fallbackValue")&&f===void 0?o.fallbackValue:s.parse(f,e,r,t)},p=(...s)=>s.length?s.filter(t=>!!t).map(t=>{let e=`${t}`.toLowerCase();try{let[a]=Intl.Collator.supportedLocalesOf(t);if(!a)throw new Error;e=a}catch(a){g.warn(`'${t}' locale is non-standard.`)}return e}):[],S=(s,t,e)=>Object.keys(s||{}).reduce((a,r)=>{let i=s[r],o=e?`${e}.${r}`:`${r}`;return t&&Array.isArray(i)?u(l({},a),{[o]:i.map(c=>S(c,t))}):i&&typeof i=="object"?l(l({},a),S(i,t,o)):u(l({},a),{[o]:i})},{}),Q=s=>s.reduce((t,{key:e,data:a,locale:r})=>{if(!a)return t;let[i]=p(r),o=u(l({},t[i]||{}),{[e]:a});return u(l({},t),{[i]:o})},{}),$=async s=>{try{let t=await Promise.all(s.map(r=>{var i=r,{loader:e}=i,a=T(i,["loader"]);return new Promise(async o=>{let c;try{c=await e()}catch(d){g.error(`Failed to load translation. Verify your '${a.locale}' > '${a.key}' Loader.`),g.error(d)}o(u(l({loader:e},a),{data:c}))})}));return Q(t)}catch(t){g.error(t)}return{}},E=s=>t=>{try{if(typeof t=="string")return t===s;if(typeof t=="object")return t.test(s)}catch(e){g.error("Invalid route config!")}return!1},N=(s,t)=>{let e=!0;try{e=Object.keys(s).filter(a=>s[a]!==void 0).every(a=>s[a]===t[a])}catch(a){}return e};var W=1e3*60*60*24,x=class{constructor(t){this.cachedAt=0;this.loadedKeys={};this.currentRoute=(0,n.writable)();this.config=(0,n.writable)();this.isLoading=(0,n.writable)(!1);this.promises=new Set;this.loading={subscribe:this.isLoading.subscribe,toPromise:(t,e)=>{let a=Array.from(this.promises).filter(r=>N({locale:p(t)[0],route:e},r)).map(({promise:r})=>r);return Promise.all(a)},get:()=>(0,n.get)(this.isLoading)};this.privateRawTranslations=(0,n.writable)({});this.rawTranslations={subscribe:this.privateRawTranslations.subscribe,get:()=>(0,n.get)(this.rawTranslations)};this.privateTranslations=(0,n.writable)({});this.translations={subscribe:this.privateTranslations.subscribe,get:()=>(0,n.get)(this.translations)};this.locales=u(l({},(0,n.derived)([this.config,this.privateTranslations],([t,e])=>{if(!t)return[];let{loaders:a=[]}=t,r=a.map(({locale:o})=>o),i=Object.keys(e).map(o=>o);return Array.from(new Set([...p(...r),...p(...i)]))},[])),{get:()=>(0,n.get)(this.locales)});this.internalLocale=(0,n.writable)();this.loaderTrigger=(0,n.derived)([this.internalLocale,this.currentRoute],([t,e],a)=>{var r,i;t!==void 0&&e!==void 0&&!(t===((r=(0,n.get)(this.loaderTrigger))==null?void 0:r[0])&&e===((i=(0,n.get)(this.loaderTrigger))==null?void 0:i[1]))&&(g.debug("Triggering translation load..."),a([t,e]))},[]);this.localeHelper=(0,n.writable)();this.locale={subscribe:this.localeHelper.subscribe,forceSet:this.localeHelper.set,set:this.internalLocale.set,update:this.internalLocale.update,get:()=>(0,n.get)(this.locale)};this.initialized=(0,n.derived)([this.locale,this.currentRoute,this.privateTranslations],([t,e,a],r)=>{(0,n.get)(this.initialized)||r(t!==void 0&&e!==void 0&&!!Object.keys(a).length)});this.translation=(0,n.derived)([this.privateTranslations,this.locale,this.isLoading],([t,e,a],r)=>{let i=t[e];i&&Object.keys(i).length&&!a&&r(i)},{});this.t=u(l({},(0,n.derived)([this.config,this.translation],r=>{var[i]=r,o=i,{parser:t,fallbackLocale:e}=o,a=T(o,["parser","fallbackLocale"]);return(c,...d)=>O(l({parser:t,key:c,params:d,translations:this.translations.get(),locale:this.locale.get(),fallbackLocale:e},a.hasOwnProperty("fallbackValue")?{fallbackValue:a.fallbackValue}:{}))})),{get:(t,...e)=>(0,n.get)(this.t)(t,...e)});this.l=u(l({},(0,n.derived)([this.config,this.translations],i=>{var[o,...c]=i,d=o,{parser:t,fallbackLocale:e}=d,a=T(d,["parser","fallbackLocale"]),[r]=c;return(f,b,...R)=>O(l({parser:t,key:b,params:R,translations:r,locale:f,fallbackLocale:e},a.hasOwnProperty("fallbackValue")?{fallbackValue:a.fallbackValue}:{}))})),{get:(t,e,...a)=>(0,n.get)(this.l)(t,e,...a)});this.getLocale=t=>{let{fallbackLocale:e=""}=(0,n.get)(this.config)||{},a=t||e;if(!a)return"";let r=this.locales.get();return r.find(o=>p(a).includes(o))||r.find(o=>p(e).includes(o))||""};this.setLocale=t=>{if(t&&t!==(0,n.get)(this.internalLocale))return g.debug(`Setting '${t}' locale.`),this.internalLocale.set(t),this.loading.toPromise(t,(0,n.get)(this.currentRoute))};this.setRoute=t=>{if(t!==(0,n.get)(this.currentRoute)){g.debug(`Setting '${t}' route.`),this.currentRoute.set(t);let e=(0,n.get)(this.internalLocale);return this.loading.toPromise(e,t)}};this.loadConfig=async t=>{await this.configLoader(t)};this.getTranslationProps=async(t=this.locale.get(),e=(0,n.get)(this.currentRoute))=>{let a=(0,n.get)(this.config);if(!a||!t)return[];let r=this.translations.get(),{loaders:i,fallbackLocale:o="",cache:c=W}=a||{},d=Number.isNaN(+c)?W:+c;this.cachedAt?Date.now()>d+this.cachedAt&&(g.debug("Refreshing cache."),this.loadedKeys={},this.cachedAt=0):(g.debug("Setting cache timestamp."),this.cachedAt=Date.now());let[f,b]=p(t,o),R=r[f],D=r[b],k=(i||[]).map(K=>{var L=K,{locale:h}=L,m=T(L,["locale"]);return u(l({},m),{locale:p(h)[0]})}).filter(({routes:h})=>!h||(h||[]).some(E(e))).filter(({key:h,locale:m})=>m===f&&(!R||!(this.loadedKeys[f]||[]).includes(h))||o&&m===b&&(!D||!(this.loadedKeys[b]||[]).includes(h)));if(k.length){this.isLoading.set(!0),g.debug("Fetching translations...");let h=await $(k);this.isLoading.set(!1);let m=Object.keys(h).reduce((L,y)=>u(l({},L),{[y]:Object.keys(h[y])}),{}),K=k.filter(({key:L,locale:y})=>(m[y]||[]).some(P=>`${P}`.startsWith(L))).reduce((L,{key:y,locale:P})=>u(l({},L),{[P]:[...L[P]||[],y]}),{});return[h,K]}return[]};this.addTranslations=(t,e)=>{if(!t)return;let a=(0,n.get)(this.config),{preprocess:r}=a||{};g.debug("Adding translations...");let i=Object.keys(t||{});this.privateRawTranslations.update(o=>i.reduce((c,d)=>u(l({},c),{[d]:l(l({},c[d]||{}),t[d])}),o)),this.privateTranslations.update(o=>i.reduce((c,d)=>{let f=!0,b=t[d];return typeof r=="function"&&(b=r(b)),(typeof r=="function"||r==="none")&&(f=!1),u(l({},c),{[d]:l(l({},c[d]||{}),f?S(b,r==="preserveArrays"):b)})},o)),i.forEach(o=>{let c=Object.keys(t[o]).map(d=>`${d}`.split(".")[0]);e&&(c=e[o]),this.loadedKeys[o]=Array.from(new Set([...this.loadedKeys[o]||[],...c||[]]))})};this.loader=async([t,e])=>{let a=this.getLocale(t)||void 0;g.debug(`Adding loader promise for '${a}' locale and '${e}' route.`);let r=(async()=>{let i=await this.getTranslationProps(a,e);i.length&&this.addTranslations(...i)})();this.promises.add({locale:a,route:e,promise:r}),r.then(()=>{a&&this.locale.get()!==a&&this.locale.forceSet(a)})};this.loadTranslations=(t,e=(0,n.get)(this.currentRoute)||"")=>{let a=this.getLocale(t);if(a)return this.setRoute(e),this.setLocale(a),this.loading.toPromise(a,e)};this.loaderTrigger.subscribe(this.loader),this.isLoading.subscribe(async e=>{e&&this.promises.size&&(await this.loading.toPromise(),this.promises.clear(),g.debug("Loader promises have been purged."))}),t&&this.loadConfig(t)}async configLoader(t){if(!t)return g.error("No config provided!");let c=t,{initLocale:e,fallbackLocale:a,translations:r,log:i}=c,o=T(c,["initLocale","fallbackLocale","translations","log"]);i&&V(F(i)),[e]=p(e),[a]=p(a),g.debug("Setting config."),this.config.set(l({initLocale:e,fallbackLocale:a,translations:r},o)),r&&this.addTranslations(r),await this.loadTranslations(e)}};

package/dist/index.d.cts

@@ -0,0 +1,227 @@
+import { Readable, Writable } from 'svelte/store';
+
+type ExtendedStore<T, Get = () => T, Store = Readable<T>> = Store & {
+    get: Get;
+};
+type LoadingStore = Readable<boolean> & {
+    toPromise: (locale?: Config.Locale, route?: string) => Promise<void[] | void>;
+    get: () => boolean;
+};
+declare module DotNotation {
+    type Input = Translations.Input;
+    type Output<V = any, K extends keyof V = keyof V> = {
+        [P in K]?: V[K];
+    };
+    type T = <I = Input>(input: I, preserveArrays?: boolean, parentKey?: string) => Output<I>;
+}
+declare module Logger {
+    type Level = 'error' | 'warn' | 'debug';
+    type Prefix = string;
+    type T = {
+        [key in Logger.Level]: (value: any) => void;
+    };
+    type FactoryProps = {
+        /**
+         * You can setup your custom logger using this property.
+         *
+         * @default console
+         */
+        logger?: Logger.T;
+        /**
+         * You can manage log level using this property.
+         *
+         * @default 'warn'
+         */
+        level?: Logger.Level;
+        /**
+         * You can prefix output logs using this property.
+         *
+         * @default '[i18n]: '
+         */
+        prefix?: Logger.Prefix;
+    };
+}
+declare module Config {
+    type Loader = Loader.LoaderModule;
+    type Translations = Translations.T;
+    type Locale = Translations.Locales[number];
+    type InitLocale = Locale | undefined;
+    type FallbackLocale = Locale | undefined;
+    type FallbackValue = any;
+    type T<P extends Parser.Params = Parser.Params> = {
+        /**
+         * You can use loaders to define your asyncronous translation load. All loaded data are stored so loader is triggered only once – in case there is no previous version of the translation. It can get refreshed according to `config.cache`.
+         */
+        loaders?: Loader[];
+        /**
+         * Locale-indexed translations, which should be in place before loaders will trigger. It's useful for static pages and synchronous translations – for example locally defined language names which are the same for all of the language mutations.
+         *
+         * @example {
+         *  "en": {"lang": {"en": "English", "cs": "Česky"}}
+         *  "cs": {"lang": {"en": "English", "cs": "Česky"}}
+         * }
+         */
+        translations?: Translations.T;
+        /**
+         * If you set this property, translations will be initialized immediately using this locale.
+         */
+        initLocale?: InitLocale;
+        /**
+         * If you set this property, translations are automatically loaded not for current `$locale` only, but for this locale as well. In case there is no translation for current `$locale`, fallback locale translation is used instead of translation key placeholder. This is also used as a fallback when unknown locale is set.
+         */
+        fallbackLocale?: FallbackLocale;
+        /**
+         * By default, translation key is returned in case no translation is found for given translation key. For example, `$t('unknown.key')` will result in `'unknown.key'` output. You can set this output value using this config prop.
+         */
+        fallbackValue?: FallbackValue;
+        /**
+         * Preprocessor strategy or a custom function. Defines, how to transform the translation data immediately after the load.
+         * @default 'full'
+         *
+         * @example 'full'
+         * {a: {b: [{c: {d: 1}}, {c: {d: 2}}]}} => {"a.b.0.c.d": 1, "a.b.1.c.d": 2}
+         *
+         * @example 'preserveArrays'
+         * {a: {b: [{c: {d: 1}}, {c: {d: 2}}]}} => {"a.b": [{"c.d": 1}, {"c.d": 2}]}
+         *
+         * @example 'none'
+         * {a: {b: [{c: {d: 1}}, {c: {d: 2}}]}} => {a: {b: [{c: {d: 1}}, {c: {d: 2}}]}}
+         */
+        preprocess?: 'full' | 'preserveArrays' | 'none' | ((input: Translations.Input) => any);
+        /**
+         * This property defines translation syntax you want to use.
+         */
+        parser: Parser.T<P>;
+        /**
+         * When you are running your app on Node.js server, translations are loaded only once during the SSR. This property allows you to setup a refresh period in milliseconds when your translations are refetched on the server.
+         *
+         * @default 86400000 // 24 hours
+         *
+         * @tip You can set to `Number.POSITIVE_INFINITY` to disable server-side refreshing.
+         */
+        cache?: number;
+        /**
+         * Custom logger configuration.
+         */
+        log?: Logger.FactoryProps;
+    };
+}
+declare module Loader {
+    type Key = string;
+    type Locale = Config.Locale;
+    type Route = string | RegExp;
+    type IndexedKeys = Translations.LocaleIndexed<Key[]>;
+    type LoaderModule = {
+        /**
+         * Represents the translation namespace. This key is used as a translation prefix so it should be module-unique. You can access your translation later using `$t('key.yourTranslation')`. It shouldn't include `.` (dot) character.
+         */
+        key: Key;
+        /**
+         * Locale (e.g. `en`, `de`) which is this loader for.
+         */
+        locale: Locale;
+        /**
+         * Function returning a `Promise` with translation data. You can use it to load files locally, fetch it from your API etc...
+        */
+        loader: T;
+        /**
+        * Define routes this loader should be triggered for. You can use Regular expressions too. For example `[/\/.ome/]` will be triggered for `/home` and `/rome` route as well (but still only once). Leave this `undefined` in case you want to load this module with any route (useful for common translations).
+        */
+        routes?: Route[];
+    };
+    type T = () => Promise<Translations.Input>;
+}
+declare module Parser {
+    type Value = any;
+    type Params = Array<unknown>;
+    type Locale = Config.Locale;
+    type Key = Loader.Key;
+    type Output = any;
+    type Parse<P extends Parser.Params = Parser.Params> = (
+    /**
+     * Translation value from the definitions.
+    */
+    value: Value, 
+    /**
+     * Array of rest parameters given by user (e.g. payload variables etc...)
+     */
+    params: P, 
+    /**
+     * Locale of translated message.
+     */
+    locale: Locale, 
+    /**
+     * This key is serialized path to translation (e.g., `home.content.title`)
+     */
+    key: Key) => Output;
+    type T<P extends Parser.Params = Parser.Params> = {
+        /**
+         * Parse function deals with interpolation of user payload and returns interpolated message.
+        */
+        parse: Parse<P>;
+    };
+}
+declare module Translations {
+    type Locales<T = string> = T[];
+    type SerializedTranslations = LocaleIndexed<DotNotation.Input>;
+    type TranslationData<T = any> = Loader.LoaderModule & {
+        data: T;
+    };
+    type FetchTranslations = (loaders: Loader.LoaderModule[]) => Promise<SerializedTranslations>;
+    type TranslationFunction<P extends Parser.Params = Parser.Params> = (key: string, ...restParams: P) => any;
+    type LocalTranslationFunction<P extends Parser.Params = Parser.Params> = (locale: Config.Locale, key: string, ...restParams: P) => any;
+    type Translate = <P extends Parser.Params = Parser.Params>(props: {
+        parser: Parser.T<P>;
+        key: string;
+        params: P;
+        translations: SerializedTranslations;
+        locale: Locales[number];
+        fallbackLocale?: Config.FallbackLocale;
+        fallbackValue?: Config.FallbackValue;
+    }) => string;
+    type Input<V = any> = {
+        [K in any]: Input<V> | V;
+    };
+    type LocaleIndexed<V, L extends string = string> = {
+        [locale in Locales<L>[number]]: V;
+    };
+    type T<V = any, L extends string = string> = LocaleIndexed<Input<V>, L>;
+}
+
+declare class I18n<ParserParams extends Parser.Params = any> {
+    constructor(config?: Config.T<ParserParams>);
+    private cachedAt;
+    private loadedKeys;
+    private currentRoute;
+    private config;
+    private isLoading;
+    private promises;
+    loading: LoadingStore;
+    private privateRawTranslations;
+    rawTranslations: ExtendedStore<Translations.SerializedTranslations>;
+    private privateTranslations;
+    translations: ExtendedStore<Translations.SerializedTranslations>;
+    locales: ExtendedStore<Config.Locale[]>;
+    private internalLocale;
+    private loaderTrigger;
+    private localeHelper;
+    locale: ExtendedStore<Config.Locale, () => Config.Locale, Writable<string>> & {
+        forceSet: any;
+    };
+    initialized: Readable<boolean>;
+    private translation;
+    t: ExtendedStore<Translations.TranslationFunction<ParserParams>, Translations.TranslationFunction<ParserParams>>;
+    l: ExtendedStore<Translations.LocalTranslationFunction<ParserParams>, Translations.LocalTranslationFunction<ParserParams>>;
+    private getLocale;
+    setLocale: (locale?: string) => Promise<void | void[]> | undefined;
+    setRoute: (route: string) => Promise<void | void[]> | undefined;
+    configLoader(config: Config.T<ParserParams>): Promise<void>;
+    loadConfig: (config: Config.T<ParserParams>) => Promise<void>;
+    getTranslationProps: ($locale?: string, $route?: string) => Promise<[Translations.SerializedTranslations, Loader.IndexedKeys] | [
+    ]>;
+    addTranslations: (translations?: Translations.SerializedTranslations, keys?: Loader.IndexedKeys) => void;
+    private loader;
+    loadTranslations: (locale: Config.Locale, route?: string) => Promise<void | void[]> | undefined;
+}
+
+export { Config, Loader, Logger, Parser, Translations, I18n as default };

package/dist/index.d.ts

@@ -1,9 +1,9 @@
 import { Readable, Writable } from 'svelte/store';
 
-declare type ExtendedStore<T, Get = () => T, Store = Readable<T>> = Store & {
+type ExtendedStore<T, Get = () => T, Store = Readable<T>> = Store & {
     get: Get;
 };
-declare type LoadingStore = Readable<boolean> & {
+type LoadingStore = Readable<boolean> & {
     toPromise: (locale?: Config.Locale, route?: string) => Promise<void[] | void>;
     get: () => boolean;
 };
@@ -12,7 +12,7 @@ declare module DotNotation {
     type Output<V = any, K extends keyof V = keyof V> = {
         [P in K]?: V[K];
     };
-    type T = <I = Input>(input: I, parentKey?: string) => Output<I>;
+    type T = <I = Input>(input: I, preserveArrays?: boolean, parentKey?: string) => Output<I>;
 }
 declare module Logger {
     type Level = 'error' | 'warn' | 'debug';
@@ -21,8 +21,23 @@ declare module Logger {
         [key in Logger.Level]: (value: any) => void;
     };
     type FactoryProps = {
+        /**
+         * You can setup your custom logger using this property.
+         *
+         * @default console
+         */
         logger?: Logger.T;
+        /**
+         * You can manage log level using this property.
+         *
+         * @default 'warn'
+         */
         level?: Logger.Level;
+        /**
+         * You can prefix output logs using this property.
+         *
+         * @default '[i18n]: '
+         */
         prefix?: Logger.Prefix;
     };
 }
@@ -34,18 +49,61 @@ declare module Config {
     type FallbackLocale = Locale | undefined;
     type FallbackValue = any;
     type T<P extends Parser.Params = Parser.Params> = {
+        /**
+         * You can use loaders to define your asyncronous translation load. All loaded data are stored so loader is triggered only once – in case there is no previous version of the translation. It can get refreshed according to `config.cache`.
+         */
         loaders?: Loader[];
+        /**
+         * Locale-indexed translations, which should be in place before loaders will trigger. It's useful for static pages and synchronous translations – for example locally defined language names which are the same for all of the language mutations.
+         *
+         * @example {
+         *  "en": {"lang": {"en": "English", "cs": "Česky"}}
+         *  "cs": {"lang": {"en": "English", "cs": "Česky"}}
+         * }
+         */
         translations?: Translations.T;
+        /**
+         * If you set this property, translations will be initialized immediately using this locale.
+         */
         initLocale?: InitLocale;
+        /**
+         * If you set this property, translations are automatically loaded not for current `$locale` only, but for this locale as well. In case there is no translation for current `$locale`, fallback locale translation is used instead of translation key placeholder. This is also used as a fallback when unknown locale is set.
+         */
         fallbackLocale?: FallbackLocale;
+        /**
+         * By default, translation key is returned in case no translation is found for given translation key. For example, `$t('unknown.key')` will result in `'unknown.key'` output. You can set this output value using this config prop.
+         */
         fallbackValue?: FallbackValue;
+        /**
+         * Preprocessor strategy or a custom function. Defines, how to transform the translation data immediately after the load.
+         * @default 'full'
+         *
+         * @example 'full'
+         * {a: {b: [{c: {d: 1}}, {c: {d: 2}}]}} => {"a.b.0.c.d": 1, "a.b.1.c.d": 2}
+         *
+         * @example 'preserveArrays'
+         * {a: {b: [{c: {d: 1}}, {c: {d: 2}}]}} => {"a.b": [{"c.d": 1}, {"c.d": 2}]}
+         *
+         * @example 'none'
+         * {a: {b: [{c: {d: 1}}, {c: {d: 2}}]}} => {a: {b: [{c: {d: 1}}, {c: {d: 2}}]}}
+         */
+        preprocess?: 'full' | 'preserveArrays' | 'none' | ((input: Translations.Input) => any);
+        /**
+         * This property defines translation syntax you want to use.
+         */
         parser: Parser.T<P>;
+        /**
+         * When you are running your app on Node.js server, translations are loaded only once during the SSR. This property allows you to setup a refresh period in milliseconds when your translations are refetched on the server.
+         *
+         * @default 86400000 // 24 hours
+         *
+         * @tip You can set to `Number.POSITIVE_INFINITY` to disable server-side refreshing.
+         */
         cache?: number;
-        log?: {
-            level?: Logger.Level;
-            logger?: Logger.T;
-            prefix?: Logger.Prefix;
-        };
+        /**
+         * Custom logger configuration.
+         */
+        log?: Logger.FactoryProps;
     };
 }
 declare module Loader {
@@ -54,10 +112,22 @@ declare module Loader {
     type Route = string | RegExp;
     type IndexedKeys = Translations.LocaleIndexed<Key[]>;
     type LoaderModule = {
+        /**
+         * Represents the translation namespace. This key is used as a translation prefix so it should be module-unique. You can access your translation later using `$t('key.yourTranslation')`. It shouldn't include `.` (dot) character.
+         */
         key: Key;
+        /**
+         * Locale (e.g. `en`, `de`) which is this loader for.
+         */
         locale: Locale;
-        routes?: Route[];
+        /**
+         * Function returning a `Promise` with translation data. You can use it to load files locally, fetch it from your API etc...
+        */
         loader: T;
+        /**
+        * Define routes this loader should be triggered for. You can use Regular expressions too. For example `[/\/.ome/]` will be triggered for `/home` and `/rome` route as well (but still only once). Leave this `undefined` in case you want to load this module with any route (useful for common translations).
+        */
+        routes?: Route[];
     };
     type T = () => Promise<Translations.Input>;
 }
@@ -67,14 +137,36 @@ declare module Parser {
     type Locale = Config.Locale;
     type Key = Loader.Key;
     type Output = any;
-    type Parse<P extends Parser.Params = Parser.Params> = (value: Value, params: P, locale: Locale, key: Key) => Output;
+    type Parse<P extends Parser.Params = Parser.Params> = (
+    /**
+     * Translation value from the definitions.
+    */
+    value: Value, 
+    /**
+     * Array of rest parameters given by user (e.g. payload variables etc...)
+     */
+    params: P, 
+    /**
+     * Locale of translated message.
+     */
+    locale: Locale, 
+    /**
+     * This key is serialized path to translation (e.g., `home.content.title`)
+     */
+    key: Key) => Output;
     type T<P extends Parser.Params = Parser.Params> = {
+        /**
+         * Parse function deals with interpolation of user payload and returns interpolated message.
+        */
         parse: Parse<P>;
     };
 }
 declare module Translations {
-    type Locales = string[];
-    type SerializedTranslations = LocaleIndexed<DotNotation.Output>;
+    type Locales<T = string> = T[];
+    type SerializedTranslations = LocaleIndexed<DotNotation.Input>;
+    type TranslationData<T = any> = Loader.LoaderModule & {
+        data: T;
+    };
     type FetchTranslations = (loaders: Loader.LoaderModule[]) => Promise<SerializedTranslations>;
     type TranslationFunction<P extends Parser.Params = Parser.Params> = (key: string, ...restParams: P) => any;
     type LocalTranslationFunction<P extends Parser.Params = Parser.Params> = (locale: Config.Locale, key: string, ...restParams: P) => any;
@@ -90,10 +182,10 @@ declare module Translations {
     type Input<V = any> = {
         [K in any]: Input<V> | V;
     };
-    type LocaleIndexed<V> = {
-        [locale in Locales[number]]: V;
+    type LocaleIndexed<V, L extends string = string> = {
+        [locale in Locales<L>[number]]: V;
     };
-    type T<V = any> = LocaleIndexed<Input<V>>;
+    type T<V = any, L extends string = string> = LocaleIndexed<Input<V>, L>;
 }
 
 declare class I18n<ParserParams extends Parser.Params = any> {
@@ -105,6 +197,8 @@ declare class I18n<ParserParams extends Parser.Params = any> {
     private isLoading;
     private promises;
     loading: LoadingStore;
+    private privateRawTranslations;
+    rawTranslations: ExtendedStore<Translations.SerializedTranslations>;
     private privateTranslations;
     translations: ExtendedStore<Translations.SerializedTranslations>;
     locales: ExtendedStore<Config.Locale[]>;
@@ -119,13 +213,13 @@ declare class I18n<ParserParams extends Parser.Params = any> {
     t: ExtendedStore<Translations.TranslationFunction<ParserParams>, Translations.TranslationFunction<ParserParams>>;
     l: ExtendedStore<Translations.LocalTranslationFunction<ParserParams>, Translations.LocalTranslationFunction<ParserParams>>;
     private getLocale;
-    setLocale: (locale?: string | undefined) => Promise<void | void[]> | undefined;
+    setLocale: (locale?: string) => Promise<void | void[]> | undefined;
     setRoute: (route: string) => Promise<void | void[]> | undefined;
     configLoader(config: Config.T<ParserParams>): Promise<void>;
     loadConfig: (config: Config.T<ParserParams>) => Promise<void>;
     getTranslationProps: ($locale?: string, $route?: string) => Promise<[Translations.SerializedTranslations, Loader.IndexedKeys] | [
     ]>;
-    addTranslations: (translations?: Translations.SerializedTranslations | undefined, keys?: Loader.IndexedKeys | undefined) => void;
+    addTranslations: (translations?: Translations.SerializedTranslations, keys?: Loader.IndexedKeys) => void;
     private loader;
     loadTranslations: (locale: Config.Locale, route?: string) => Promise<void | void[]> | undefined;
 }

package/dist/index.js

@@ -1 +1 @@
-var q=Object.defineProperty,B=Object.defineProperties;var G=Object.getOwnPropertyDescriptors;var S=Object.getOwnPropertySymbols;var N=Object.prototype.hasOwnProperty,A=Object.prototype.propertyIsEnumerable;var j=(s,e,t)=>e in s?q(s,e,{enumerable:!0,configurable:!0,writable:!0,value:t}):s[e]=t,n=(s,e)=>{for(var t in e||(e={}))N.call(e,t)&&j(s,t,e[t]);if(S)for(var t of S(e))A.call(e,t)&&j(s,t,e[t]);return s},d=(s,e)=>B(s,G(e));var m=(s,e)=>{var t={};for(var r in s)N.call(s,r)&&e.indexOf(r)<0&&(t[r]=s[r]);if(s!=null&&S)for(var r of S(s))e.indexOf(r)<0&&A.call(s,r)&&(t[r]=s[r]);return t};import{derived as T,get as c,writable as P}from"svelte/store";var R=["error","warn","debug"],F=({logger:s=console,level:e=R[1],prefix:t="[i18n]: "})=>R.reduce((r,a,o)=>d(n({},r),{[a]:i=>R.indexOf(e)>=o&&s[a](`${t}${i}`)}),{}),l=F({}),E=s=>{l=s};var O=g=>{var u=g,{parser:s,key:e,params:t,translations:r,locale:a,fallbackLocale:o}=u,i=m(u,["parser","key","params","translations","locale","fallbackLocale"]);if(!(e&&a))return l.warn("No translation key or locale provided. Skipping translation..."),"";let p=(r[a]||{})[e];return o&&p===void 0&&(p=(r[o]||{})[e]),i.hasOwnProperty("fallbackValue")&&p===void 0?i.fallbackValue:s.parse(p,t,a,e)},h=(...s)=>s.length?s.filter(e=>!!e).map(e=>{let t=`${e}`.toLowerCase();try{let[r]=Intl.Collator.supportedLocalesOf(e);if(!r)throw new Error(`'${e}' is non-standard.`);t=r}catch{l.warn(`Non-standard locale provided: '${e}'. Check your 'translations' and 'loaders' in i18n config...`)}return t}):[],w=(s,e)=>Object.keys(s||{}).reduce((t,r)=>{let a=s[r],o=e?`${e}.${r}`:`${r}`;return a&&typeof a=="object"?n(n({},t),w(a,o)):d(n({},t),{[o]:a})},{}),W=async s=>{try{return(await Promise.all(s.map(a=>{var o=a,{loader:t}=o,r=m(o,["loader"]);return new Promise(async i=>{let g;try{g=await t()}catch(u){l.error(`Failed to load translation. Verify your '${r.locale}' > '${r.key}' Loader.`),l.error(u)}i(d(n({loader:t},r),{data:g}))})}))).reduce((t,{key:r,data:a,locale:o})=>{if(!a)return t;let[i]=h(o);return d(n({},t),{[i]:w(d(n({},t[i]||{}),{[r]:a}))})},{})}catch(e){l.error(e)}return{}},D=s=>e=>{try{if(typeof e=="string")return e===s;if(typeof e=="object")return e.test(s)}catch{l.error("Invalid route config!")}return!1},I=(s,e)=>{let t=!0;try{t=Object.keys(s).filter(r=>s[r]!==void 0).every(r=>s[r]===e[r])}catch{}return t};var H=1e3*60*60*24,z=class{constructor(e){this.cachedAt=0;this.loadedKeys={};this.currentRoute=P();this.config=P();this.isLoading=P(!1);this.promises=new Set;this.loading={subscribe:this.isLoading.subscribe,toPromise:(e,t)=>{let r=Array.from(this.promises).filter(a=>I({locale:h(e)[0],route:t},a)).map(({promise:a})=>a);return Promise.all(r)},get:()=>c(this.isLoading)};this.privateTranslations=P({});this.translations={subscribe:this.privateTranslations.subscribe,get:()=>c(this.translations)};this.locales=d(n({},T([this.config,this.privateTranslations],([e,t])=>{if(!e)return[];let{loaders:r=[]}=e,a=r.map(({locale:i})=>h(i)[0]),o=Object.keys(t).map(i=>h(i)[0]);return Array.from(new Set([...a,...o]))},[])),{get:()=>c(this.locales)});this.internalLocale=P();this.loaderTrigger=T([this.internalLocale,this.currentRoute],([e,t],r)=>{var a,o;e!==void 0&&t!==void 0&&(e!==((a=c(this.loaderTrigger))==null?void 0:a[0])||t!==((o=c(this.loaderTrigger))==null?void 0:o[1]))&&(l.debug("Triggering translation load..."),r([e,t]))},[]);this.localeHelper=P();this.locale={subscribe:this.localeHelper.subscribe,forceSet:this.localeHelper.set,set:this.internalLocale.set,update:this.internalLocale.update,get:()=>c(this.locale)};this.initialized=T([this.locale,this.currentRoute,this.privateTranslations],([e,t,r],a)=>{c(this.initialized)||a(e!==void 0&&t!==void 0&&!!Object.keys(r).length)});this.translation=T([this.privateTranslations,this.locale,this.isLoading],([e,t,r],a)=>{let o=e[t];o&&Object.keys(o).length&&!r&&a(o)},{});this.t=d(n({},T([this.config,this.translation],a=>{var[o]=a,i=o,{parser:e,fallbackLocale:t}=i,r=m(i,["parser","fallbackLocale"]);return(g,...u)=>O(n({parser:e,key:g,params:u,translations:this.translations.get(),locale:this.locale.get(),fallbackLocale:t},r.hasOwnProperty("fallbackValue")?{fallbackValue:r.fallbackValue}:{}))})),{get:(e,...t)=>c(this.t)(e,...t)});this.l=d(n({},T([this.config,this.translations],o=>{var[i,...g]=o,u=i,{parser:e,fallbackLocale:t}=u,r=m(u,["parser","fallbackLocale"]),[a]=g;return(p,v,...C)=>O(n({parser:e,key:v,params:C,translations:a,locale:p,fallbackLocale:t},r.hasOwnProperty("fallbackValue")?{fallbackValue:r.fallbackValue}:{}))})),{get:(e,t,...r)=>c(this.l)(e,t,...r)});this.getLocale=e=>{if(!e)return"";let r=this.locales.get().find(a=>a===h(e)[0])||"";return h(r)[0]||""};this.setLocale=e=>{if(!e)return;let[t]=h(e);if(t!==c(this.internalLocale))return l.debug(`Setting '${t}' locale.`),this.internalLocale.set(t),this.loading.toPromise(e,c(this.currentRoute))};this.setRoute=e=>{if(e!==c(this.currentRoute)){l.debug(`Setting '${e}' route.`),this.currentRoute.set(e);let t=c(this.internalLocale);return this.loading.toPromise(t,e)}};this.loadConfig=async e=>{await this.configLoader(e)};this.getTranslationProps=async(e=this.locale.get(),t=c(this.currentRoute))=>{let r=c(this.config);if(!r||!e)return[];let a=this.translations.get(),{loaders:o,fallbackLocale:i="",cache:g=H}=r||{},u=Number.isNaN(+g)?H:+g;this.cachedAt?Date.now()>u+this.cachedAt&&(l.debug("Refreshing cache."),this.loadedKeys={},this.cachedAt=0):(l.debug("Setting cache timestamp."),this.cachedAt=Date.now());let[p,v]=h(e,i),C=a[p],M=a[v],k=(o||[]).map(K=>{var L=K,{locale:f}=L,b=m(L,["locale"]);return d(n({},b),{locale:h(f)[0]})}).filter(({routes:f})=>!f||(f||[]).some(D(t))).filter(({key:f,locale:b})=>b===p&&(!C||!(this.loadedKeys[p]||[]).includes(f))||i&&b===v&&(!M||!(this.loadedKeys[v]||[]).includes(f)));if(k.length){this.isLoading.set(!0),l.debug("Fetching translations...");let f=await W(k);this.isLoading.set(!1);let b=Object.keys(f).reduce((L,y)=>d(n({},L),{[y]:Object.keys(f[y])}),{}),K=k.filter(({key:L,locale:y})=>(b[y]||[]).some(x=>`${x}`.startsWith(L))).reduce((L,{key:y,locale:x})=>d(n({},L),{[x]:[...L[x]||[],y]}),{});return[f,K]}return[]};this.addTranslations=(e,t)=>{if(!e)return;l.debug("Adding translations...");let r=Object.keys(e||{});this.privateTranslations.update(a=>r.reduce((o,i)=>d(n({},o),{[i]:n(n({},o[i]||{}),w(e[i]))}),a)),r.forEach(a=>{let o=Object.keys(e[a]).map(i=>`${i}`.split(".")[0]);t&&(o=t[a]),this.loadedKeys[a]=Array.from(new Set([...this.loadedKeys[a]||[],...o||[]]))})};this.loader=async([e,t])=>{l.debug("Adding loader promise.");let r=(async()=>{let a=await this.getTranslationProps(e,t);a.length&&this.addTranslations(...a)})();this.promises.add({locale:e,route:t,promise:r}),r.then(()=>{let a=this.getLocale(e);a&&this.locale.get()!==a&&this.locale.forceSet(a)})};this.loadTranslations=(e,t=c(this.currentRoute)||"")=>{if(!!e)return this.setRoute(t),this.setLocale(e),this.loading.toPromise(e,t)};e&&this.loadConfig(e),this.loaderTrigger.subscribe(this.loader),this.isLoading.subscribe(async t=>{t&&this.promises.size&&(await this.loading.toPromise(),this.promises.clear(),l.debug("Loader promises have been purged."))})}async configLoader(e){if(!e)return l.error("No config provided!");let g=e,{initLocale:t,fallbackLocale:r,translations:a,log:o}=g,i=m(g,["initLocale","fallbackLocale","translations","log"]);o&&E(F(o)),[t]=h(t),[r]=h(r),l.debug("Setting config."),this.config.set(n({initLocale:t,fallbackLocale:r,translations:a},i)),a&&this.addTranslations(a),await this.loadTranslations(t)}};export{z as default};
+var H=Object.defineProperty,q=Object.defineProperties;var B=Object.getOwnPropertyDescriptors;var S=Object.getOwnPropertySymbols;var A=Object.prototype.hasOwnProperty,V=Object.prototype.propertyIsEnumerable;var j=(s,t,e)=>t in s?H(s,t,{enumerable:!0,configurable:!0,writable:!0,value:e}):s[t]=e,n=(s,t)=>{for(var e in t||(t={}))A.call(t,e)&&j(s,e,t[e]);if(S)for(var e of S(t))V.call(t,e)&&j(s,e,t[e]);return s},u=(s,t)=>q(s,B(t));var T=(s,t)=>{var e={};for(var a in s)A.call(s,a)&&t.indexOf(a)<0&&(e[a]=s[a]);if(s!=null&&S)for(var a of S(s))t.indexOf(a)<0&&V.call(s,a)&&(e[a]=s[a]);return e};import{derived as v,get as g,writable as m}from"svelte/store";var C=["error","warn","debug"],z=({logger:s=console,level:t=C[1],prefix:e="[i18n]: "})=>C.reduce((a,r,i)=>u(n({},a),{[r]:o=>C.indexOf(t)>=i&&s[r](`${e}${o}`)}),{}),d=z({}),$=s=>{d=s};var F=l=>{var c=l,{parser:s,key:t,params:e,translations:a,locale:r,fallbackLocale:i}=c,o=T(c,["parser","key","params","translations","locale","fallbackLocale"]);if(!(t&&r))return d.warn("No translation key or locale provided. Skipping translation..."),"";let f=(a[r]||{})[t];return i&&f===void 0&&(f=(a[i]||{})[t]),o.hasOwnProperty("fallbackValue")&&f===void 0?o.fallbackValue:s.parse(f,e,r,t)},p=(...s)=>s.length?s.filter(t=>!!t).map(t=>{let e=`${t}`.toLowerCase();try{let[a]=Intl.Collator.supportedLocalesOf(t);if(!a)throw new Error;e=a}catch(a){d.warn(`'${t}' locale is non-standard.`)}return e}):[],x=(s,t,e)=>Object.keys(s||{}).reduce((a,r)=>{let i=s[r],o=e?`${e}.${r}`:`${r}`;return t&&Array.isArray(i)?u(n({},a),{[o]:i.map(l=>x(l,t))}):i&&typeof i=="object"?n(n({},a),x(i,t,o)):u(n({},a),{[o]:i})},{}),G=s=>s.reduce((t,{key:e,data:a,locale:r})=>{if(!a)return t;let[i]=p(r),o=u(n({},t[i]||{}),{[e]:a});return u(n({},t),{[i]:o})},{}),E=async s=>{try{let t=await Promise.all(s.map(r=>{var i=r,{loader:e}=i,a=T(i,["loader"]);return new Promise(async o=>{let l;try{l=await e()}catch(c){d.error(`Failed to load translation. Verify your '${a.locale}' > '${a.key}' Loader.`),d.error(c)}o(u(n({loader:e},a),{data:l}))})}));return G(t)}catch(t){d.error(t)}return{}},N=s=>t=>{try{if(typeof t=="string")return t===s;if(typeof t=="object")return t.test(s)}catch(e){d.error("Invalid route config!")}return!1},W=(s,t)=>{let e=!0;try{e=Object.keys(s).filter(a=>s[a]!==void 0).every(a=>s[a]===t[a])}catch(a){}return e};var D=1e3*60*60*24,O=class{constructor(t){this.cachedAt=0;this.loadedKeys={};this.currentRoute=m();this.config=m();this.isLoading=m(!1);this.promises=new Set;this.loading={subscribe:this.isLoading.subscribe,toPromise:(t,e)=>{let a=Array.from(this.promises).filter(r=>W({locale:p(t)[0],route:e},r)).map(({promise:r})=>r);return Promise.all(a)},get:()=>g(this.isLoading)};this.privateRawTranslations=m({});this.rawTranslations={subscribe:this.privateRawTranslations.subscribe,get:()=>g(this.rawTranslations)};this.privateTranslations=m({});this.translations={subscribe:this.privateTranslations.subscribe,get:()=>g(this.translations)};this.locales=u(n({},v([this.config,this.privateTranslations],([t,e])=>{if(!t)return[];let{loaders:a=[]}=t,r=a.map(({locale:o})=>o),i=Object.keys(e).map(o=>o);return Array.from(new Set([...p(...r),...p(...i)]))},[])),{get:()=>g(this.locales)});this.internalLocale=m();this.loaderTrigger=v([this.internalLocale,this.currentRoute],([t,e],a)=>{var r,i;t!==void 0&&e!==void 0&&!(t===((r=g(this.loaderTrigger))==null?void 0:r[0])&&e===((i=g(this.loaderTrigger))==null?void 0:i[1]))&&(d.debug("Triggering translation load..."),a([t,e]))},[]);this.localeHelper=m();this.locale={subscribe:this.localeHelper.subscribe,forceSet:this.localeHelper.set,set:this.internalLocale.set,update:this.internalLocale.update,get:()=>g(this.locale)};this.initialized=v([this.locale,this.currentRoute,this.privateTranslations],([t,e,a],r)=>{g(this.initialized)||r(t!==void 0&&e!==void 0&&!!Object.keys(a).length)});this.translation=v([this.privateTranslations,this.locale,this.isLoading],([t,e,a],r)=>{let i=t[e];i&&Object.keys(i).length&&!a&&r(i)},{});this.t=u(n({},v([this.config,this.translation],r=>{var[i]=r,o=i,{parser:t,fallbackLocale:e}=o,a=T(o,["parser","fallbackLocale"]);return(l,...c)=>F(n({parser:t,key:l,params:c,translations:this.translations.get(),locale:this.locale.get(),fallbackLocale:e},a.hasOwnProperty("fallbackValue")?{fallbackValue:a.fallbackValue}:{}))})),{get:(t,...e)=>g(this.t)(t,...e)});this.l=u(n({},v([this.config,this.translations],i=>{var[o,...l]=i,c=o,{parser:t,fallbackLocale:e}=c,a=T(c,["parser","fallbackLocale"]),[r]=l;return(f,b,...R)=>F(n({parser:t,key:b,params:R,translations:r,locale:f,fallbackLocale:e},a.hasOwnProperty("fallbackValue")?{fallbackValue:a.fallbackValue}:{}))})),{get:(t,e,...a)=>g(this.l)(t,e,...a)});this.getLocale=t=>{let{fallbackLocale:e=""}=g(this.config)||{},a=t||e;if(!a)return"";let r=this.locales.get();return r.find(o=>p(a).includes(o))||r.find(o=>p(e).includes(o))||""};this.setLocale=t=>{if(t&&t!==g(this.internalLocale))return d.debug(`Setting '${t}' locale.`),this.internalLocale.set(t),this.loading.toPromise(t,g(this.currentRoute))};this.setRoute=t=>{if(t!==g(this.currentRoute)){d.debug(`Setting '${t}' route.`),this.currentRoute.set(t);let e=g(this.internalLocale);return this.loading.toPromise(e,t)}};this.loadConfig=async t=>{await this.configLoader(t)};this.getTranslationProps=async(t=this.locale.get(),e=g(this.currentRoute))=>{let a=g(this.config);if(!a||!t)return[];let r=this.translations.get(),{loaders:i,fallbackLocale:o="",cache:l=D}=a||{},c=Number.isNaN(+l)?D:+l;this.cachedAt?Date.now()>c+this.cachedAt&&(d.debug("Refreshing cache."),this.loadedKeys={},this.cachedAt=0):(d.debug("Setting cache timestamp."),this.cachedAt=Date.now());let[f,b]=p(t,o),R=r[f],I=r[b],k=(i||[]).map(K=>{var L=K,{locale:h}=L,y=T(L,["locale"]);return u(n({},y),{locale:p(h)[0]})}).filter(({routes:h})=>!h||(h||[]).some(N(e))).filter(({key:h,locale:y})=>y===f&&(!R||!(this.loadedKeys[f]||[]).includes(h))||o&&y===b&&(!I||!(this.loadedKeys[b]||[]).includes(h)));if(k.length){this.isLoading.set(!0),d.debug("Fetching translations...");let h=await E(k);this.isLoading.set(!1);let y=Object.keys(h).reduce((L,P)=>u(n({},L),{[P]:Object.keys(h[P])}),{}),K=k.filter(({key:L,locale:P})=>(y[P]||[]).some(w=>`${w}`.startsWith(L))).reduce((L,{key:P,locale:w})=>u(n({},L),{[w]:[...L[w]||[],P]}),{});return[h,K]}return[]};this.addTranslations=(t,e)=>{if(!t)return;let a=g(this.config),{preprocess:r}=a||{};d.debug("Adding translations...");let i=Object.keys(t||{});this.privateRawTranslations.update(o=>i.reduce((l,c)=>u(n({},l),{[c]:n(n({},l[c]||{}),t[c])}),o)),this.privateTranslations.update(o=>i.reduce((l,c)=>{let f=!0,b=t[c];return typeof r=="function"&&(b=r(b)),(typeof r=="function"||r==="none")&&(f=!1),u(n({},l),{[c]:n(n({},l[c]||{}),f?x(b,r==="preserveArrays"):b)})},o)),i.forEach(o=>{let l=Object.keys(t[o]).map(c=>`${c}`.split(".")[0]);e&&(l=e[o]),this.loadedKeys[o]=Array.from(new Set([...this.loadedKeys[o]||[],...l||[]]))})};this.loader=async([t,e])=>{let a=this.getLocale(t)||void 0;d.debug(`Adding loader promise for '${a}' locale and '${e}' route.`);let r=(async()=>{let i=await this.getTranslationProps(a,e);i.length&&this.addTranslations(...i)})();this.promises.add({locale:a,route:e,promise:r}),r.then(()=>{a&&this.locale.get()!==a&&this.locale.forceSet(a)})};this.loadTranslations=(t,e=g(this.currentRoute)||"")=>{let a=this.getLocale(t);if(a)return this.setRoute(e),this.setLocale(a),this.loading.toPromise(a,e)};this.loaderTrigger.subscribe(this.loader),this.isLoading.subscribe(async e=>{e&&this.promises.size&&(await this.loading.toPromise(),this.promises.clear(),d.debug("Loader promises have been purged."))}),t&&this.loadConfig(t)}async configLoader(t){if(!t)return d.error("No config provided!");let l=t,{initLocale:e,fallbackLocale:a,translations:r,log:i}=l,o=T(l,["initLocale","fallbackLocale","translations","log"]);i&&$(z(i)),[e]=p(e),[a]=p(a),d.debug("Setting config."),this.config.set(n({initLocale:e,fallbackLocale:a,translations:r},o)),r&&this.addTranslations(r),await this.loadTranslations(e)}};export{O as default};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sveltekit-i18n/base",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "Base functionality of sveltekit-i18n library with a support for external message parsers.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -16,7 +16,7 @@
   },
   "scripts": {
     "dev": "tsup --watch",
-    "test": "jest",
+    "test": "npx cross-env NODE_OPTIONS=--experimental-vm-modules jest",
     "build": "tsup",
     "prepublishOnly": "npm run build",
     "lint": "eslint --fix --ext .ts,.js --ignore-path .gitignore ."
@@ -47,22 +47,22 @@
   },
   "homepage": "https://github.com/sveltekit-i18n/base#readme",
   "peerDependencies": {
-    "svelte": "^3.x"
+    "svelte": ">=3.49.0"
   },
   "optionalDependencies": {
-    "@sveltekit-i18n/parser-default": "^1.x"
+    "@sveltekit-i18n/parser-default": ">=1.0.0"
   },
   "devDependencies": {
-    "@types/jest": "^27.0.3",
+    "@types/jest": "^29.5.2",
     "@typescript-eslint/eslint-plugin": "^5.7.0",
     "@typescript-eslint/parser": "^5.7.0",
     "eslint": "^8.4.1",
     "eslint-config-airbnb-typescript": "^17.0.0",
     "eslint-plugin-import": "^2.25.3",
-    "jest": "^27.4.5",
+    "jest": "^29.6.0",
     "pre-commit": "^1.2.2",
-    "ts-jest": "^27.1.2",
-    "tsup": "^5.11.13",
-    "typescript": "^4.5.4"
+    "ts-jest": "^29.1.1",
+    "tsup": "^7.1.0",
+    "typescript": "^5.1.6"
   }
 }