@esfaenza/localizations 16.2.29 → 17.3.0

package/lib/localizations.service.d.ts

@@ -1,74 +1,74 @@
-import { Injector, Type } from '@angular/core';
-import * as i0 from "@angular/core";
-/**
- * Classe di localizzazione estendibile che permette di specificare le proprie localizzazioni e comunque rendere disponibili le localizzazioni globali
- */
-export declare class LocalizationService {
-    private injector;
-    /**
-     * Cache di tutte le localizzazioni disonibili all'interno di questa classe
-     */
-    private TranslationCache;
-    Locale: string;
-    SmallLocale: string;
-    private baseLocalization;
-    private onMissing;
-    private Persistor;
-    private LocalePersistor;
-    /**
-     * Costruttore
-     *
-     * @param {string} Locale Locale da utilizzare nel momento che questo servizio richiede le traduzioni
-     * @param {baseLocalization} baseLocalization Classe base di localizzazione già fornita a livello di root dalla libreria stessa.
-     * È sufficiente iniettarla nell'eventuale costruttore che estende questa classe e passarla as-is
-     */
-    constructor(injector: Injector);
-    /**
-     * Genera un nuovo servizio di localizzazione data una classe in modo che le localizzazioni non siano più solo da provide-are a livello di componente, ma possano
-     * anche essere create al volo dal componente/servizio/qualsiasicosa che le deve utilizzare
-     *
-     * @param {Type<LocalizationService>} lcst Classe da usare per crare il nuovo servizio di localizzazione
-     */
-    generateFromType(lcst: Type<LocalizationService>): LocalizationService;
-    /**
-     * Imposta la localizzazione di un token all'interno della **TranslationCache**
-     *
-     * @param {string} direction Direzione della traduzione, rappresenta la lingua base in cui aspettarsi il testo e le varie lingue in cui viene tradotta.
-     * Ad esempio, "en->it" indica che il parametro **left** è valido per le localizzazioni in inglese, mentre nell'elemento 0 del parametro **right**
-     * è presente l'unica traduzione in italiano, per definire più traduzioni sul lato destro della freccia bisogna concatenarle con la virgola, ad esempio "en->it,jp,ecc"
-     * @param {string} token Nome del token
-     * @param {string} left Valore del token per la lingua specificata nel lato immediatamente sinistro alla freccia del parametro **direction**
-     * @param {string} right Array con i valori facenti riferimento all'N-esima lingua del lato destro del parametro **direction**
-     */
-    protected setToken(direction: string, token: string, left: string, right: string[]): void;
-    /**
-     * Imposta la localizzazione di una frase all'interno della **TranslationCache**
-     *
-     * @param {string} direction Direzione della traduzione, rappresenta la lingua base in cui aspettarsi il testo e le varie lingue in cui viene tradotta.
-     * Ad esempio, "en->it" indica che il parametro **left** è valido per le localizzazioni in inglese, mentre nell'elemento 0 del parametro **right**
-     * è presente l'unica traduzione in italiano, per definire più traduzioni sul lato destro della freccia bisogna concatenarle con la virgola, ad esempio "en->it,jp,ecc"
-     * @param {string} left Valore della frase per la lingua specificata nel lato immediatamente sinistro alla freccia del parametro **direction**
-     * @param {string} right Array con i valori facenti riferimento all'N-esima lingua del lato destro del parametro **direction**
-     */
-    protected set(direction: string, left: string, right: string[]): void;
-    /**
-     * Localizza un token
-     *
-     * @param {string} text Il token da localizzare
-     *
-     * @returns {string} Token localizzato
-     */
-    token(text: string): string;
-    /**
-     * Localizza una frase
-     *
-     * @param {string} text Frase da localizzare
-     * @param {boolean} allowtokens Indica se la frase **text** potrebbe essere un token o no
-     *
-     * @returns {string} Frase localizzata
-     */
-    loc(text: string, allowtokens?: boolean): string;
-    changeLocale(newLocale: string): Promise<void>;
-    static ɵfac: i0.ɵɵFactoryDeclaration<LocalizationService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<LocalizationService>;
-}
+import { Injector, Type } from '@angular/core';
+import * as i0 from "@angular/core";
+/**
+ * Classe di localizzazione estendibile che permette di specificare le proprie localizzazioni e comunque rendere disponibili le localizzazioni globali
+ */
+export declare class LocalizationService {
+    private injector;
+    /**
+     * Cache di tutte le localizzazioni disonibili all'interno di questa classe
+     */
+    private TranslationCache;
+    Locale: string;
+    SmallLocale: string;
+    private baseLocalization;
+    private onMissing;
+    private Persistor;
+    private LocalePersistor;
+    /**
+     * Costruttore
+     *
+     * @param {string} Locale Locale da utilizzare nel momento che questo servizio richiede le traduzioni
+     * @param {baseLocalization} baseLocalization Classe base di localizzazione già fornita a livello di root dalla libreria stessa.
+     * È sufficiente iniettarla nell'eventuale costruttore che estende questa classe e passarla as-is
+     */
+    constructor(injector: Injector);
+    /**
+     * Genera un nuovo servizio di localizzazione data una classe in modo che le localizzazioni non siano più solo da provide-are a livello di componente, ma possano
+     * anche essere create al volo dal componente/servizio/qualsiasicosa che le deve utilizzare
+     *
+     * @param {Type<LocalizationService>} lcst Classe da usare per crare il nuovo servizio di localizzazione
+     */
+    generateFromType(lcst: Type<LocalizationService>): LocalizationService;
+    /**
+     * Imposta la localizzazione di un token all'interno della **TranslationCache**
+     *
+     * @param {string} direction Direzione della traduzione, rappresenta la lingua base in cui aspettarsi il testo e le varie lingue in cui viene tradotta.
+     * Ad esempio, "en->it" indica che il parametro **left** è valido per le localizzazioni in inglese, mentre nell'elemento 0 del parametro **right**
+     * è presente l'unica traduzione in italiano, per definire più traduzioni sul lato destro della freccia bisogna concatenarle con la virgola, ad esempio "en->it,jp,ecc"
+     * @param {string} token Nome del token
+     * @param {string} left Valore del token per la lingua specificata nel lato immediatamente sinistro alla freccia del parametro **direction**
+     * @param {string} right Array con i valori facenti riferimento all'N-esima lingua del lato destro del parametro **direction**
+     */
+    protected setToken(direction: string, token: string, left: string, right: string[]): void;
+    /**
+     * Imposta la localizzazione di una frase all'interno della **TranslationCache**
+     *
+     * @param {string} direction Direzione della traduzione, rappresenta la lingua base in cui aspettarsi il testo e le varie lingue in cui viene tradotta.
+     * Ad esempio, "en->it" indica che il parametro **left** è valido per le localizzazioni in inglese, mentre nell'elemento 0 del parametro **right**
+     * è presente l'unica traduzione in italiano, per definire più traduzioni sul lato destro della freccia bisogna concatenarle con la virgola, ad esempio "en->it,jp,ecc"
+     * @param {string} left Valore della frase per la lingua specificata nel lato immediatamente sinistro alla freccia del parametro **direction**
+     * @param {string} right Array con i valori facenti riferimento all'N-esima lingua del lato destro del parametro **direction**
+     */
+    protected set(direction: string, left: string, right: string[]): void;
+    /**
+     * Localizza un token
+     *
+     * @param {string} text Il token da localizzare
+     *
+     * @returns {string} Token localizzato
+     */
+    token(text: string): string;
+    /**
+     * Localizza una frase
+     *
+     * @param {string} text Frase da localizzare
+     * @param {boolean} allowtokens Indica se la frase **text** potrebbe essere un token o no
+     *
+     * @returns {string} Frase localizzata
+     */
+    loc(text: string, allowtokens?: boolean): string;
+    changeLocale(newLocale: string): Promise<void>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<LocalizationService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<LocalizationService>;
+}

