@reforgium/presentia 1.4.3 → 1.5.0

package/bin/presentia-gen-lang-keys.mjs

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 import fs from 'node:fs';
 import path from 'node:path';
 

package/fesm2022/reforgium-presentia.mjs

@@ -4,11 +4,10 @@ import { getChainedValue, TRANSLATION, SELECTED_LANG, CHANGE_LANG, SELECTED_THEM
 import { BreakpointObserver } from '@angular/cdk/layout';
 import { isPlatformBrowser, DOCUMENT } from '@angular/common';
 import { takeUntilDestroyed } from '@angular/core/rxjs-interop';
-import { fromEvent, debounceTime, firstValueFrom, tap, filter as filter$1 } from 'rxjs';
 import { HttpClient } from '@angular/common/http';
+import { firstValueFrom, tap } from 'rxjs';
 import { Title, Meta } from '@angular/platform-browser';
 import { Router, ActivatedRoute, NavigationEnd } from '@angular/router';
-import { filter } from 'rxjs/operators';
 
 /**
  * Default breakpoints for device type detection.
@@ -111,6 +110,7 @@ class AdaptiveService {
     destroyRef = inject(DestroyRef);
     breakpointObserver = inject(BreakpointObserver);
     isBrowser = isPlatformBrowser(inject(PLATFORM_ID));
+    resizeDebounceId = null;
     constructor() {
         if (!this.isBrowser) {
             this.#device.set('desktop');
@@ -129,14 +129,23 @@ class AdaptiveService {
                 this.#device.set(device);
             }
         });
-        fromEvent(window, 'resize')
-            .pipe(debounceTime(100))
-            .pipe(takeUntilDestroyed(this.destroyRef))
-            .subscribe(() => {
-            const width = window.innerWidth;
-            const height = window.innerHeight;
-            this.#width() !== width && this.#width.set(width);
-            this.#height() !== height && this.#height.set(height);
+        const onResize = () => {
+            this.resizeDebounceId !== null && clearTimeout(this.resizeDebounceId);
+            this.resizeDebounceId = setTimeout(() => {
+                this.resizeDebounceId = null;
+                const width = window.innerWidth;
+                const height = window.innerHeight;
+                this.#width() !== width && this.#width.set(width);
+                this.#height() !== height && this.#height.set(height);
+            }, 100);
+        };
+        window.addEventListener('resize', onResize, { passive: true });
+        this.destroyRef.onDestroy(() => {
+            window.removeEventListener('resize', onResize);
+            if (this.resizeDebounceId !== null) {
+                clearTimeout(this.resizeDebounceId);
+                this.resizeDebounceId = null;
+            }
         });
     }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.1", ngImport: i0, type: AdaptiveService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
@@ -325,6 +334,9 @@ class LangService {
         }
         return baseValue;
     }
+    has(query) {
+        return this.getChainedValue(query) !== undefined;
+    }
     observe(query, params) {
         const [ns] = query.split('.');
         if (!this.isNamespaceLoaded(ns)) {
@@ -931,6 +943,7 @@ const LANG_PIPE_CONFIG = new InjectionToken('RE_LANG_PIPE_CONFIG');
  */
 class LangPipe {
     cache = new Map();
+    warnedUnresolved = new Set();
     lang = inject(LangService);
     injector = inject(Injector);
     config;
@@ -977,6 +990,9 @@ class LangPipe {
                 return placeholder;
             }
         }
+        if (ns && this.lang.isNamespaceLoaded(ns) && !this.lang.has(query)) {
+            this.warnUnresolvedKey(query);
+        }
         return value;
     }
     makeKey(query, params) {
@@ -997,6 +1013,17 @@ class LangPipe {
             this.cache.delete(firstKey);
         }
     }
+    warnUnresolvedKey(query) {
+        if (typeof ngDevMode === 'undefined') {
+            return;
+        }
+        if (this.warnedUnresolved.has(query)) {
+            return;
+        }
+        this.warnedUnresolved.add(query);
+        // eslint-disable-next-line no-console
+        console.warn(`LangPipe: namespace loaded but key "${query}" is unresolved`);
+    }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.1", ngImport: i0, type: LangPipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe });
     static ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "21.1.1", ngImport: i0, type: LangPipe, isStandalone: true, name: "lang", pure: false });
 }
@@ -1111,7 +1138,7 @@ class ThemeService {
                 this.#theme.set(this.themeDefault);
                 return;
             }
