Merge pull request #14 from robmanganelly/release-2.0.0

Release 2.0.0

Author: robmanganelly

bun.lock

@@ -32,21 +32,21 @@ type TranslationSource = string;
 declare const withTranslationSource: (source?: string | TranslationSourceLocator) => TranslationSource;
 ```
 
-## useFetchMultiLoader and useHttpMultiLoader
+## provideFetchMultiLoader and provideHttpMultiLoader
 
 ````typescript
 /**
  * Use when providing {@link TranslateService }. Add any sources for translations
  *
  * It uses fetch API
  * Use only with client-side rendered applications,
- * if your app is rendered by the server prefer {@link useHttpMultiLoader }
+ * if your app is rendered by the server prefer {@link provideHttpMultiLoader }
  *
  * Example
  * ```typescript
  * provideTranslateService({
  *   //...other properties
- *   loader: useFetchMultiLoader(
+ *   loader: provideFetchMultiLoader(
  *      // do not include the host application source, this one is included by default
  *      withTranslationSource({ locator: 'my-lib-name' }),
  *      withTranslationSource({ locator: 'another-lib-name' }),
@@ -58,19 +58,19 @@ declare const withTranslationSource: (source?: string | TranslationSourceLocator
  * @param features
  * @returns
  */
-declare const useFetchMultiLoader: (...features: TranslationSource[]) => FactoryProvider;
+declare const provideFetchMultiLoader: (...features: TranslationSource[]) => FactoryProvider;
 /**
  * Use when providing {@link TranslateService }. Add any sources for translations
  *
  * It uses httpBackend
- * If you prefer using fetch API use {@link useFetchMultiLoader }
+ * If you prefer using fetch API use {@link provideFetchMultiLoader }
  *
  * Example
  * ```typescript
  * provideTranslateService({
  *   //...other properties
  *   provideHttpClient(),
- *   loader: useHttpMultiLoader(
+ *   loader: provideHttpMultiLoader(
  *      // do not include the host application source, this one is included by default
  *      withTranslationSource({ locator: 'my-lib-name' }),
  *      withTranslationSource({ locator: 'another-lib-name' }),
@@ -82,7 +82,7 @@ declare const useFetchMultiLoader: (...features: TranslationSource[]) => Factory
  * @param features
  * @returns
  */
-declare const useHttpMultiLoader: (...features: TranslationSource[]) => FactoryProvider;
+declare const provideHttpMultiLoader: (...features: TranslationSource[]) => FactoryProvider;
 ````
 
 ## tagFactory

docs/api.md

@@ -17,19 +17,19 @@ We also assume that you are using the standalone API for your angular applicatio
 
 In your `app.config.ts`, at the time of providing `TranslateService` you will pass to the `loader` attribute one of the functions exported by the toolkit:
 
-- `useHttpMultiLoader` It is recommended for most applications, as it uses Angular's `HttpBackend` to load translation files. It requires that you provide `HttpClient` before calling `provideTranslateService`.
+- `provideHttpMultiLoader` It is recommended for most applications, as it uses Angular's `HttpBackend` to load translation files. It requires that you provide `HttpClient` before calling `provideTranslateService`.
 
-- `useFetchMultiLoader` It is recommended for client side rendered applications, as it uses the Fetch API to load translation files. This option **cannot** be used in server-side rendered applications (SSR) or Angular Universal, as it relies on browser APIs, but it is better if you are not planning to use SSR or Angular's `HttpClient` at all.
+- `provideFetchMultiLoader` It is recommended for client side rendered applications, as it uses the Fetch API to load translation files. This option **cannot** be used in server-side rendered applications (SSR) or Angular Universal, as it relies on browser APIs, but it is better if you are not planning to use SSR or Angular's `HttpClient` at all.
 
-#### Example Configuration with useHttpMultiLoader
+#### Example Configuration with provideHttpMultiLoader
 
 ```typescript
 import { ApplicationConfig, provideBrowserGlobalErrorListeners, provideZoneChangeDetection } from "@angular/core";
 import { provideRouter } from "@angular/router";
 
 import { routes } from "./app.routes";
 import { provideTranslateService } from "@ngx-translate/core";
-import { pathFactory, useHttpMultiLoader } from "@robmanganelly/ngx-translate-toolkit";
+import { pathFactory, provideHttpMultiLoader } from "@robmanganelly/ngx-translate-toolkit";
 import { provideHttpClient } from "@angular/common/http";
 
 export const translationPaths = pathFactory("testApp");
@@ -40,23 +40,23 @@ export const appConfig: ApplicationConfig = {
     provideZoneChangeDetection({ eventCoalescing: true }),
     provideHttpClient(),
     provideTranslateService({
-      defaultLanguage: "en-us",
-      loader: useHttpMultiLoader(),
+      fallbackLang: "en-us",
+      loader: provideHttpMultiLoader(),
     }),
     provideRouter(routes),
   ],
 };
 ```
 
-#### Example Configuration with useFetchMultiLoader
+#### Example Configuration with provideFetchMultiLoader
 
 ```typescript
 import { ApplicationConfig, provideBrowserGlobalErrorListeners, provideZoneChangeDetection } from "@angular/core";
 import { provideRouter } from "@angular/router";
 
 import { routes } from "./app.routes";
 import { provideTranslateService } from "@ngx-translate/core";
-import { pathFactory, useFetchMultiLoader } from "@robmanganelly/ngx-translate-toolkit";
+import { pathFactory, provideFetchMultiLoader } from "@robmanganelly/ngx-translate-toolkit";
 
 export const translationPaths = pathFactory("testApp");
 
@@ -65,8 +65,8 @@ export const appConfig: ApplicationConfig = {
     provideBrowserGlobalErrorListeners(),
     provideZoneChangeDetection({ eventCoalescing: true }),
     provideTranslateService({
-      defaultLanguage: "en-us",
-      loader: useFetchMultiLoader(),
+      fallbackLang: "en-us",
+      loader: provideFetchMultiLoader(),
     }),
     provideRouter(routes),
   ],
@@ -89,7 +89,7 @@ import { ApplicationConfig, provideBrowserGlobalErrorListeners, provideZoneChang
 import { provideRouter } from "@angular/router";
 import { routes } from "./app.routes";
 import { provideTranslateService } from "@ngx-translate/core";
-import { pathFactory, useHttpMultiLoader, withTranslationSource, languageSourcePlaceholder } from "@robmanganelly/ngx-translate-toolkit";
+import { pathFactory, provideHttpMultiLoader, withTranslationSource, languageSourcePlaceholder } from "@robmanganelly/ngx-translate-toolkit";
 import { provideHttpClient } from "@angular/common/http";
 
 export const translationPaths = pathFactory("testApp");
@@ -100,8 +100,8 @@ export const appConfig: ApplicationConfig = {
     provideZoneChangeDetection({ eventCoalescing: true }),
     provideHttpClient(),
     provideTranslateService({
-      defaultLanguage: "en-us",
-      loader: useHttpMultiLoader(
+      fallbackLang: "en-us",
+      loader: provideHttpMultiLoader(
         withTranslationSource({ locator: "cart" }),
         withTranslationSource({ locator: "checkout" }),
         withTranslationSource({ locator: "product-details" }),

docs/usage.md

@@ -10,31 +10,31 @@
   },
   "private": true,
   "dependencies": {
-    "@angular/common": "^20.0.0",
-    "@angular/compiler": "^20.0.0",
-    "@angular/core": "^20.0.0",
-    "@angular/forms": "^20.0.0",
-    "@angular/platform-browser": "^20.0.0",
-    "@angular/router": "^20.0.0",
-    "@ngx-translate/core": "^16.0.4",
-    "rxjs": "~7.8.0",
-    "tslib": "^2.3.0"
+    "@angular/common": "^20.1.4",
+    "@angular/compiler": "^20.1.4",
+    "@angular/core": "^20.1.4",
+    "@angular/forms": "^20.1.4",
+    "@angular/platform-browser": "^20.1.4",
+    "@angular/router": "^20.1.4",
+    "@ngx-translate/core": "^17.0.0",
+    "rxjs": "~7.8.2",
+    "tslib": "^2.8.1"
   },
   "devDependencies": {
-    "@angular/build": "^20.0.1",
-    "@angular/cli": "^20.0.1",
-    "@angular/compiler-cli": "^20.0.0",
-    "@types/jasmine": "~5.1.0",
+    "@angular/build": "^20.1.4",
+    "@angular/cli": "^20.1.4",
+    "@angular/compiler-cli": "^20.1.4",
+    "@types/jasmine": "~5.1.8",
     "@vitest/coverage-v8": "3.2.2",
-    "jasmine-core": "~5.7.0",
+    "jasmine-core": "~5.7.1",
     "jsdom": "^26.1.0",
-    "karma": "~6.4.0",
+    "karma": "~6.4.4",
     "karma-chrome-launcher": "~3.2.0",
-    "karma-coverage": "~2.2.0",
+    "karma-coverage": "~2.2.1",
     "karma-jasmine": "~5.1.0",
     "karma-jasmine-html-reporter": "~2.1.0",
-    "ng-packagr": "^20.0.0",
-    "typescript": "~5.8.2",
-    "vitest": "^3.2.2"
+    "ng-packagr": "^20.1.0",
+    "typescript": "~5.8.3",
+    "vitest": "^3.2.4"
   }
 }

package.json

@@ -4,7 +4,7 @@
   "peerDependencies": {
     "@angular/common": "^20.0.0",
     "@angular/core": "^20.0.0",
-    "@ngx-translate/core": "^15.0.0 || ^16.0.0"
+    "@ngx-translate/core": "^17.0.0"
   },
   "dependencies": {
     "tslib": "^2.3.0"

projects/ngx-translate-toolkit/package.json

@@ -38,7 +38,7 @@ export class MultiLoader implements TranslateLoader {
       .map((req) =>
         (this.a as HttpBackend).handle(req).pipe(
           filter((e): e is HttpResponse<unknown> => e instanceof HttpResponse),
-          map((r) => r.body ?? ({} as TranslationObject)),
+          map((r) => (r.body ?? {}) as TranslationObject),
           catchError(() => of({} as TranslationObject))
         )
       );

projects/ngx-translate-toolkit/src/lib/multi-loader.ts

@@ -9,13 +9,13 @@ import { HttpBackend } from '@angular/common/http';
  *
  * It uses fetch API
  * Use only with client-side rendered applications,
- * if your app is rendered by the server prefer {@link useHttpMultiLoader }
+ * if your app is rendered by the server prefer {@link provideHttpMultiLoader }
  *
  * Example
  * ```typescript
  * provideTranslateService({
  *   //...other properties
- *   loader: useFetchMultiLoader(
+ *   loader: provideFetchMultiLoader(
  *      // do not include the host application source, this one is included by default
  *      withTranslationSource({ locator: 'my-lib-name' }),
  *      withTranslationSource({ locator: 'another-lib-name' }),
@@ -27,7 +27,7 @@ import { HttpBackend } from '@angular/common/http';
  * @param features
  * @returns
  */
-export const useFetchMultiLoader = (
+export const provideFetchMultiLoader = (
   ...features: TranslationSource[]
 ): FactoryProvider => ({
   provide: TranslateLoader,
@@ -40,14 +40,14 @@ export const useFetchMultiLoader = (
  * Use when providing {@link TranslateService }. Add any sources for translations
  *
  * It uses httpBackend
- * If you prefer using fetch API use {@link useFetchMultiLoader }
+ * If you prefer using fetch API use {@link provideFetchMultiLoader }
  *
  * Example
  * ```typescript
  * provideTranslateService({
  *   //...other properties
  *   provideHttpClient(),
- *   loader: useHttpMultiLoader(
+ *   loader: provideHttpMultiLoader(
  *      // do not include the host application source, this one is included by default
  *      withTranslationSource({ locator: 'my-lib-name' }),
  *      withTranslationSource({ locator: 'another-lib-name' }),
@@ -59,7 +59,7 @@ export const useFetchMultiLoader = (
  * @param features
  * @returns
  */
-export const useHttpMultiLoader = (
+export const provideHttpMultiLoader = (
   ...features: TranslationSource[]
 ): FactoryProvider => ({
   provide: TranslateLoader,