package/lib/models/BaseLocalizationTokens.d.ts

@@ -1,12 +1,12 @@
-export declare enum BaseLocalizationTokens {
-    getDateMonthPosition = "getDateMonthPosition",
-    getDisplayDateMonthPosition = "getDisplayDateMonthPosition",
-    getLocale = "getLocale",
-    getSmallDateFormat = "getSmallDateFormat",
-    getDefaultDateFormat = "getDefaultDateFormat",
-    getSmallDateDisplayFormat = "getSmallDateDisplayFormat",
-    getFullDateFormat = "getFullDateFormat",
-    getFullDateDisplayFormat = "getFullDateDisplayFormat",
-    getFullDateFormatNoSeconds = "getFullDateFormatNoSeconds",
-    getFullDateDisplayFormatNoSeconds = "getFullDateDisplayFormatNoSeconds"
-}
+export declare enum BaseLocalizationTokens {
+    getDateMonthPosition = "getDateMonthPosition",
+    getDisplayDateMonthPosition = "getDisplayDateMonthPosition",
+    getLocale = "getLocale",
+    getSmallDateFormat = "getSmallDateFormat",
+    getDefaultDateFormat = "getDefaultDateFormat",
+    getSmallDateDisplayFormat = "getSmallDateDisplayFormat",
+    getFullDateFormat = "getFullDateFormat",
+    getFullDateDisplayFormat = "getFullDateDisplayFormat",
+    getFullDateFormatNoSeconds = "getFullDateFormatNoSeconds",
+    getFullDateDisplayFormatNoSeconds = "getFullDateDisplayFormatNoSeconds"
+}

