@npm-questionpro/wick-ui-lib 2.3.0 → 2.5.0

package/dist/translate/WuTranslateContext.d.ts

@@ -13,26 +13,23 @@ interface IWuTranslateContextProps {
     locale: string;
     setLocale: (locale: string) => void;
     isLoading: boolean;
+    /** `true` only while an `addExtraKeys` delta POST is in flight. Use to gate a section without blanking the whole page. */
+    deltaLoading: boolean;
     isRtl: boolean;
     characterSet: string;
-    /** Reactive alternative to `wt()`. Use inside components to avoid stale values on reload. */
-    translate: (key: string) => string;
+    /** Register runtime/BE-driven strings for translation. Accumulated for the session; sets `deltaLoading` while fetching. */
+    addExtraKeys: (keys: string[]) => void;
 }
 export declare const useTranslate: () => IWuTranslateContextProps;
-/**
- * Reactive translate hook for use inside components.
- * Re-renders the component when the dictionary updates.
- *
- * @example
- * const t = useWt()
- * return <button>{t('Submit')}</button>
- */
+/** Reactive translate hook. Re-renders on dictionary updates. */
 export declare const useWt: () => ((key: string) => string);
 export interface IWuTranslateProviderProps {
     children: React.ReactNode;
     defaultLocale?: string;
     baseApi?: string;
     keys?: string;
+    /** localStorage cache TTL for fetched dictionaries, in ms. Defaults to 1 hour. */
+    cacheTtlMs?: number;
 }
 export declare const WuTranslateProvider: React.FC<IWuTranslateProviderProps>;
 export {};

package/dist/translate/wtCache.d.ts

@@ -0,0 +1,15 @@
+/** localStorage cache for translated dictionaries. TTL-based, keyed by keysUrl+locale. */
+export declare const DEFAULT_WT_CACHE_TTL_MS: number;
+export interface IWtCacheEntry {
+    data: Record<string, string>;
+    isRtl: boolean;
+    characterSet: string;
+    ts: number;
+}
+/** Returns cached entry if present and not expired, else null. Never throws (storage may be disabled/full). */
+export declare function getWtCache(keysUrl: string, locale: string, ttlMs?: number): IWtCacheEntry | null;
+/** Full write — call only on a successful base fetch. Refreshes `ts`, restarting the 1hr window. */
+export declare function setWtCache(keysUrl: string, locale: string, data: Record<string, string>, isRtl: boolean, characterSet: string): void;
+/** Merges extra translated keys into an existing cache entry without touching `ts`. Call only on a
+ * successful delta fetch. No-op if no entry exists yet (base fetch hasn't cached anything to patch). */
+export declare function patchWtCacheData(keysUrl: string, locale: string, extra: Record<string, string>): void;