@lwrjs/config 0.11.0-alpha.3 → 0.11.0-alpha.6

package/build/cjs/defaults.cjs

@@ -87,6 +87,14 @@ var SSR_VIEW_TRANSFORM_PLUGIN = "@lwrjs/lwc-ssr/viewTransformer";
 var DEFAULT_ASSET_PROVIDERS = ["@lwrjs/fs-asset-provider"];
 var DEFAULT_ASSET_TRANSFORM_PLUGINS = ["@lwrjs/asset-transformer"];
 var DEFAULT_URI_TRANSFORM_PLUGINS = [];
+var DEFAULT_I18N_CONFIG = {
+  defaultLocale: "en-US",
+  locales: [
+    {
+      id: "en-US"
+    }
+  ]
+};
 var DEFAULT_AMD_LOADER = "lwr/loader";
 var DEFAULT_AMD_LOADER_LEGACY = "lwr/loaderLegacy";
 var DEFAULT_ESM_LOADER = "lwr/esmLoader";
@@ -157,5 +165,6 @@ var DEFAULT_LWR_CONFIG = {
   bundleConfig: getDefaultBundleConfig(MODE),
   serverType: DEFAULT_SERVER_TYPE,
   locker: import_shared_utils.DEFAULT_LWR_LOCKER_CONFIG,
-  uriTransformers: DEFAULT_URI_TRANSFORM_PLUGINS
+  uriTransformers: DEFAULT_URI_TRANSFORM_PLUGINS,
+  i18n: DEFAULT_I18N_CONFIG
 };

package/build/cjs/hooks.cjs

@@ -66,11 +66,13 @@ function executeStartHooks(hooks, globalConfig, runtimeEnvironment, skipValidate
     }
     const onStartConfig = {
       basePath: globalConfig.basePath,
+      i18n: globalConfig.i18n,
       routes: globalConfig.routes
     };
     hook.onStart(onStartConfig);
-    globalConfig.routes = onStartConfig.routes || [];
     runtimeEnvironment.basePath = globalConfig.basePath = onStartConfig.basePath || "";
+    globalConfig.i18n = onStartConfig.i18n;
+    globalConfig.routes = onStartConfig.routes || [];
   }
   globalConfig.routes = (0, import_routes.normalizeRoutes)(globalConfig.routes, globalConfig.routeHandlers);
   const ssrConfig = (0, import_global_config.applySsrConfig)(globalConfig);

package/build/cjs/runtime-config.cjs