package/lib/models/ItemLocalization.d.ts

@@ -1,17 +1,17 @@
-import { SpecializedLocalization } from "./SpecializedLocalization";
-/**
- * Contenitore delle localizzazioni collegate ad un testo "base", una per ogni linguaggio supportato
- */
-export declare class ItemLocalization {
-    token: boolean;
-    baseText: string;
-    translations: SpecializedLocalization[];
-    /**
-     * Costruttore
-     *
-     * @param {boolean} token Indica se è un token o se è un testo
-     * @param {string} baseText Testo base che verrà richiesto quando verrà cercata la localizzazione
-     * @param {SpecializedLocalization[]} translations Lista di traduzioni in base al testo base
-     */
-    constructor(token: boolean, baseText: string, translations: SpecializedLocalization[]);
-}
+import { SpecializedLocalization } from "./SpecializedLocalization";
+/**
+ * Contenitore delle localizzazioni collegate ad un testo "base", una per ogni linguaggio supportato
+ */
+export declare class ItemLocalization {
+    token: boolean;
+    baseText: string;
+    translations: SpecializedLocalization[];
+    /**
+     * Costruttore
+     *
+     * @param {boolean} token Indica se è un token o se è un testo
+     * @param {string} baseText Testo base che verrà richiesto quando verrà cercata la localizzazione
+     * @param {SpecializedLocalization[]} translations Lista di traduzioni in base al testo base
+     */
+    constructor(token: boolean, baseText: string, translations: SpecializedLocalization[]);
+}

package/lib/models/LocaleDefinitions.d.ts

