Update docs

README.md

@@ -48,6 +48,10 @@ export const l10nConfig: L10nConfig = {
 
 @Injectable() export class TranslationLoader implements L10nTranslationLoader {
   public get(language: string, provider: L10nProvider): Observable<{ [key: string]: any }> {
+    /**
+     * Translation files are lazy-loaded via dynamic import and will be split into separate chunks during build.
+     * Assets names and keys must be valid variable names
+     */
     const data = import(`../i18n/${language}/${provider.asset}.json`);
     return from(data);
   }
@@ -69,6 +73,8 @@ _src/i18n/en-US/app.json_
 }
 ```
 
+> Note. The implementation above of `L10nTranslationLoader` is just an example: you can load the translation data in the way you prefer.
+
 Register the configuration:
 
 _src/app/app.config.ts_

angular.json

@@ -61,7 +61,7 @@
       "prefix": "app",
       "architect": {
         "build": {
-          "builder": "@angular-devkit/build-angular:browser",
+          "builder": "@angular-devkit/build-angular:browser-esbuild",
           "options": {
             "outputPath": "dist/angular-l10n-app",
             "index": "projects/angular-l10n-app/src/index.html",

tsconfig.json

@@ -28,7 +28,8 @@
       "dom"
     ],
     "useDefineForClassFields": false,
-    "allowSyntheticDefaultImports": true
+    "allowSyntheticDefaultImports": true,
+    "resolveJsonModule": true
   },
   "angularCompilerOptions": {
     "strictInjectionParameters": true,