@warkypublic/svelix 0.1.15 → 0.1.17

package/dist/components/GlobalStateStore/GlobalStateStore.d.ts

@@ -1,5 +1,5 @@
 import { type Readable } from "svelte/store";
-import type { GlobalStateStoreType } from "./GlobalStateStore.types";
+import type { GlobalStateStoreType, SupportedLanguage } from "./GlobalStateStore.types";
 type PartialUpdater = Partial<GlobalStateStoreType> | ((state: GlobalStateStoreType) => Partial<GlobalStateStoreType>);
 type GlobalStateStoreApi = {
     getState: () => GlobalStateStoreType;
@@ -7,6 +7,7 @@ type GlobalStateStoreApi = {
     subscribe: (run: (value: GlobalStateStoreType) => void) => () => void;
 };
 declare const GlobalStateStore: GlobalStateStoreApi;
+declare const languageStore: Readable<SupportedLanguage>;
 declare function useGlobalStateStore(): Readable<GlobalStateStoreType>;
 declare function useGlobalStateStore<T>(selector: (state: GlobalStateStoreType) => T): Readable<T>;
 declare const setApiURL: (url: string) => void;
@@ -15,5 +16,6 @@ declare const getAuthToken: () => string;
 declare const isLoggedIn: () => boolean;
 declare const setAuthToken: (token: string) => void;
 declare const GetGlobalState: () => GlobalStateStoreType;
+declare const setLanguage: (lang: SupportedLanguage) => void;
 export type { GlobalStateStoreApi };
-export { getApiURL, getAuthToken, GetGlobalState, GlobalStateStore, isLoggedIn, setApiURL, setAuthToken, useGlobalStateStore, };
+export { getApiURL, getAuthToken, GetGlobalState, GlobalStateStore, isLoggedIn, languageStore, setApiURL, setAuthToken, setLanguage, useGlobalStateStore, };

package/dist/components/GlobalStateStore/GlobalStateStore.i18n.d.ts

@@ -0,0 +1,35 @@
+import { type Readable } from 'svelte/store';
+import type { SupportedLanguage } from './GlobalStateStore.types';
+type TranslationMap = Record<SupportedLanguage, string> & Record<string, string>;
+type TranslationDictionary = Record<string, TranslationMap>;
+/** Subscribes to an external language store and keeps the internal language in sync. Call once at app initialisation. */
+declare const initTranslation: (langStore: Readable<SupportedLanguage>) => void;
+/** Merges entries into the global dictionary. Global translations persist for the lifetime of the app. */
+declare const loadTranslations: (dict: TranslationDictionary) => void;
+/** Clears all global translations. */
+declare const clearTranslations: () => void;
+/** Replaces the page dictionary entirely. Call on page navigation to swap in translations for the new page. */
+declare const loadPageTranslations: (dict: TranslationDictionary) => void;
+/** Merges entries into the global dictionary. Useful for incrementally adding global translations without a full reload. */
+declare const appendTranslations: (dict: TranslationDictionary) => void;
+/** Merges entries into the current page dictionary without replacing it. Useful when a page loads translations in multiple steps. */
+declare const appendPageTranslations: (dict: TranslationDictionary) => void;
+/** Clears all page translations. */
+declare const clearPageTranslations: () => void;
+/**
+ * Resolves a translation synchronously using the current language.
+ * Accepts a dictionary key or an inline `TranslationMap`.
+ * Page translations take priority over global translations.
+ * Falls back to `en`, then to the key itself if no match is found.
+ */
+declare function _T(key: string): string;
+declare function _T(map: TranslationMap): string;
+/**
+ * Reactive Svelte store that exposes a translate function.
+ * Re-derives whenever the language or either dictionary changes.
+ * Accepts a dictionary key or an inline `TranslationMap`.
+ * Page translations take priority over global translations.
+ */
+declare const t: Readable<(keyOrMap: string | TranslationMap) => string>;
+export type { TranslationDictionary, TranslationMap };
+export { _T, appendPageTranslations, appendTranslations, clearPageTranslations, clearTranslations, initTranslation, loadPageTranslations, loadTranslations, t };

package/dist/components/GlobalStateStore/GlobalStateStore.i18n.js

@@ -0,0 +1,52 @@
+import { derived, get, writable } from 'svelte/store';
+const _langStore = writable('en');
+const _globalDictStore = writable({});
+const _pageDictStore = writable({});
+/** Subscribes to an external language store and keeps the internal language in sync. Call once at app initialisation. */
+const initTranslation = (langStore) => {
+    langStore.subscribe((lang) => _langStore.set(lang));
+};
+/** Merges entries into the global dictionary. Global translations persist for the lifetime of the app. */
+const loadTranslations = (dict) => {
+    _globalDictStore.update((current) => ({ ...current, ...dict }));
+};
+/** Clears all global translations. */
+const clearTranslations = () => {
+    _globalDictStore.set({});
+};
+/** Replaces the page dictionary entirely. Call on page navigation to swap in translations for the new page. */
+const loadPageTranslations = (dict) => {
+    _pageDictStore.set(dict);
+};
+/** Merges entries into the global dictionary. Useful for incrementally adding global translations without a full reload. */
+const appendTranslations = (dict) => {
+    _globalDictStore.update((current) => ({ ...current, ...dict }));
+};
+/** Merges entries into the current page dictionary without replacing it. Useful when a page loads translations in multiple steps. */
+const appendPageTranslations = (dict) => {
+    _pageDictStore.update((current) => ({ ...current, ...dict }));
+};
+/** Clears all page translations. */
+const clearPageTranslations = () => {
+    _pageDictStore.set({});
+};
+const _resolve = (lang, globalDict, pageDict, keyOrMap) => {
+    if (typeof keyOrMap === 'string') {
+        const map = pageDict[keyOrMap] ?? globalDict[keyOrMap];
+        if (!map)
+            return keyOrMap;
+        return map[lang] ?? map['en'] ?? keyOrMap;
+    }
+    return keyOrMap[lang] ?? keyOrMap['en'];
+};
+function _T(keyOrMap) {
+    return _resolve(get(_langStore), get(_globalDictStore), get(_pageDictStore), keyOrMap);
+}
+/**
+ * Reactive Svelte store that exposes a translate function.
+ * Re-derives whenever the language or either dictionary changes.
+ * Accepts a dictionary key or an inline `TranslationMap`.
+ * Page translations take priority over global translations.
+ */
+const t = derived([_langStore, _globalDictStore, _pageDictStore], ([lang, globalDict, pageDict]) => (keyOrMap) => _resolve(lang, globalDict, pageDict, keyOrMap));
+export { _T, appendPageTranslations, appendTranslations, clearPageTranslations, clearTranslations, initTranslation, loadPageTranslations, loadTranslations, t };

package/dist/components/GlobalStateStore/GlobalStateStore.js

@@ -1,4 +1,5 @@
 import { derived, get, writable } from "svelte/store";
+import { initTranslation } from "./GlobalStateStore.i18n";
 import { loadStorage, saveStorage } from "./GlobalStateStore.utils";
 const createInitialState = () => ({
     initialized: false,
@@ -32,6 +33,7 @@ const createInitialState = () => ({
     },
     user: {
         guid: "",
+        language: "en",
         username: "",
     },
 });
@@ -303,6 +305,9 @@ const createGlobalStateStore = () => {
                 topBar: { ...state.layout.topBar, ...updates },
             },
         })),