@@ -1,20 +1,20 @@
-import { LocaleObject } from "./LocaleObject";
-/** Classe che gestisce le definizioni dei locali disponibili */
-export declare class LocaleDefinitions {
-    /** Cache per ottimizzare la chiamata **getByAlias** */
-    static LocaleCache: {
-        [alias: string]: LocaleObject;
-    };
-    /** @ignore Costruttore */
-    constructor();
-    /** Lista dei locali disponibili, definiti anche con i vari alias */
-    static AvailableLocales: LocaleObject[];
-    /**
-     * In base a un alias restituisce il locale rappresentato
-     *
-     * @param {string} alias Alias in base al quale raccogliere il Locale
-     *
-     * @returns {LocaleObject} Locale richiesto dall'alias
-     */
-    static getByAlias(alias: string): LocaleObject;
-}
+import { LocaleObject } from "./LocaleObject";
+/** Classe che gestisce le definizioni dei locali disponibili */
+export declare class LocaleDefinitions {
+    /** Cache per ottimizzare la chiamata **getByAlias** */
+    static LocaleCache: {
+        [alias: string]: LocaleObject;
+    };
+    /** @ignore Costruttore */
+    constructor();
+    /** Lista dei locali disponibili, definiti anche con i vari alias */
+    static AvailableLocales: LocaleObject[];
+    /**
+     * In base a un alias restituisce il locale rappresentato
+     *
+     * @param {string} alias Alias in base al quale raccogliere il Locale
+     *
+     * @returns {LocaleObject} Locale richiesto dall'alias
+     */
+    static getByAlias(alias: string): LocaleObject;
+}

package/lib/models/LocaleObject.d.ts

@@ -1,18 +1,18 @@
-/**
- * Classe che rappresenta un locale (Es. 'Italiano') con i propri alias (Es. 'it' oppure 'it-IT')
- */
-export declare class LocaleObject {
-    id: string;
-    description: string;
-    aliases: string[];
-    smallVersion: string;
-    /**
-     * Costruttore
-     *
-     * @param {string} id Codice locale
-     * @param {string} description Descrizione locale
-     * @param {string[]} aliases Alias con cui quel locale è conosciuto
-     * @param {string} smallVersion Versione standard "small" del locale. Es. "it-IT" -> "it"
-     */
-    constructor(id: string, description: string, aliases: string[], smallVersion: string);
-}
+/**
+ * Classe che rappresenta un locale (Es. 'Italiano') con i propri alias (Es. 'it' oppure 'it-IT')
+ */
+export declare class LocaleObject {
+    id: string;
+    description: string;
+    aliases: string[];
+    smallVersion: string;
+    /**
+     * Costruttore
+     *
+     * @param {string} id Codice locale
+     * @param {string} description Descrizione locale
+     * @param {string[]} aliases Alias con cui quel locale è conosciuto
+     * @param {string} smallVersion Versione standard "small" del locale. Es. "it-IT" -> "it"
+     */
+    constructor(id: string, description: string, aliases: string[], smallVersion: string);
+}

package/lib/models/LocalizationMissingPolicy.d.ts

@@ -1,9 +1,9 @@
-/**
- * Enum che rappresenta le policy di comportamento qualore il sistema di localizzazione non trovi la localizzazione cercata,
- * usare **ThrowException** solo se ci si sente infallibili o si vuole debuggare in maniera approfondita l'applicazione
- */
-export declare enum LocalizationMissingPolicy {
-    PrintEmpty = 0,
-    PrintSource = 1,
-    ThrowException = 2
-}
+/**
+ * Enum che rappresenta le policy di comportamento qualore il sistema di localizzazione non trovi la localizzazione cercata,
+ * usare **ThrowException** solo se ci si sente infallibili o si vuole debuggare in maniera approfondita l'applicazione
+ */
+export declare enum LocalizationMissingPolicy {
+    PrintEmpty = 0,
+    PrintSource = 1,
+    ThrowException = 2
+}

package/lib/models/LocalizationModuleConfig.d.ts