@@ -38,7 +38,7 @@ var RUNTIME_CONFIGS = {
     compat: "0",
     debug: false,
     watchFiles: true,
-    defaultLocale: "en_US",
+    defaultLocale: "en-US",
     hmrEnabled: true,
     immutableAssets: false,
     env: {
@@ -52,7 +52,7 @@ var RUNTIME_CONFIGS = {
     compat: "0",
     debug: false,
     watchFiles: false,
-    defaultLocale: "en_US",
+    defaultLocale: "en-US",
     hmrEnabled: false,
     immutableAssets: true,
     env: {
@@ -66,7 +66,7 @@ var RUNTIME_CONFIGS = {
     compat: "1",
     debug: false,
     watchFiles: true,
-    defaultLocale: "en_US",
+    defaultLocale: "en-US",
     hmrEnabled: false,
     immutableAssets: false,
     env: {
@@ -80,7 +80,7 @@ var RUNTIME_CONFIGS = {
     compat: "1",
     debug: false,
     watchFiles: false,
-    defaultLocale: "en_US",
+    defaultLocale: "en-US",
     hmrEnabled: false,
     immutableAssets: true,
     env: {
@@ -96,8 +96,9 @@ function getServerModeConfig(serverMode) {
   return selectedMode;
 }
 function getRuntimeEnvironment(config) {
-  const {serverMode, lwrVersion, apiVersion, basePath, minify} = config;
+  const {serverMode, lwrVersion, apiVersion, basePath, i18n, minify} = config;
   const serverModeConfig = getServerModeConfig(config.serverMode);
+  const defaultLocale = i18n.defaultLocale;
   return {
     ...serverModeConfig,
     minify: minify !== null ? minify : serverModeConfig.minify,
@@ -105,6 +106,7 @@ function getRuntimeEnvironment(config) {
     serverMode,
     lwrVersion,
     apiVersion,
-    basePath
+    basePath,
+    defaultLocale
   };
 }

package/build/cjs/utils/routes.cjs

@@ -61,7 +61,7 @@ function normalizeRoutePaths(routes = [], resourcePaths) {
   return routes.map((route) => {
     const {contentTemplate, layoutTemplate, subRoutes} = route;
     if (contentTemplate) {
-      route.contentTemplate = import_path.default.resolve((0, import_shared_utils.normalizeResourcePath)(contentTemplate, resourcePaths));
+      route.contentTemplate = typeof contentTemplate === "string" ? import_path.default.resolve((0, import_shared_utils.normalizeResourcePath)(contentTemplate, resourcePaths)) : contentTemplate;
     }
     if (layoutTemplate) {
       route.layoutTemplate = import_path.default.resolve((0, import_shared_utils.normalizeResourcePath)(layoutTemplate, resourcePaths));

package/build/cjs/validation/app-config-context.cjs

@@ -29,6 +29,7 @@ __export(exports, {
   BASE_PATH_REGEX: () => BASE_PATH_REGEX,
   BOOTSTRAP_ATTRIBUTE_KEYS: () => BOOTSTRAP_ATTRIBUTE_KEYS,
   ERROR_ROUTE_ATTRIBUTE_KEYS: () => ERROR_ROUTE_ATTRIBUTE_KEYS,
+  I18N_ATTRIBUTE_KEYS: () => I18N_ATTRIBUTE_KEYS,
   LOCKER_ATTRIBUTE_KEYS: () => LOCKER_ATTRIBUTE_KEYS,
   ROOT_ATTRIBUTE_KEYS: () => ROOT_ATTRIBUTE_KEYS,
   ROUTE_ATTRIBUTE_KEYS: () => ROUTE_ATTRIBUTE_KEYS,
@@ -37,6 +38,7 @@ __export(exports, {
 var import_jsonc_parser = __toModule(require("jsonc-parser"));
 var import_diagnostics = __toModule(require("@lwrjs/diagnostics"));
 var import_helpers = __toModule(require("./helpers.cjs"));
+var import_shared_utils = __toModule(require("@lwrjs/shared-utils"));
 function createKeys(p, t) {
   return p && t;
 }
@@ -57,6 +59,7 @@ var ROOT_ATTRIBUTE_KEYS = createKeys("root", [
   "globalData",
   "globalDataDir",
   "hooks",
+  "i18n",
   "ignoreLwrConfigFile",
   "lwrConfigFile",
   "layoutsDir",
@@ -80,6 +83,7 @@ var ROOT_ATTRIBUTE_KEYS = createKeys("root", [
 var ASSET_DIR_ATTRIBUTE_KEYS = createKeys("assetDir", ["alias", "dir", "urlPath", "root"]);
 var ASSET_FILE_ATTRIBUTE_KEYS = createKeys("assetFile", ["alias", "file", "urlPath"]);
 var LOCKER_ATTRIBUTE_KEYS = createKeys("locker", ["enabled", "trustedComponents", "clientOnly"]);
+var I18N_ATTRIBUTE_KEYS = createKeys("i18n", ["defaultLocale", "locales", "uriPattern"]);
 var ROUTE_ATTRIBUTE_KEYS = createKeys("routes", [
   "bootstrap",
   "subRoutes",
@@ -116,7 +120,6 @@ var BOOTSTRAP_ATTRIBUTE_KEYS = createKeys("bootstrap", [
   "module",
   "preloadModules"
 ]);
-var SPECIFIER_REGEX = /^@?[\w-]+(\/[\w-]+)*$/;
 function isNotEmptyString(node) {
   return node.type === "string" && node.value.length > 0;
 }
@@ -154,7 +157,7 @@ var ValidationContext = class {
     }
   }
   assertIsSpecifier(node, property) {
-    if (node && (node.type !== "string" || !SPECIFIER_REGEX.test(node.value))) {
+    if (node && (node.type !== "string" || !(0, import_shared_utils.isSpecifier)(node.value))) {
       this.diagnostics.push({
         description: import_diagnostics.descriptions.CONFIG_PARSER.INVALID_SPECIFIER(property, node.value),
         location: this.getLocationFromNode(node)
@@ -331,7 +334,7 @@ var ValidationContext = class {
       });
     } else if (node.children && node.children.length > 0) {
       node.children.forEach((n, index) => {
-        if (n.type !== "string" || !SPECIFIER_REGEX.test(n.value)) {
+        if (n.type !== "string" || !(0, import_shared_utils.isSpecifier)(n.value)) {
           this.diagnostics.push({
             description: import_diagnostics.descriptions.CONFIG_PARSER.INVALID_SPECIFIER(`${property}[${index}]`, n.value),
             location: this.getLocationFromNode(n)
@@ -353,6 +356,22 @@ var ValidationContext = class {
       node.children.forEach((n, index) => this.assertIsService(n, property, index));
     }
   }
+  assertIsStringOrObject(node, property, index) {
+    if (!node) {
+      return;
+    }
+    if (node.type !== "string" && node.type !== "object") {
+      this.diagnostics.push({
+        description: import_diagnostics.descriptions.CONFIG_PARSER.INCORRECT_NODE_TYPE(index !== void 0 ? `${property}[${index}]` : property, "string or object", node.type),
+        location: this.getLocationFromNode(node)
+      });
+    } else if (node.type === "string" && !isNotEmptyString(node)) {
+      this.diagnostics.push({
+        description: import_diagnostics.descriptions.CONFIG_PARSER.NON_EMPTY_STRING(property, node.value),
+        location: this.getLocationFromNode(node)
+      });
+    }
+  }
   assertIsService(node, property, index) {
     if (!node) {
       return;
@@ -445,4 +464,29 @@ var ValidationContext = class {
       });
     }
   }
+  assertDefaultInLocales(node, defaultLocale, localesIds) {
+    if (!localesIds.includes(defaultLocale)) {
+      this.diagnostics.push({
+        description: import_diagnostics.descriptions.CONFIG_PARSER.DEFAULT_NOT_IN_LOCALES(defaultLocale, localesIds),
+        location: this.getLocationFromNode(node)
+      });
+    }
+  }
+  assertFallbackIds(nodes) {
+    const localesIds = nodes.map((n) => {
+      const idNode = (0, import_jsonc_parser.findNodeAtLocation)(n, ["id"]);
+      return idNode ? idNode.value : void 0;
+    }).filter((id) => id !== void 0);
+    for (const n of nodes) {
+      const fallbackNode = (0, import_jsonc_parser.findNodeAtLocation)(n, ["fallback"]);
+      if (fallbackNode?.value) {
+        if (!localesIds.includes(fallbackNode.value)) {
+          this.diagnostics.push({
+            description: import_diagnostics.descriptions.CONFIG_PARSER.FALLBACK_NOT_IN_LOCALES(fallbackNode.value, localesIds),
+            location: this.getLocationFromNode(fallbackNode)
+          });
+        }
+      }
+    }
+  }
 };

package/build/cjs/validation/app-config.cjs

@@ -68,7 +68,7 @@ function validateRouteCommon(node, validationContext, propPrefix) {
   ]);
   validationContext.assertNotEmptyString((0, import_jsonc_parser.findNodeAtLocation)(node, ["id"]), `${propPrefix}.id`);
   validationContext.assertIsSpecifier((0, import_jsonc_parser.findNodeAtLocation)(node, ["rootComponent"]), `${propPrefix}.rootComponent`);
-  validationContext.assertNotEmptyString((0, import_jsonc_parser.findNodeAtLocation)(node, ["contentTemplate"]), `${propPrefix}.contentTemplate`);
+  validationContext.assertIsStringOrObject((0, import_jsonc_parser.findNodeAtLocation)(node, ["contentTemplate"]), `${propPrefix}.contentTemplate`);
   validationContext.assertNotEmptyString((0, import_jsonc_parser.findNodeAtLocation)(node, ["layoutTemplate"]), `${propPrefix}.layoutTemplate`);
   validationContext.assertIsService((0, import_jsonc_parser.findNodeAtLocation)(node, ["routeHandler"]), `${propPrefix}.routeHandler`);
   validateBootstrap((0, import_jsonc_parser.findNodeAtLocation)(node, ["bootstrap"]), validationContext, `${propPrefix}.bootstrap`);
@@ -91,6 +91,26 @@ function validateRoutes(node, validationContext, preMerge) {
     }
   }
 }
+function validateI18NConfig(node, validationContext, preMerge) {
+  if (node) {
+    if (!preMerge) {
+      validationContext.assertIsObject(node, "i18n");
+    }
+    validationContext.assertIsObject(node, "i18n");
+    validationContext.assertValidKeys(node, "i18n", import_app_config_context.I18N_ATTRIBUTE_KEYS);
+    validationContext.assertRequiredKeys(node, "i18n", ["defaultLocale", "locales"]);
+    const locales = (0, import_jsonc_parser.findNodeAtLocation)(node, ["locales"]);
+    validationContext.assertNotEmptyArray(locales, "i18n.locales");
+    if (locales) {
+      validationContext.assertUniqueIds([...locales?.children || []], "i18n.locales");
+      validationContext.assertFallbackIds([...locales?.children || []]);
+    }
+    const defaultLocale = (0, import_jsonc_parser.findNodeAtLocation)(node, ["defaultLocale"]);
+    validationContext.assertNotEmptyString(defaultLocale, "i18n.defaultLocale");
+    const localeIds = locales?.children?.map((n) => (0, import_jsonc_parser.findNodeAtLocation)(n, ["id"])?.value) || [];
+    validationContext.assertDefaultInLocales(node, defaultLocale?.value, localeIds);
+  }
+}
 function validateBundleConfig(node, validationContext) {
   if (node) {
     validationContext.assertIsObject(node, "bundleConfig");
@@ -213,6 +233,7 @@ function validateRoot(node, validationContext, preMerge) {
   validateRouteHandlers((0, import_jsonc_parser.findNodeAtLocation)(node, ["routeHandlers"]), validationContext);
   validateAssets((0, import_jsonc_parser.findNodeAtLocation)(node, ["assets"]), validationContext, preMerge);
   validateLocker(lockerNode, validationContext);
+  validateI18NConfig((0, import_jsonc_parser.findNodeAtLocation)(node, ["i18n"]), validationContext, preMerge);
   validateBundleConfig(bundleConfigNode, validationContext);
   validationContext.assertClientLockerSSR(routes, lockerNode);
   validationContext.assertNotEmptyString((0, import_jsonc_parser.findNodeAtLocation)(node, ["apiVersion"]), "apiVersion");

package/build/es/defaults.js

@@ -47,6 +47,14 @@ export const SSR_VIEW_TRANSFORM_PLUGIN = '@lwrjs/lwc-ssr/viewTransformer';
 const DEFAULT_ASSET_PROVIDERS = ['@lwrjs/fs-asset-provider'];
 const DEFAULT_ASSET_TRANSFORM_PLUGINS = ['@lwrjs/asset-transformer'];
 const DEFAULT_URI_TRANSFORM_PLUGINS = [];
+const DEFAULT_I18N_CONFIG = {
+    defaultLocale: 'en-US',
+    locales: [
+        {
+            id: 'en-US',
+        },
+    ],
+};
 export const DEFAULT_AMD_LOADER = 'lwr/loader';
 export const DEFAULT_AMD_LOADER_LEGACY = 'lwr/loaderLegacy';
 export const DEFAULT_ESM_LOADER = 'lwr/esmLoader';
@@ -122,5 +130,6 @@ export const DEFAULT_LWR_CONFIG = {
     serverType: DEFAULT_SERVER_TYPE,
     locker: DEFAULT_LWR_LOCKER_CONFIG,
     uriTransformers: DEFAULT_URI_TRANSFORM_PLUGINS,
+    i18n: DEFAULT_I18N_CONFIG,
 };
 //# sourceMappingURL=defaults.js.map

package/build/es/hooks.js

@@ -65,12 +65,14 @@ export function executeStartHooks(hooks, globalConfig, runtimeEnvironment, skipV
         }
         const onStartConfig = {
             basePath: globalConfig.basePath,
+            i18n: globalConfig.i18n,
             routes: globalConfig.routes,
         };
         hook.onStart(onStartConfig);
         // copy updated values back to the globalConfig
-        globalConfig.routes = (onStartConfig.routes || []);
         runtimeEnvironment.basePath = globalConfig.basePath = onStartConfig.basePath || '';
+        globalConfig.i18n = onStartConfig.i18n;
+        globalConfig.routes = (onStartConfig.routes || []);
     }
     globalConfig.routes = normalizeRoutes(globalConfig.routes, globalConfig.routeHandlers);
     const ssrConfig = applySsrConfig(globalConfig);

package/build/es/runtime-config.js

@@ -8,7 +8,7 @@ export const RUNTIME_CONFIGS = {
         compat: '0',
         debug: false,
         watchFiles: true,
-        defaultLocale: 'en_US',
+        defaultLocale: 'en-US',
         hmrEnabled: true,
         immutableAssets: false,
         env: {
@@ -22,7 +22,7 @@ export const RUNTIME_CONFIGS = {
         compat: '0',
         debug: false,
         watchFiles: false,
-        defaultLocale: 'en_US',
+        defaultLocale: 'en-US',
         hmrEnabled: false,
         immutableAssets: true,
         env: {
@@ -36,7 +36,7 @@ export const RUNTIME_CONFIGS = {
         compat: '1',
         debug: false,
         watchFiles: true,
-        defaultLocale: 'en_US',
+        defaultLocale: 'en-US',
         hmrEnabled: false,
         immutableAssets: false,
         env: {
@@ -50,7 +50,7 @@ export const RUNTIME_CONFIGS = {
         compat: '1',
         debug: false,
         watchFiles: false,
-        defaultLocale: 'en_US',
+        defaultLocale: 'en-US',
         hmrEnabled: false,
         immutableAssets: true,
         env: {
@@ -80,8 +80,9 @@ export function getServerModeConfig(serverMode) {
  * @returns {RuntimeEnvironment} the complete runtime environment
  */
 export function getRuntimeEnvironment(config) {
-    const { serverMode, lwrVersion, apiVersion, basePath, minify } = config;
+    const { serverMode, lwrVersion, apiVersion, basePath, i18n, minify } = config;
     const serverModeConfig = getServerModeConfig(config.serverMode);
+    const defaultLocale = i18n.defaultLocale;
     return {
         ...serverModeConfig,
         minify: minify !== null ? minify : serverModeConfig.minify,
@@ -90,6 +91,7 @@ export function getRuntimeEnvironment(config) {
         lwrVersion,
         apiVersion,
         basePath,
+        defaultLocale,
     };
 }
 //# sourceMappingURL=runtime-config.js.map

package/build/es/utils/routes.js

@@ -34,7 +34,10 @@ export function normalizeRoutePaths(routes = [], resourcePaths) {
         // route handler paths are NOT normalized here to maintain the id lookup for route handler invocation
         const { contentTemplate, layoutTemplate, subRoutes } = route;
         if (contentTemplate) {
-            route.contentTemplate = path.resolve(normalizeResourcePath(contentTemplate, resourcePaths));
+            route.contentTemplate =
+                typeof contentTemplate === 'string'
+                    ? path.resolve(normalizeResourcePath(contentTemplate, resourcePaths))
+                    : contentTemplate;
         }
         if (layoutTemplate) {
             route.layoutTemplate = path.resolve(normalizeResourcePath(layoutTemplate, resourcePaths));

package/build/es/validation/app-config-context.d.ts

@@ -1,4 +1,4 @@
-import type { AssetDirConfig, AssetFileConfig, LwrErrorRoute, LwrRoute, NormalizedLwrGlobalConfig, NormalizedLwrAppBootstrapConfig, LwrLockerConfig, RouteHandlersConfig, BundleConfig } from '@lwrjs/types';
+import type { AssetDirConfig, AssetFileConfig, LwrErrorRoute, LwrRoute, NormalizedLwrGlobalConfig, NormalizedLwrAppBootstrapConfig, LwrLockerConfig, RouteHandlersConfig, BundleConfig, I18NConfig, Locale } from '@lwrjs/types';
 import { Node } from 'jsonc-parser';
 import { Diagnostic } from '@lwrjs/diagnostics';
 type RequiredAssetDirConfig = Required<AssetDirConfig>;
@@ -6,6 +6,8 @@ type RequiredAssetFileConfig = Required<AssetFileConfig>;
 type RequiredLwrRoute = Required<LwrRoute>;
 type RequiredLwrErrorRoute = Required<LwrErrorRoute>;
 type RequiredLwrLockerConfig = Required<LwrLockerConfig>;
+type RequiredI18NConfig = Required<I18NConfig>;
+type RequiredLocalesConfig = Required<Locale>;
 interface ConfigMap {
     root: NormalizedLwrGlobalConfig;
     assetDir: RequiredAssetDirConfig;
@@ -18,11 +20,14 @@ interface ConfigMap {
     bundleConfig: BundleConfig;
     'bundleConfig.external': BundleConfig;
     'bundleConfig.groups': BundleConfig;
+    i18n: RequiredI18NConfig;
+    'i18n.locales': RequiredLocalesConfig;
 }
-export declare const ROOT_ATTRIBUTE_KEYS: ["amdLoader", "apiVersion", "assets", "assetProviders", "assetTransformers", "bundleConfig", "bundleProviders", "cacheDir", "contentDir", "environment", "errorRoutes", "esmLoader", "staticSiteGenerator", "globalData", "globalDataDir", "hooks", "ignoreLwrConfigFile", "lwrConfigFile", "layoutsDir", "locker", "lwc", "lwrVersion", "moduleProviders", "port", "basePath", "resourceProviders", "rootDir", "routeHandlers", "routes", "serverMode", "minify", "serverType", "uriTransformers", "viewProviders", "viewTransformers"];
+export declare const ROOT_ATTRIBUTE_KEYS: ["amdLoader", "apiVersion", "assets", "assetProviders", "assetTransformers", "bundleConfig", "bundleProviders", "cacheDir", "contentDir", "environment", "errorRoutes", "esmLoader", "staticSiteGenerator", "globalData", "globalDataDir", "hooks", "i18n", "ignoreLwrConfigFile", "lwrConfigFile", "layoutsDir", "locker", "lwc", "lwrVersion", "moduleProviders", "port", "basePath", "resourceProviders", "rootDir", "routeHandlers", "routes", "serverMode", "minify", "serverType", "uriTransformers", "viewProviders", "viewTransformers"];
 export declare const ASSET_DIR_ATTRIBUTE_KEYS: ["alias", "dir", "urlPath", "root"];
 export declare const ASSET_FILE_ATTRIBUTE_KEYS: ["alias", "file", "urlPath"];
 export declare const LOCKER_ATTRIBUTE_KEYS: ["enabled", "trustedComponents", "clientOnly"];
+export declare const I18N_ATTRIBUTE_KEYS: ["defaultLocale", "locales", "uriPattern"];
 export declare const ROUTE_ATTRIBUTE_KEYS: ["bootstrap", "subRoutes", "contentTemplate", "id", "cache", "layoutTemplate", "method", "path", "rootComponent", "routeHandler", "properties"];
 export declare const ERROR_ROUTE_ATTRIBUTE_KEYS: ["bootstrap", "subRoutes", "contentTemplate", "id", "layoutTemplate", "rootComponent", "routeHandler", "status", "properties", "cache"];
 export declare const BOOTSTRAP_ATTRIBUTE_KEYS: ["autoBoot", "syntheticShadow", "workers", "services", "configAsSrc", "ssr", "mixedMode", "module", "preloadModules"];
@@ -51,12 +56,15 @@ export declare class ValidationContext {
     assertArrayOfStrings(node: Node | undefined, property: string): void;
     assertArrayOfSpecifiers(node: Node | undefined, property: string): void;
     assertArrayOfServices(node: Node | undefined, property: string): void;
+    assertIsStringOrObject(node: Node | undefined, property: string, index?: number): void;
     assertIsService(node: Node | undefined, property: string, index?: number): void;
     assertUniqueIds(nodes: Node[], property: string): void;
     assertClientLockerSSR(routesNode: Node | undefined, lockerNode: Node | undefined): void;
     assertRequiredKeys(node: Node, property: string, requiredPropertyKeys: string[]): void;
     assertValidKeys<T extends keyof ConfigMap>(node: Node, property: T, validPropertyKeys: (keyof ConfigMap[T])[]): void;
     assertNoBundleConfigDupes(node: Node, dupes: string[]): void;
+    assertDefaultInLocales(node: Node, defaultLocale: string, localesIds: string[]): void;
+    assertFallbackIds(nodes: Node[]): void;
 }
 export {};
 //# sourceMappingURL=app-config-context.d.ts.map

package/build/es/validation/app-config-context.js

@@ -1,6 +1,7 @@
 import { findNodeAtLocation } from 'jsonc-parser';
 import { descriptions } from '@lwrjs/diagnostics';
 import { calculatePositionFromSource } from './helpers.js';
+import { isSpecifier } from '@lwrjs/shared-utils';
 // Run the duplicate and missing property checks against an object of a given type
 function createKeys(p, t) {
     return p && t;
@@ -23,6 +24,7 @@ export const ROOT_ATTRIBUTE_KEYS = createKeys('root', [
     'globalData',
     'globalDataDir',
     'hooks',
+    'i18n',
     'ignoreLwrConfigFile',
     'lwrConfigFile',
     'layoutsDir',
@@ -46,6 +48,7 @@ export const ROOT_ATTRIBUTE_KEYS = createKeys('root', [
 export const ASSET_DIR_ATTRIBUTE_KEYS = createKeys('assetDir', ['alias', 'dir', 'urlPath', 'root']);
 export const ASSET_FILE_ATTRIBUTE_KEYS = createKeys('assetFile', ['alias', 'file', 'urlPath']);
 export const LOCKER_ATTRIBUTE_KEYS = createKeys('locker', ['enabled', 'trustedComponents', 'clientOnly']);
+export const I18N_ATTRIBUTE_KEYS = createKeys('i18n', ['defaultLocale', 'locales', 'uriPattern']);
 export const ROUTE_ATTRIBUTE_KEYS = createKeys('routes', [
     'bootstrap',
     'subRoutes',
@@ -82,7 +85,6 @@ export const BOOTSTRAP_ATTRIBUTE_KEYS = createKeys('bootstrap', [
     'module',
     'preloadModules',
 ]);
-const SPECIFIER_REGEX = /^@?[\w-]+(\/[\w-]+)*$/;
 function isNotEmptyString(node) {
     return node.type === 'string' && node.value.length > 0;
 }
@@ -120,7 +122,7 @@ export class ValidationContext {
         }
     }
     assertIsSpecifier(node, property) {
-        if (node && (node.type !== 'string' || !SPECIFIER_REGEX.test(node.value))) {
+        if (node && (node.type !== 'string' || !isSpecifier(node.value))) {
             this.diagnostics.push({
                 description: descriptions.CONFIG_PARSER.INVALID_SPECIFIER(property, node.value),
                 location: this.getLocationFromNode(node),
@@ -305,7 +307,7 @@ export class ValidationContext {
         }
         else if (node.children && node.children.length > 0) {
             node.children.forEach((n, index) => {
-                if (n.type !== 'string' || !SPECIFIER_REGEX.test(n.value)) {
+                if (n.type !== 'string' || !isSpecifier(n.value)) {
                     this.diagnostics.push({
                         description: descriptions.CONFIG_PARSER.INVALID_SPECIFIER(`${property}[${index}]`, n.value),
                         location: this.getLocationFromNode(n),
@@ -328,6 +330,23 @@ export class ValidationContext {
             node.children.forEach((n, index) => this.assertIsService(n, property, index));
         }
     }
+    assertIsStringOrObject(node, property, index) {
+        if (!node) {
+            return;
+        }
+        if (node.type !== 'string' && node.type !== 'object') {
+            this.diagnostics.push({
+                description: descriptions.CONFIG_PARSER.INCORRECT_NODE_TYPE(index !== undefined ? `${property}[${index}]` : property, 'string or object', node.type),
+                location: this.getLocationFromNode(node),
+            });
+        }
+        else if (node.type === 'string' && !isNotEmptyString(node)) {
+            this.diagnostics.push({
+                description: descriptions.CONFIG_PARSER.NON_EMPTY_STRING(property, node.value),
+                location: this.getLocationFromNode(node),
+            });
+        }
+    }
     assertIsService(node, property, index) {
         if (!node) {
             return;
@@ -429,5 +448,32 @@ export class ValidationContext {
             });
         }
     }
+    assertDefaultInLocales(node, defaultLocale, localesIds) {
+        if (!localesIds.includes(defaultLocale)) {
+            this.diagnostics.push({
+                description: descriptions.CONFIG_PARSER.DEFAULT_NOT_IN_LOCALES(defaultLocale, localesIds),
+                location: this.getLocationFromNode(node),
+            });
+        }
+    }
+    assertFallbackIds(nodes) {
+        const localesIds = nodes
+            .map((n) => {
+            const idNode = findNodeAtLocation(n, ['id']);
+            return idNode ? idNode.value : undefined;
+        })
+            .filter((id) => id !== undefined);
+        for (const n of nodes) {
+            const fallbackNode = findNodeAtLocation(n, ['fallback']);
+            if (fallbackNode?.value) {
+                if (!localesIds.includes(fallbackNode.value)) {
+                    this.diagnostics.push({
+                        description: descriptions.CONFIG_PARSER.FALLBACK_NOT_IN_LOCALES(fallbackNode.value, localesIds),
+                        location: this.getLocationFromNode(fallbackNode),
+                    });
+                }
+            }
+        }
+    }
 }
 //# sourceMappingURL=app-config-context.js.map

package/build/es/validation/app-config.js

@@ -1,6 +1,6 @@
 import { parseTree, printParseErrorCode, findNodeAtLocation as findNode, } from 'jsonc-parser';
 import { createSingleDiagnosticError, descriptions, LwrConfigValidationError } from '@lwrjs/diagnostics';
-import { ASSET_DIR_ATTRIBUTE_KEYS, ASSET_FILE_ATTRIBUTE_KEYS, BOOTSTRAP_ATTRIBUTE_KEYS, ERROR_ROUTE_ATTRIBUTE_KEYS, LOCKER_ATTRIBUTE_KEYS, ROOT_ATTRIBUTE_KEYS, ROUTE_ATTRIBUTE_KEYS, ValidationContext, } from './app-config-context.js';
+import { ASSET_DIR_ATTRIBUTE_KEYS, ASSET_FILE_ATTRIBUTE_KEYS, BOOTSTRAP_ATTRIBUTE_KEYS, ERROR_ROUTE_ATTRIBUTE_KEYS, I18N_ATTRIBUTE_KEYS, LOCKER_ATTRIBUTE_KEYS, ROOT_ATTRIBUTE_KEYS, ROUTE_ATTRIBUTE_KEYS, ValidationContext, } from './app-config-context.js';
 import { calculatePositionFromSource } from './helpers.js';
 import { DEFAULT_ESM_BUNDLE_EXCLUSIONS, DEFAULT_AMD_BUNDLE_EXCLUSIONS } from '../defaults.js';
 import { ConfigSpan, getTracer } from '@lwrjs/instrumentation';
@@ -51,7 +51,7 @@ function validateBootstrap(node, validationContext, propPrefix) {
  *          - contentTemplate
  *          - routeHandler
  *      - rootComponent: optional specifier
- *      - contentTemplate: optional string
+ *      - contentTemplate: optional string or object
  *      - layoutTemplate: optional string
  *      - routeHandler: optional string
  *      - optional bootstrap...
@@ -64,7 +64,7 @@ function validateRouteCommon(node, validationContext, propPrefix) {
     ]);
     validationContext.assertNotEmptyString(findNode(node, ['id']), `${propPrefix}.id`);
     validationContext.assertIsSpecifier(findNode(node, ['rootComponent']), `${propPrefix}.rootComponent`);
-    validationContext.assertNotEmptyString(findNode(node, ['contentTemplate']), `${propPrefix}.contentTemplate`);
+    validationContext.assertIsStringOrObject(findNode(node, ['contentTemplate']), `${propPrefix}.contentTemplate`);
     validationContext.assertNotEmptyString(findNode(node, ['layoutTemplate']), `${propPrefix}.layoutTemplate`);
     validationContext.assertIsService(findNode(node, ['routeHandler']), `${propPrefix}.routeHandler`);
     validateBootstrap(findNode(node, ['bootstrap']), validationContext, `${propPrefix}.bootstrap`);
@@ -96,6 +96,31 @@ function validateRoutes(node, validationContext, preMerge) {
         }
     }
 }
+function validateI18NConfig(node, validationContext, preMerge) {
+    if (node) {
+        // i18n may not be defined until after config hooks are applied
+        // note: there are 2 "post" hooks (onConfig/onStart) that i18n can be applied.
+        // We need to ensure that we only validate after the last one (if both are used)
+        if (!preMerge) {
+            validationContext.assertIsObject(node, 'i18n');
+        }
+        validationContext.assertIsObject(node, 'i18n');
+        validationContext.assertValidKeys(node, 'i18n', I18N_ATTRIBUTE_KEYS);
+        validationContext.assertRequiredKeys(node, 'i18n', ['defaultLocale', 'locales']);
+        // Validate locales
+        const locales = findNode(node, ['locales']);
+        validationContext.assertNotEmptyArray(locales, 'i18n.locales');
+        if (locales) {
+            validationContext.assertUniqueIds([...(locales?.children || [])], 'i18n.locales');
+            validationContext.assertFallbackIds([...(locales?.children || [])]);
+        }
+        // Validate defaultLocale
+        const defaultLocale = findNode(node, ['defaultLocale']);
+        validationContext.assertNotEmptyString(defaultLocale, 'i18n.defaultLocale');
+        const localeIds = locales?.children?.map((n) => findNode(n, ['id'])?.value) || [];
+        validationContext.assertDefaultInLocales(node, defaultLocale?.value, localeIds);
+    }
+}
 function validateBundleConfig(node, validationContext) {
     if (node) {
         validationContext.assertIsObject(node, 'bundleConfig');
@@ -274,6 +299,7 @@ function validateRoot(node, validationContext, preMerge) {
     validateRouteHandlers(findNode(node, ['routeHandlers']), validationContext);
     validateAssets(findNode(node, ['assets']), validationContext, preMerge);
     validateLocker(lockerNode, validationContext);
+    validateI18NConfig(findNode(node, ['i18n']), validationContext, preMerge);
     validateBundleConfig(bundleConfigNode, validationContext);
     validationContext.assertClientLockerSSR(routes, lockerNode);
     validationContext.assertNotEmptyString(findNode(node, ['apiVersion']), 'apiVersion');

package/package.json

@@ -4,7 +4,7 @@
     "publishConfig": {
         "access": "public"
     },
-    "version": "0.11.0-alpha.3",
+    "version": "0.11.0-alpha.6",
     "homepage": "https://developer.salesforce.com/docs/platform/lwr/overview",
     "repository": {
         "type": "git",
@@ -41,14 +41,14 @@
         "test": "jest"
     },
     "dependencies": {
-        "@lwrjs/diagnostics": "0.11.0-alpha.3",
-        "@lwrjs/instrumentation": "0.11.0-alpha.3",
-        "@lwrjs/shared-utils": "0.11.0-alpha.3",
+        "@lwrjs/diagnostics": "0.11.0-alpha.6",
+        "@lwrjs/instrumentation": "0.11.0-alpha.6",
+        "@lwrjs/shared-utils": "0.11.0-alpha.6",
         "fs-extra": "^11.1.1",
         "jsonc-parser": "^3.0.0"
     },
     "devDependencies": {
-        "@lwrjs/types": "0.11.0-alpha.3",
+        "@lwrjs/types": "0.11.0-alpha.6",
         "jest": "^26.6.3",
         "ts-jest": "^26.5.6"
     },
@@ -61,5 +61,5 @@
     "volta": {
         "extends": "../../../package.json"
     },
-    "gitHead": "720b7b5525f93c089f8d97bdef692927ad520d39"
+    "gitHead": "571d4bac5650765aa818bcb9d5ed752a8cf041af"
 }