+        setLanguage: (lang) => setGlobalState((state) => ({
+            user: { ...state.user, language: lang },
+        })),
         setUser: (updates) => setGlobalState((state) => ({
             user: { ...state.user, ...updates },
         })),
@@ -352,6 +357,8 @@ const GlobalStateStore = createGlobalStateStore();
 const GlobalStateStoreReadable = {
     subscribe: GlobalStateStore.subscribe,
 };
+const languageStore = derived(GlobalStateStoreReadable, (state) => state.user.language ?? "en");
+initTranslation(languageStore);
 function useGlobalStateStore(selector) {
     if (!selector) {
         return GlobalStateStoreReadable;
@@ -376,4 +383,7 @@ const setAuthToken = (token) => {
 const GetGlobalState = () => {
     return GlobalStateStore.getState();
 };
-export { getApiURL, getAuthToken, GetGlobalState, GlobalStateStore, isLoggedIn, setApiURL, setAuthToken, useGlobalStateStore, };
+const setLanguage = (lang) => {
+    GlobalStateStore.getState().setLanguage(lang);
+};
+export { getApiURL, getAuthToken, GetGlobalState, GlobalStateStore, isLoggedIn, languageStore, setApiURL, setAuthToken, setLanguage, useGlobalStateStore, };

package/dist/components/GlobalStateStore/GlobalStateStore.types.d.ts

@@ -41,6 +41,7 @@ interface GlobalStateActions {
     setRightBar: (updates: Partial<BarState>) => void;
     setSession: (updates: Partial<SessionState>) => void;
     setTopBar: (updates: Partial<BarState>) => void;
+    setLanguage: (lang: SupportedLanguage) => void;
     setUser: (updates: Partial<UserState>) => void;
 }
 interface GlobalStateStoreType extends GlobalState, GlobalStateActions {
@@ -107,6 +108,7 @@ interface SessionState {
     meta?: Record<string, any>;
     parameters?: Record<string, any>;
 }
+type SupportedLanguage = 'af' | 'en';
 interface ThemeSettings {
     darkMode?: boolean;
     name?: string;
@@ -117,6 +119,7 @@ interface UserState {
     fullNames?: string;
     guid?: string;
     isAdmin?: boolean;
+    language?: SupportedLanguage;
     noticeMsg?: string;
     parameters?: Record<string, any>;
     rid?: number;
@@ -124,4 +127,4 @@ interface UserState {
     username: string;
 }
 type PersistedGlobalState = Pick<GlobalState, 'layout' | 'navigation' | 'owner' | 'program' | 'session' | 'user'>;
-export type { BarState, GlobalState, GlobalStateActions, GlobalStateStoreType, LayoutState, MenuItem, NavigationState, OwnerState, PageInfo, PersistedGlobalState, ProgramState, SessionState, ThemeSettings, UserState };
+export type { BarState, GlobalState, GlobalStateActions, GlobalStateStoreType, LayoutState, MenuItem, NavigationState, OwnerState, PageInfo, PersistedGlobalState, ProgramState, SessionState, SupportedLanguage, ThemeSettings, UserState };

package/dist/components/GlobalStateStore/index.d.ts

@@ -1,4 +1,6 @@
 export * from "./GlobalStateStore";
+export { _T, appendPageTranslations, appendTranslations, clearPageTranslations, clearTranslations, loadPageTranslations, loadTranslations, t } from "./GlobalStateStore.i18n";
+export type { TranslationDictionary, TranslationMap } from "./GlobalStateStore.i18n";
 export type * from "./GlobalStateStore.types";
 export { default as GlobalStateStoreProvider } from "./GlobalStateStoreProvider.svelte";
 export { useGlobalStateStoreContext } from "./GlobalStateStoreContext";

package/dist/components/GlobalStateStore/index.js

@@ -1,3 +1,4 @@
 export * from "./GlobalStateStore";
+export { _T, appendPageTranslations, appendTranslations, clearPageTranslations, clearTranslations, loadPageTranslations, loadTranslations, t } from "./GlobalStateStore.i18n";
 export { default as GlobalStateStoreProvider } from "./GlobalStateStoreProvider.svelte";
 export { useGlobalStateStoreContext } from "./GlobalStateStoreContext";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@warkypublic/svelix",
-  "version": "0.1.15",
+  "version": "0.1.17",
   "description": "Svelte 5 component library with Skeleton UI and Tailwind CSS",
   "license": "Apache-2.0",
   "exports": {