@@ -1,19 +1,19 @@
-import { Type } from "@angular/core";
-import { LocalePersistor } from "../locale-persistor/LocalePersistor";
-import { LocalizationMissingPolicy } from "./LocalizationMissingPolicy";
-/**
- * Classe di configurazione per il modulo di localizzazione
- */
-export declare class LocalizationModuleConfig {
-    /** Locale di default utilizzato per richiedere le traduzioni */
-    defaultLocale?: string;
-    /**
-     * Classe che si deve occupare dello store "Definitivo" delle info sul locale utilizzato. Di default viene proposto uno store lato localStorage ma si può facilmente
-     * fornire uno storage che porta le informazioni lato Database in modo da avere la stessa lingua fino a che non viene cambiata (Es. Preference storage)
-     */
-    localePersistor?: Type<LocalePersistor>;
-    /** Policy di cosa fare in caso il sistema non riesca a trovare una delle traduzioni */
-    localizationMissingPolicy?: LocalizationMissingPolicy;
-    /** Attiva la modalità di debug per l'esposizione di messaggi significativi */
-    debugMode?: boolean;
-}
+import { Type } from "@angular/core";
+import { LocalePersistor } from "../locale-persistor/LocalePersistor";
+import { LocalizationMissingPolicy } from "./LocalizationMissingPolicy";
+/**
+ * Classe di configurazione per il modulo di localizzazione
+ */
+export declare class LocalizationModuleConfig {
+    /** Locale di default utilizzato per richiedere le traduzioni */
+    defaultLocale?: string;
+    /**
+     * Classe che si deve occupare dello store "Definitivo" delle info sul locale utilizzato. Di default viene proposto uno store lato localStorage ma si può facilmente
+     * fornire uno storage che porta le informazioni lato Database in modo da avere la stessa lingua fino a che non viene cambiata (Es. Preference storage)
+     */
+    localePersistor?: Type<LocalePersistor>;
+    /** Policy di cosa fare in caso il sistema non riesca a trovare una delle traduzioni */
+    localizationMissingPolicy?: LocalizationMissingPolicy;
+    /** Attiva la modalità di debug per l'esposizione di messaggi significativi */
+    debugMode?: boolean;
+}

package/lib/models/SpecializedLocalization.d.ts

@@ -1,14 +1,14 @@
-/**
- * Classe che rappresenta la localizzazione di un test base per una certa lingua
- */
-export declare class SpecializedLocalization {
-    culture: string;
-    translation: string;
-    /**
-     * Costruttore
-     *
-     * @param {string} culture Culture della traduzione
-     * @param {string} translation Traduzione nella lingua specificata dalla **culture**
-     */
-    constructor(culture: string, translation: string);
-}
+/**
+ * Classe che rappresenta la localizzazione di un test base per una certa lingua
+ */
+export declare class SpecializedLocalization {
+    culture: string;
+    translation: string;
+    /**
+     * Costruttore
+     *
+     * @param {string} culture Culture della traduzione
+     * @param {string} translation Traduzione nella lingua specificata dalla **culture**
+     */
+    constructor(culture: string, translation: string);
+}

package/lib/pipes/localize.pipe.d.ts