-            const theme = localStorage.getItem('theme') || this.themeDefault;
+            const theme = this.resolveTheme(localStorage.getItem('theme'));
             this.switch(theme);
         });
         effect(() => {
@@ -1129,14 +1156,18 @@ class ThemeService {
      * @param theme — explicit theme value (`'light'` or `'dark'`).
      */
     switch(theme) {
-        const newTheme = theme ?? (this.#theme() === themes.light ? themes.dark : themes.light);
+        const requestedTheme = theme ? this.resolveTheme(theme) : undefined;
+        const newTheme = requestedTheme ?? (this.#theme() === themes.light ? themes.dark : themes.light);
         if (this.isBrowser) {
-            const html = this.document.querySelector('html');
+            const html = this.document.documentElement;
             newTheme === themes.dark && html.classList.add(this.darkPrefix);
             newTheme === themes.light && html.classList.remove(this.darkPrefix);
         }
         this.#theme.set(newTheme);
     }
+    resolveTheme(theme) {
+        return theme === themes.dark ? themes.dark : themes.light;
+    }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.1", ngImport: i0, type: ThemeService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
     static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.1.1", ngImport: i0, type: ThemeService, providedIn: 'root' });
 }
@@ -1151,9 +1182,13 @@ function provideReInit(config) {
     return makeEnvironmentProviders([
         { provide: TRANSLATION, deps: [LangService], useFactory: (ls) => ls },
         { provide: SELECTED_LANG, deps: [LangService], useFactory: (ls) => ls[innerLangVal] },
-        { provide: CHANGE_LANG, deps: [LangService], useFactory: (ls) => ls.setLang },
+        { provide: CHANGE_LANG, deps: [LangService], useFactory: (ls) => (lang) => ls.setLang(lang) },
         { provide: SELECTED_THEME, deps: [ThemeService], useFactory: (ls) => ls.theme },
-        { provide: CHANGE_THEME, deps: [ThemeService], useFactory: (ls) => ls.switch },
+        {
+            provide: CHANGE_THEME,
+            deps: [ThemeService],
+            useFactory: (ls) => (theme) => ls.switch(theme),
+        },
         { provide: CURRENT_DEVICE, deps: [AdaptiveService], useFactory: (ls) => ls.device },
         { provide: DEVICE_BREAKPOINTS, useValue: config.breakpoints || defaultBreakpoints },
         { provide: THEME_CONFIG, useValue: config.theme || defaultThemeConfig },
@@ -1292,10 +1327,11 @@ class SeoService {
         }
     }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.1", ngImport: i0, type: SeoService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
-    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.1.1", ngImport: i0, type: SeoService });
+    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.1.1", ngImport: i0, type: SeoService, providedIn: 'root' });
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.1", ngImport: i0, type: SeoService, decorators: [{
-            type: Injectable
+            type: Injectable,
+            args: [{ providedIn: 'root' }]
         }] });
 
 /**
@@ -1321,6 +1357,8 @@ class SeoRouteListener {
     seo = inject(SeoService);
     ar = inject(ActivatedRoute);
     destroyRef = inject(DestroyRef);
+    initialized = false;
+    baseUrl = '';
     /**
      * Initializes the route listener to monitor navigation events and update SEO metadata.
      * Subscribes to router NavigationEnd events and automatically unsubscribes on component destruction.
@@ -1329,10 +1367,11 @@ class SeoRouteListener {
      *                  Trailing slashes will be removed automatically.
      */
     init(baseUrl) {
+        this.baseUrl = baseUrl.replace(/\/+$/, '');
         const applyRouteSeo = () => {
             const route = this.deepest(this.ar);
             const data = route.snapshot.data;
-            const url = data.canonical ?? baseUrl.replace(/\/+$/, '') + this.router.url;
+            const url = data.canonical ?? this.baseUrl + this.router.url;
             data.title && this.seo.setTitle(data.title);
             data.description && this.seo.setDescription(data.description);
             data.twitter && this.seo.setTwitter(data.twitter);
@@ -1347,9 +1386,16 @@ class SeoRouteListener {
             });
         };
         applyRouteSeo();
-        this.router.events
-            .pipe(filter((e) => e instanceof NavigationEnd), takeUntilDestroyed(this.destroyRef))
-            .subscribe(() => applyRouteSeo());
+        if (this.initialized) {
+            return;
+        }
+        this.initialized = true;
+        const subscription = this.router.events.subscribe((event) => {
+            if (event instanceof NavigationEnd) {
+                applyRouteSeo();
+            }
+        });
+        this.destroyRef.onDestroy(() => subscription.unsubscribe());
     }
     /**
      * Recursively finds the deepest (most nested) activated route in the route tree.
@@ -1415,16 +1461,20 @@ class RouteWatcher {
         const read = () => {
             const snap = this.deepestSnapshot();
             const url = snapshotFullPath(snap);
-            !deepEqual(snap.params, this.#params()) && this.#params.set(snap.params);
+            const params = snapshotMergedParams(snap);
+            !deepEqual(params, this.#params()) && this.#params.set(params);
             !deepEqual(snap.queryParams, this.#query()) && this.#query.set(snap.queryParams);
             !deepEqual(snap.data, this.#data()) && this.#data.set(snap.data);
             this.#url() !== url && this.#url.set(url);
             this.#fragment() !== snap.fragment && this.#fragment.set(snap.fragment ?? null);
         };
         read();
-        this.router.events
-            .pipe(filter$1((e) => e instanceof NavigationEnd), takeUntilDestroyed(this.destroyRef))
-            .subscribe(() => read());
+        const subscription = this.router.events.subscribe((event) => {
+            if (event instanceof NavigationEnd) {
+                read();
+            }
+        });
+        this.destroyRef.onDestroy(() => subscription.unsubscribe());
     }
     /** Convenient selector for a data key with type-safe casting */
     selectData(key) {
@@ -1456,6 +1506,10 @@ function snapshotFullPath(snap) {
         .filter(Boolean)
         .join('/');
 }
+/** Merges params from root to the deepest snapshot (child keys override parent). */
+function snapshotMergedParams(snap) {
+    return snap.pathFromRoot.reduce((acc, route) => ({ ...acc, ...route.params }), {});
+}
 
 /**
  * Generated bundle index. Do not edit.

package/package.json

@@ -1,7 +1,7 @@
 {
-  "version": "1.4.3",
+  "version": "1.5.0",
   "name": "@reforgium/presentia",
-  "description": "reforgium State modules",
+  "description": "Angular app infrastructure for localization, theme, adaptive behavior, routes, and SEO",
   "author": "rtommievich",
   "license": "MIT",
   "type": "module",
@@ -24,8 +24,10 @@
   },
   "keywords": [
     "reforgium",
-    "state",
-    "store",
+    "infrastructure",
+    "i18n",
+    "theme",
+    "seo",
     "signal",
     "angular"
   ],

package/types/reforgium-presentia.d.ts

@@ -101,6 +101,7 @@ declare class AdaptiveService {
     private destroyRef;
     private breakpointObserver;
     private isBrowser;
+    private resizeDebounceId;
     constructor();
     static ɵfac: i0.ɵɵFactoryDeclaration<AdaptiveService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<AdaptiveService>;
@@ -347,6 +348,8 @@ declare class LangService {
      */
     get(query: LangKey, params?: LangParams): string;
     get(query: string, params?: LangParams): string;
+    has(query: LangKey): boolean;
+    has(query: string): boolean;
     /**
      * Observes changes to a specified translation key and dynamically computes its value.
      *
@@ -529,6 +532,7 @@ declare class LangDirective {
  */
 declare class LangPipe implements PipeTransform {
     private readonly cache;
+    private readonly warnedUnresolved;
     private readonly lang;
     private readonly injector;
     private readonly config;
@@ -538,6 +542,7 @@ declare class LangPipe implements PipeTransform {
     transform(query: string | null | undefined, params?: LangParams | null): string;
     private makeKey;
     private evictIfNeeded;
+    private warnUnresolvedKey;
     static ɵfac: i0.ɵɵFactoryDeclaration<LangPipe, never>;
     static ɵpipe: i0.ɵɵPipeDeclaration<LangPipe, "lang", true>;
 }
@@ -673,6 +678,7 @@ declare class ThemeService {
      * @param theme — explicit theme value (`'light'` or `'dark'`).
      */
     switch(theme?: Themes): void;
+    private resolveTheme;
     static ɵfac: i0.ɵɵFactoryDeclaration<ThemeService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<ThemeService>;
 }
@@ -802,6 +808,8 @@ declare class SeoRouteListener {
     private seo;
     private ar;
     private destroyRef;
+    private initialized;
+    private baseUrl;
     /**
      * Initializes the route listener to monitor navigation events and update SEO metadata.
      * Subscribes to router NavigationEnd events and automatically unsubscribes on component destruction.