@reforgium/presentia 2.0.0 → 2.1.1

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "2.0.0",
+  "version": "2.1.1",
   "name": "@reforgium/presentia",
   "description": "Angular infrastructure library for i18n, route-aware namespace preload, theming, adaptive breakpoints, route state, and SEO",
   "author": "rtommievich",
@@ -65,7 +65,7 @@
     "@angular/core": ">=18.0.0",
     "@angular/platform-browser": ">=18.0.0",
     "@angular/router": ">=18.0.0",
-    "@reforgium/internal": ">=1.2.0",
+    "@reforgium/internal": ">=2.0.0",
     "rxjs": ">=7.0.0"
   },
   "module": "fesm2022/reforgium-presentia.mjs",

package/types/reforgium-presentia.d.ts

@@ -1,7 +1,7 @@
 import * as _angular_core from '@angular/core';
 import { InjectionToken, Signal, PipeTransform, EnvironmentProviders } from '@angular/core';
 import * as _reforgium_internal from '@reforgium/internal';
-import { Devices, Langs, Themes as Themes$1 } from '@reforgium/internal';
+import { Devices, Langs, StorageInterface, Themes as Themes$1, StorageStrategy } from '@reforgium/internal';
 import { HttpHeaders, HttpParams, HttpContext } from '@angular/common/http';
 
 /** Breakpoints for different device types */
@@ -250,10 +250,7 @@ type LangRouteNamespacePreloadConfig = {
  * Adapter for custom persistence of language/theme selection.
  * Implement this interface to replace the default `localStorage` storage.
  */
-type PersistenceAdapter = {
-    getItem(key: string): string | null;
-    setItem(key: string, value: string): void;
-};
+type PersistenceAdapter = StorageInterface<string, string>;
 /**
  * Describes a failed namespace load attempt.
  * Exposed via `LangService.errors()` signal.
@@ -328,6 +325,7 @@ declare const LANG_MISSING_KEY_HANDLER: InjectionToken<LangMissingKeyHandler>;
  * { provide: LANG_PERSISTENCE_ADAPTER, useValue: sessionStorageAdapter }
  * ```
  */
+declare const defaultLangPersistenceAdapter: StorageInterface<string, string>;
 declare const LANG_PERSISTENCE_ADAPTER: InjectionToken<PersistenceAdapter>;
 
 /**
@@ -378,6 +376,7 @@ declare class LangService {
     private readonly config;
     private readonly http;
     private readonly isBrowser;
+    private readonly persistence;
     private readonly missingKeyHandler;
     private readonly routeNamespaceDiagnostics;
     private readonly supportedLangSet;
@@ -389,7 +388,7 @@ declare class LangService {
      * - If `config.kgValue` is not defined, the property will return the default value 'kg'.
      * - For other languages (e.g. `ru`, `en`) returns source language as-is.
      */
-    readonly currentLang: Signal<(string & {}) | "ru" | "kg" | "en" | "ky">;
+    readonly currentLang: Signal<"ru" | "kg" | "en" | (string & {}) | "ky">;
     /**
      * Extracts readonly value from private property `#lang` and assigns it to `innerLangVal`.
      * Expected that property `#lang` has `asReadonly` method that returns immutable representation.
@@ -718,7 +717,7 @@ declare const THEME_CONFIG: InjectionToken<ThemeConfig>;
 /**
  * @deprecated Prefer configuring theme persistence through `providePresentia({ theme: { persistence... } })`.
  */
-declare const defaultThemePersistenceAdapter: PersistenceAdapter;
+declare const defaultThemePersistenceAdapter: StorageInterface<string, string>;
 /**
  * DI token for the persistence adapter used by `ThemeService`
  * to store and retrieve the selected theme (default key: `'theme'`).
@@ -841,6 +840,12 @@ type PresentiaLangConfig = {
         maxBatchSize?: number;
     };
     cache?: LangNamespaceCacheConfig;
+    persistence?: StorageStrategy | 'none';
+    storage?: StorageInterface<string, string>;
+    /**
+     * @deprecated Prefer `storage`.
+     */
+    persistenceAdapter?: PersistenceAdapter;
     diagnostics?: {
         lateNamespaceLoads?: boolean;
     };
@@ -849,7 +854,11 @@ type PresentiaLangConfig = {
 type PresentiaThemeConfig = {
     registry?: readonly Theme[];
     defaultTheme?: ThemeConfig['defaultTheme'];
-    persistence?: 'localStorage' | 'none';
+    persistence?: StorageStrategy | 'none';
+    storage?: StorageInterface<string, string>;
+    /**
+     * @deprecated Prefer `storage`.
+     */
     persistenceAdapter?: PersistenceAdapter;
     dom?: {
         strategy?: 'root-class' | 'data-attribute';
@@ -1067,6 +1076,6 @@ declare class RouteNamespaceDiagnosticsService {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<RouteNamespaceDiagnosticsService>;
 }
 
-export { AdaptiveService, DEVICE_BREAKPOINTS, IfDeviceDirective, LANG_CONFIG, LANG_MISSING_KEY_HANDLER, LANG_PERSISTENCE_ADAPTER, LANG_PIPE_CONFIG, LangDirective, LangPipe, LangService, PRESENTIA_ROUTE_NAMESPACES_DATA_KEY, RouteNamespaceDiagnosticsService, RouteWatcher, SeoRouteListener, SeoService, THEME_CONFIG, THEME_PERSISTENCE_ADAPTER, ThemeService, darkThemePrefix, defaultBreakpoints, defaultThemeConfig, defaultThemePersistenceAdapter, innerLangVal, providePresentia, providePresentiaRouteNamespacePreload, provideReInit, themes };
+export { AdaptiveService, DEVICE_BREAKPOINTS, IfDeviceDirective, LANG_CONFIG, LANG_MISSING_KEY_HANDLER, LANG_PERSISTENCE_ADAPTER, LANG_PIPE_CONFIG, LangDirective, LangPipe, LangService, PRESENTIA_ROUTE_NAMESPACES_DATA_KEY, RouteNamespaceDiagnosticsService, RouteWatcher, SeoRouteListener, SeoService, THEME_CONFIG, THEME_PERSISTENCE_ADAPTER, ThemeService, darkThemePrefix, defaultBreakpoints, defaultLangPersistenceAdapter, defaultThemeConfig, defaultThemePersistenceAdapter, innerLangVal, providePresentia, providePresentiaRouteNamespacePreload, provideReInit, themes };
 export type { AppConfig, BaseTheme, DeviceBreakpoints, LangBatchRequestBuilder, LangBatchRequestContext, LangBatchResponseAdapter, LangBatchResponseContext, LangDirectiveConfig, LangDirectiveMode, LangDto, LangHttpRequestOptions, LangKey, LangKeyRegistry, LangMissingKeyHandler, LangModel, LangNamespaceCacheConfig, LangParamValue, LangParams, LangPipeConfig, LangRequestBuilder, LangRequestContext, LangRequestOptionsFactory, LangResponseAdapter, LangResponseContext, LangRouteNamespaceManifest, LangRouteNamespacePreloadConfig, LangRouteNamespacePreloadMergeStrategy, LangRouteNamespacePreloadMode, LoadNamespaceError, LocaleConfig, OgType, PersistenceAdapter, PresentiaAdaptiveConfig, PresentiaConfig, PresentiaLangConfig, PresentiaThemeConfig, RouteWatcherReadStrategy, RouteWatcherState, Theme, ThemeConfig, Themes, TwitterCardType };
 //# sourceMappingURL=reforgium-presentia.d.ts.map