@@ -1,28 +1,28 @@
-import { PipeTransform } from "@angular/core";
-import { LocalizationService } from '../localizations.service';
-import * as i0 from "@angular/core";
-/**
- * Pipe di localizzazione per tradurre direttamente da template
- */
-export declare class LocalizePipe implements PipeTransform {
-    private translationContainer;
-    /**
-     * Costruttore
-     *
-     * @param {LocalizationService} translationContainer Container delle traduzioni disponibili nel contesto in cui viene usata la pipe.
-     *
-     * Viene iniettata dal provider dichiarato nel singolo componente che utilizza la traduzione e, se non esiste, viene iniettato dal default
-     */
-    constructor(translationContainer: LocalizationService);
-    /**
-     * Trasformazione della stringa in input ad una stringa tradotta
-     *
-     * @param {string} value Testo da tradurre
-     * @param {LocalizationService} locContainerOverride Override al contenitore della traduzione iniettato dal costruttore, qualora serva
-     *
-     * @returns {string} Frase tradotta
-     */
-    transform(value: string, locContainerOverride?: LocalizationService): string;
-    static ɵfac: i0.ɵɵFactoryDeclaration<LocalizePipe, never>;
-    static ɵpipe: i0.ɵɵPipeDeclaration<LocalizePipe, "localize", false>;
-}
+import { PipeTransform } from "@angular/core";
+import { LocalizationService } from '../localizations.service';
+import * as i0 from "@angular/core";
+/**
+ * Pipe di localizzazione per tradurre direttamente da template
+ */
+export declare class LocalizePipe implements PipeTransform {
+    private translationContainer;
+    /**
+     * Costruttore
+     *
+     * @param {LocalizationService} translationContainer Container delle traduzioni disponibili nel contesto in cui viene usata la pipe.
+     *
+     * Viene iniettata dal provider dichiarato nel singolo componente che utilizza la traduzione e, se non esiste, viene iniettato dal default
+     */
+    constructor(translationContainer: LocalizationService);
+    /**
+     * Trasformazione della stringa in input ad una stringa tradotta
+     *
+     * @param {string} value Testo da tradurre
+     * @param {LocalizationService} locContainerOverride Override al contenitore della traduzione iniettato dal costruttore, qualora serva
+     *
+     * @returns {string} Frase tradotta
+     */
+    transform(value: string, locContainerOverride?: LocalizationService): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<LocalizePipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<LocalizePipe, "localize", false>;
+}

package/lib/tokens.d.ts

@@ -1,8 +1,8 @@
-import { InjectionToken } from '@angular/core';
-import { LocalizationMissingPolicy } from "./models/LocalizationMissingPolicy";
-/** Locale da utilizzare per le traduzioni */
-export declare const LOC_LOCALE: InjectionToken<string>;
-/** Policy da utilizzare per traduzioni mancanti */
-export declare const LOC_MISSING_POLICY: InjectionToken<LocalizationMissingPolicy>;
-/** Modalità di Debug */
-export declare const LOC_DEBUG_MODE: InjectionToken<boolean>;
+import { InjectionToken } from '@angular/core';
+import { LocalizationMissingPolicy } from "./models/LocalizationMissingPolicy";
+/** Locale da utilizzare per le traduzioni */
+export declare const LOC_LOCALE: InjectionToken<string>;
+/** Policy da utilizzare per traduzioni mancanti */
+export declare const LOC_MISSING_POLICY: InjectionToken<LocalizationMissingPolicy>;
+/** Modalità di Debug */
+export declare const LOC_DEBUG_MODE: InjectionToken<boolean>;

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@esfaenza/localizations",
-  "version": "16.2.29",
+  "version": "17.3.0",
   "dependencies": {
     "tslib": "^2.0.0"
   },
   "peerDependencies": {
-    "@angular/common": "^16.2.12",
-    "@angular/core": "^16.2.12"
+    "@angular/common": "^17.3.12",
+    "@angular/core": "^17.3.12"
   },
   "module": "fesm2022/esfaenza-localizations.mjs",
   "typings": "index.d.ts",

package/public-api.d.ts

@@ -1,8 +1,8 @@
-export * from './lib/core/localization.base';
-export * from './lib/localizations.module';
-export * from './lib/localizations.service';
-export * from './lib/pipes/localize.pipe';
-export * from './lib/tokens';
-export * from './lib/models/LocalizationModuleConfig';
-export * from './lib/models/BaseLocalizationTokens';
-export * from './lib/models/LocalizationMissingPolicy';
+export * from './lib/core/localization.base';
+export * from './lib/localizations.module';
+export * from './lib/localizations.service';
+export * from './lib/pipes/localize.pipe';
+export * from './lib/tokens';
+export * from './lib/models/LocalizationModuleConfig';
+export * from './lib/models/BaseLocalizationTokens';
+export * from './lib/models/LocalizationMissingPolicy';