@lwrjs/view-registry 0.11.0-alpha.1 → 0.11.0-alpha.10

package/build/cjs/index.cjs

@@ -150,6 +150,7 @@ var LwrViewRegistry = class {
       layoutTemplate,
       freezeAssets,
       locale: runtimeParams?.locale,
+      basePath: runtimeParams?.basePath,
       debug: runtimeEnvironment.debug
     });
     const viewParamKey = viewParamCacheKey ? (0, import_shared_utils.getCacheKeyFromJson)(viewParamCacheKey) : (0, import_shared_utils.getCacheKeyFromJson)(viewParams);
@@ -167,6 +168,7 @@ var LwrViewRegistry = class {
       ...view,
       freezeAssets,
       locale: runtimeParams?.locale,
+      basePath: runtimeParams?.basePath,
       debug: runtimeEnvironment.debug
     });
     const viewParamKey = viewParamCacheKey ? (0, import_shared_utils.getCacheKeyFromJson)(viewParamCacheKey) : (0, import_shared_utils.getCacheKeyFromJson)(viewParams);
@@ -199,9 +201,9 @@ var LwrViewRegistry = class {
     return viewDefinition;
   }
   async renderView(view, viewParams, runtimeEnvironment, runtimeParams = {}, renderOptions) {
-    const {contentTemplate, rootComponent, layoutTemplate} = view;
+    const {id, contentTemplate, rootComponent, layoutTemplate} = view;
     const lwrResourcesId = `__LWR_RESOURCES__${Date.now()}`;
-    const renderedContent = await this.render({contentTemplate, rootComponent}, {...viewParams, lwr_resources: lwrResourcesId}, renderOptions);
+    const renderedContent = await this.render({id, contentTemplate, rootComponent}, {...viewParams, lwr_resources: lwrResourcesId}, runtimeParams, renderOptions);
     let normalizedRenderOptions = (0, import_utils.normalizeRenderOptions)(this.runtimeEnvironment, renderedContent.options, renderOptions);
     const layout = layoutTemplate || renderedContent.compiledView.layoutTemplate;
     if (!layout) {
@@ -216,12 +218,12 @@ var LwrViewRegistry = class {
       return renderedViewDef2;
     }
     const layoutTemplatePath = (0, import_shared_utils.normalizeResourcePath)(layout, this.globalConfig);
-    const renderedLayout = await this.render({contentTemplate: layoutTemplatePath}, {
+    const renderedLayout = await this.render({id, contentTemplate: layoutTemplatePath}, {
       ...renderedContent.compiledView.properties,
       ...viewParams,
       body: renderedContent.renderedView,
       lwr_resources: lwrResourcesId
-    });
+    }, runtimeParams);
     normalizedRenderOptions = (0, import_utils.normalizeRenderOptions)(this.runtimeEnvironment, renderedLayout.options, normalizedRenderOptions);
     const renderedViewDef = await this.link({
       ...renderedLayout,
@@ -237,7 +239,11 @@ var LwrViewRegistry = class {
         assetReferences: [
           ...renderedContent.metadata.assetReferences,
           ...renderedLayout.metadata.assetReferences
-        ]
+        ],
+        serverData: {
+          ...renderedContent.metadata.serverData,
+          ...renderedLayout.metadata.serverData
+        }
       }
     }, {
       view: {...view, layoutTemplate: layoutTemplatePath},
@@ -250,14 +256,12 @@ var LwrViewRegistry = class {
     });
     return renderedViewDef;
   }
-  async render(viewId, viewParams, renderOptions) {
+  async render(viewId, viewParams, runtimeParams, renderOptions) {
     const globalContext = this.globalData;
-    const {rootComponent, contentTemplate} = viewId;
-    const compiledView = await this.getView({
-      contentTemplate,
-      rootComponent
-    }, renderOptions?.skipCaching);
+    const {id, rootComponent, contentTemplate} = viewId;
+    const compiledView = await this.getView({id, contentTemplate, rootComponent}, renderOptions?.skipCaching);
     const result = await compiledView.render({
+      ...runtimeParams,
       ...globalContext,
       ...compiledView.properties,
       ...viewParams
@@ -287,7 +291,7 @@ var LwrViewRegistry = class {
       metadata: renderedViewMetadata,
       compiledView: {immutable = true}
     } = renderedView;
-    const linkedMetadata = skipMetadataCollection ? renderedViewMetadata : await (0, import_shared_utils.extractMetadataFromHtml)(renderedViewContent);
+    const linkedMetadata = skipMetadataCollection ? renderedViewMetadata : await (0, import_shared_utils.extractMetadataFromHtml)(renderedViewContent, renderedViewMetadata);
     const mergedViewContext = {
       ...viewContext,
       runtimeEnvironment,

package/build/cjs/linkers/legacy_view_bootstrap.cjs

@@ -26,6 +26,7 @@ __markAsModule(exports);
 __export(exports, {
   getHtmlResources: () => getHtmlResources
 });
+var import_diagnostics = __toModule(require("@lwrjs/diagnostics"));
 var import_shared_utils = __toModule(require("@lwrjs/shared-utils"));
 var import_identity = __toModule(require("@lwrjs/app-service/identity"));
 var import_utils = __toModule(require("../utils.cjs"));
@@ -41,7 +42,7 @@ async function getHtmlResources(view, viewParams, resourceContext) {
     viewMetadata
   } = resourceContext;
   const {lwrVersion, format, hmrEnabled, bundle, debug, minify} = runtimeEnvironment;
-  const {customElements, ssrProps} = viewMetadata;
+  const {customElements, serverData, serverDebug} = viewMetadata;
   const version = lwrVersion;
   const isAMD = format === "amd";
   const {bundleConfig} = resourceContext;
@@ -142,7 +143,7 @@ async function getHtmlResources(view, viewParams, resourceContext) {
         if (uri2) {
           imports[dynamicDep] = uri2;
         } else {
-          import_shared_utils.logger.warn("Skipping unknown dynamic import " + dynamicDep);
+          import_diagnostics.logger.warn("Skipping unknown dynamic import " + dynamicDep);
         }
       }
     }
@@ -191,10 +192,10 @@ async function getHtmlResources(view, viewParams, resourceContext) {
         default: (0, import_shared_utils.getModuleUriPrefix)(runtimeEnvironment, runtimeParams)
       },
       rootComponents,
-      ssrProps,
+      serverData,
       ...isAMD && {requiredModules: requiredAmdModules},
       ...isAMD && {preloadModules: viewPreloads.specifiers}
-    }, runtimeEnvironment, runtimeParams));
+    }, runtimeEnvironment, runtimeParams, serverDebug?.message));
   }
   if (!isAMD && hmrEnabled) {
     configResources.unshift((0, import_utils2.getViewHmrConfigurationResource)(view, viewMetadata));

package/build/cjs/linkers/preload-utils.cjs

@@ -27,6 +27,7 @@ __export(exports, {
   getPreloadModulesMeta: () => getPreloadModulesMeta,
   setPreloadModulesMeta: () => setPreloadModulesMeta
 });
+var import_diagnostics = __toModule(require("@lwrjs/diagnostics"));
 var import_shared_utils = __toModule(require("@lwrjs/shared-utils"));
 function setPreloadModulesMeta(specifier, uri, groups, preloads) {
   const [removedVersion, version] = specifier.split("/v/");
@@ -54,7 +55,7 @@ async function getPreloadModulesMeta(specifier, viewPreloads, bundleConfig, modu
     return exclude.includes(specifier2);
   };
   if (isExternal(specifier)) {
-    import_shared_utils.logger.warn(`"${specifier}" is configured in both bundleConfig.externals and bootstrap.preloadModules. We are treating it as external.`);
+    import_diagnostics.logger.warn(`"${specifier}" is configured in both bundleConfig.externals and bootstrap.preloadModules. We are treating it as external.`);
   } else {
     const versionedModuleId = await (0, import_shared_utils.getVersionedModuleId)(specifier, moduleRegistry, runtimeParams);
     const versionedModuleSpecifier = (0, import_shared_utils.getSpecifier)({

package/build/cjs/linkers/utils.cjs

@@ -30,7 +30,7 @@ __export(exports, {
 });
 var import_shared_utils = __toModule(require("@lwrjs/shared-utils"));
 var CONTENT_TYPE = "application/javascript";
-function getViewBootstrapConfigurationResource(viewInfo, config, runtimeEnvironment, runtimeParams) {
+function getViewBootstrapConfigurationResource(viewInfo, config, runtimeEnvironment, runtimeParams, debugMessage) {
   const {compat, debug, hmrEnabled, apiVersion, format} = runtimeEnvironment;
   const isESM = format === "esm";
   const defaultUrl = (0, import_shared_utils.getModuleUriPrefix)(runtimeEnvironment, runtimeParams);
@@ -45,6 +45,11 @@ function getViewBootstrapConfigurationResource(viewInfo, config, runtimeEnvironm
     },
     ...debug && {modifiers: {debug: "true"}}
   };
+  const environment = {
+    NODE_ENV: runtimeEnvironment.serverMode,
+    SSR: false,
+    ...(0, import_shared_utils.buildEnvironmentContext)(runtimeParams)
+  };
   const configString = [
     "/* This script is generated */",
     "/* Client Bootstrap configuration */",
@@ -53,8 +58,9 @@ function getViewBootstrapConfigurationResource(viewInfo, config, runtimeEnvironm
       ...config,
       endpoints
     })});`,
-    `globalThis.process = { env: { NODE_ENV: "${runtimeEnvironment.serverMode}", SSR: false } };`,
-    `globalThis.lwcRuntimeFlags = { ENABLE_MIXED_SHADOW_MODE: ${viewInfo.mixedMode} };`
+    `globalThis.process = { env: ${JSON.stringify(environment)} };`,
+    `globalThis.lwcRuntimeFlags = { ENABLE_MIXED_SHADOW_MODE: ${viewInfo.mixedMode} };`,
+    debug && debugMessage && `console.warn(${JSON.stringify(debugMessage)});`
   ].filter(Boolean).join("\n");
   if (viewInfo.configAsSrc) {
     const viewUrl = viewInfo.url || "/";

package/build/cjs/linkers/view_bootstrap.cjs

@@ -26,6 +26,7 @@ __markAsModule(exports);
 __export(exports, {
   getHtmlResources: () => getHtmlResources
 });
+var import_diagnostics = __toModule(require("@lwrjs/diagnostics"));
 var import_shared_utils = __toModule(require("@lwrjs/shared-utils"));
 var import_identity = __toModule(require("@lwrjs/app-service/identity"));
 var import_utils = __toModule(require("../utils.cjs"));
@@ -41,7 +42,7 @@ async function getHtmlResources(view, viewParams, resourceContext) {
     viewMetadata
   } = resourceContext;
   const {lwrVersion, format, hmrEnabled, bundle, debug, minify} = runtimeEnvironment;
-  const {customElements, ssrProps} = viewMetadata;
+  const {customElements, serverData, serverDebug} = viewMetadata;
   const defRegistry = bundle ? moduleBundler : moduleRegistry;
   const version = lwrVersion;
   const isAMD = format === "amd";
@@ -133,7 +134,7 @@ async function getHtmlResources(view, viewParams, resourceContext) {
         if (uri2) {
           imports[dynamicDep] = uri2;
         } else {
-          import_shared_utils.logger.warn("Skipping unknown dynamic import " + dynamicDep);
+          import_diagnostics.logger.warn("Skipping unknown dynamic import " + dynamicDep);
         }
       }
     }
@@ -182,10 +183,10 @@ async function getHtmlResources(view, viewParams, resourceContext) {
       imports: importMetadata?.imports,
       index: importMetadata?.index,
       rootComponents,
-      ssrProps,
+      serverData,
       ...isAMD && {requiredModules: requiredAmdModules},
       ...isAMD && {preloadModules: viewPreloads.specifiers}
-    }, runtimeEnvironment, runtimeParams));
+    }, runtimeEnvironment, runtimeParams, serverDebug?.message));
   }
   if (!isAMD && hmrEnabled) {
     configResources.unshift((0, import_utils2.getViewHmrConfigurationResource)(view, viewMetadata));

package/build/cjs/utils.cjs

@@ -93,7 +93,8 @@ function normalizeRenderedResult({
     renderedView,
     metadata: {
       customElements: metadata ? metadata.customElements : [],
-      assetReferences: metadata ? metadata.assetReferences : []
+      assetReferences: metadata ? metadata.assetReferences : [],
+      serverData: metadata ? metadata.serverData : {}
     },
     options: {
       skipMetadataCollection: options ? options.skipMetadataCollection : false
@@ -120,11 +121,13 @@ function normalizeRenderOptions(runtimeEnvironment, overrideRenderOptions, baseR
   };
 }
 function getTitleFromFilePath(filePath) {
-  return filePath ? (0, import_path.basename)(filePath, (0, import_path.extname)(filePath)) : import_shared_utils.DEFAULT_TITLE;
+  return filePath && typeof filePath === "string" ? (0, import_path.basename)(filePath, (0, import_path.extname)(filePath)) : import_shared_utils.DEFAULT_TITLE;
 }
-function generatePageContext({requestPath: url}, {id, contentTemplate, properties}) {
+function generatePageContext({requestPath: url}, {id, contentTemplate, properties}, runtimeParams) {
   const title = properties?.title || getTitleFromFilePath(contentTemplate);
-  return {id, title, url};
+  const locale = runtimeParams.locale;
+  const basePath = runtimeParams.basePath;
+  return {basePath, id, locale, title, url};
 }
 function isViewResponse(response) {
   return response.body !== void 0;

package/build/cjs/view-handler.cjs

@@ -37,15 +37,16 @@ var LwrViewHandler = class {
     this.viewRegistry = context.viewRegistry;
     this.moduleRegistry = context.moduleRegistry;
   }
-  async getViewContent(viewRequest, route, runtimeEnvironment, runtimeParams = {}) {
+  async getViewContent(viewRequest, route, runtimeEnvironment, runtimeParams) {
     if (route.routeHandler) {
       const response = await this.getRouteHandlerResponse(viewRequest, route, runtimeEnvironment, runtimeParams);
       if ((0, import_utils.isViewResponse)(response)) {
         return response;
       }
-      const {view, viewParams, renderOptions} = normalizeViewProperties(viewRequest, response, route, this.globalConfig);
+      const {view, viewParams, renderOptions} = normalizeViewProperties(viewRequest, response, route, this.globalConfig, runtimeParams);
       const viewDefinition2 = await this.viewRegistry.getViewDefinition(view, viewParams, runtimeEnvironment, {
         ...runtimeParams,
+        url: viewRequest.url,
         params: viewRequest.params,
         query: viewRequest.query
       }, renderOptions);
@@ -73,7 +74,7 @@ var LwrViewHandler = class {
       if ((0, import_utils.isViewResponse)(response)) {
         return response;
       }
-      const {view, viewParams, renderOptions} = normalizeViewProperties(viewRequest, response, route, this.globalConfig);
+      const {view, viewParams, renderOptions} = normalizeViewProperties(viewRequest, response, route, this.globalConfig, runtimeParams);
       const viewDefinition2 = await this.viewRegistry.getViewDefinition(view, viewParams, runtimeEnvironment, runtimeParams, renderOptions);
       return {
         ...response,
@@ -90,7 +91,7 @@ var LwrViewHandler = class {
       if ((0, import_utils.isViewResponse)(response)) {
         return response;
       }
-      const {view, viewParams, renderOptions} = normalizeViewProperties(viewRequest, response, route, this.globalConfig);
+      const {view, viewParams, renderOptions} = normalizeViewProperties(viewRequest, response, route, this.globalConfig, runtimeParams);
       viewDefinition = await this.viewRegistry.getViewDefinition(view, viewParams, runtimeEnvironment, runtimeParams, renderOptions);
     } else {
       viewDefinition = await this.getDefaultRouteViewDefinition(viewRequest, route, runtimeEnvironment, runtimeParams);
@@ -110,7 +111,7 @@ var LwrViewHandler = class {
   }
   async getDefaultRouteViewDefinition(viewRequest, route, runtimeEnvironment, runtimeParams = {}) {
     const {id, bootstrap, rootComponent, contentTemplate, layoutTemplate, properties} = route;
-    const page = (0, import_utils.generatePageContext)(viewRequest, route);
+    const page = (0, import_utils.generatePageContext)(viewRequest, route, runtimeParams);
     const viewDefinition = await this.viewRegistry.getViewDefinition({
       id,
       bootstrap,
@@ -119,6 +120,7 @@ var LwrViewHandler = class {
       layoutTemplate
     }, {page, ...properties}, runtimeEnvironment, {
       ...runtimeParams,
+      url: viewRequest.url,
       params: viewRequest.params,
       query: viewRequest.query
     });
@@ -128,7 +130,8 @@ var LwrViewHandler = class {
     if (!route.routeHandler) {
       throw new Error("Route handler is required for a CustomView");
     }
-    const [routeHandlerFn, routeHandlerOptions] = this.routeHandlers[route.routeHandler[0]];
+    const routeHandlerOptions = route.routeHandler[1];
+    const routeHandlerFn = this.routeHandlers[route.routeHandler[0]];
     if (!routeHandlerFn) {
       throw new Error(`Route handler does not exist for id: ${route.routeHandler}`);
     }
@@ -168,7 +171,7 @@ var LwrViewHandler = class {
       view: normalizedView,
       viewParams: normalizedViewParams,
       renderOptions: normalizedRenderOptions
-    } = normalizeViewProperties(viewRequest, viewResponse, route, this.globalConfig);
+    } = normalizeViewProperties(viewRequest, viewResponse, route, this.globalConfig, runtimeParams);
     const viewDefinition = await this.viewRegistry.getViewDefinition(normalizedView, normalizedViewParams, runtimeEnvironment, runtimeParams, normalizedRenderOptions);
     return {
       body: viewDefinition.renderedView,
@@ -179,7 +182,7 @@ var LwrViewHandler = class {
     };
   }
 };
-function normalizeViewProperties(viewRequest, response, route, config) {
+function normalizeViewProperties(viewRequest, response, route, config, runtimeParams) {
   const {
     view: {rootComponent, contentTemplate: cTemplate, layoutTemplate: lTemplate},
     viewParams,
@@ -191,14 +194,16 @@ function normalizeViewProperties(viewRequest, response, route, config) {
     ...route,
     contentTemplate: cTemplate,
     properties: viewParams
-  });
+  }, runtimeParams);
   const {id, bootstrap} = route;
   return {
     view: {
       id,
       bootstrap,
       ...rootComponent && {rootComponent},
-      ...cTemplate && {contentTemplate: (0, import_path.resolve)((0, import_shared_utils.normalizeResourcePath)(cTemplate, paths))},
+      ...cTemplate && {
+        contentTemplate: typeof cTemplate === "string" ? (0, import_path.resolve)((0, import_shared_utils.normalizeResourcePath)(cTemplate, paths)) : cTemplate
+      },
       ...lTemplate && {layoutTemplate: (0, import_path.resolve)((0, import_shared_utils.normalizeResourcePath)(lTemplate, paths))}
     },
     viewParams: {page, ...viewParams},

package/build/es/index.js

@@ -136,6 +136,7 @@ export class LwrViewRegistry {
             layoutTemplate,
             freezeAssets,
             locale: runtimeParams?.locale,
+            basePath: runtimeParams?.basePath,
             debug: runtimeEnvironment.debug,
         });
         // viewParams is an unbounded object and can be very large (17MB/view for developer.salesforce.com). Allowing conusmers
@@ -159,6 +160,7 @@ export class LwrViewRegistry {
             ...view,
             freezeAssets,
             locale: runtimeParams?.locale,
+            basePath: runtimeParams?.basePath,
             debug: runtimeEnvironment.debug,
         });
         // viewParams is an unbounded object and can be very large (17MB/view for developer.salesforce.com). Allowing consumers
@@ -202,9 +204,9 @@ export class LwrViewRegistry {
         return viewDefinition;
     }
     async renderView(view, viewParams, runtimeEnvironment, runtimeParams = {}, renderOptions) {
-        const { contentTemplate, rootComponent, layoutTemplate } = view;
+        const { id, contentTemplate, rootComponent, layoutTemplate } = view;
         const lwrResourcesId = `__LWR_RESOURCES__${Date.now()}`;
-        const renderedContent = await this.render({ contentTemplate, rootComponent }, { ...viewParams, lwr_resources: lwrResourcesId }, renderOptions);
+        const renderedContent = await this.render({ id, contentTemplate, rootComponent }, { ...viewParams, lwr_resources: lwrResourcesId }, runtimeParams, renderOptions);
         // normalize the renderOptions provided by the CompiledView content with the request options.
         let normalizedRenderOptions = normalizeRenderOptions(this.runtimeEnvironment, renderedContent.options, renderOptions);
         const layout = layoutTemplate || renderedContent.compiledView.layoutTemplate;
@@ -223,12 +225,12 @@ export class LwrViewRegistry {
         }
         // Layout wrapped content: pass in the view provider properties and body from the rendered content
         const layoutTemplatePath = normalizeResourcePath(layout, this.globalConfig);
-        const renderedLayout = await this.render({ contentTemplate: layoutTemplatePath }, {
+        const renderedLayout = await this.render({ id, contentTemplate: layoutTemplatePath }, {
             ...renderedContent.compiledView.properties,
             ...viewParams,
             body: renderedContent.renderedView,
             lwr_resources: lwrResourcesId,
-        });
+        }, runtimeParams);
         normalizedRenderOptions = normalizeRenderOptions(this.runtimeEnvironment, renderedLayout.options, normalizedRenderOptions);
         const renderedViewDef = await this.link({
             ...renderedLayout,
@@ -247,6 +249,10 @@ export class LwrViewRegistry {
                     ...renderedContent.metadata.assetReferences,
                     ...renderedLayout.metadata.assetReferences,
                 ],
+                serverData: {
+                    ...renderedContent.metadata.serverData,
+                    ...renderedLayout.metadata.serverData,
+                },
             },
         }, 
         // Render Content now contains a layout
@@ -263,13 +269,10 @@ export class LwrViewRegistry {
         });
         return renderedViewDef;
     }
-    async render(viewId, viewParams, renderOptions) {
+    async render(viewId, viewParams, runtimeParams, renderOptions) {
         const globalContext = this.globalData;
-        const { rootComponent, contentTemplate } = viewId;
-        const compiledView = await this.getView({
-            contentTemplate,
-            rootComponent,
-        }, renderOptions?.skipCaching);
+        const { id, rootComponent, contentTemplate } = viewId;
+        const compiledView = await this.getView({ id, contentTemplate, rootComponent }, renderOptions?.skipCaching);
         // Get content/body of the view
         /*
             When rendering the compiled view, a collection variable properties can be passed to the render() to be rendered in
@@ -281,6 +284,7 @@ export class LwrViewRegistry {
             These are merged together in to a combined context used by render()
         */
         const result = await compiledView.render({
+            ...runtimeParams,
             ...globalContext,
             ...compiledView.properties,
             ...viewParams,
@@ -301,7 +305,7 @@ export class LwrViewRegistry {
         const { renderedView: renderedViewContent, metadata: renderedViewMetadata, compiledView: { immutable = true }, } = renderedView;
         const linkedMetadata = skipMetadataCollection
             ? renderedViewMetadata
-            : await extractMetadataFromHtml(renderedViewContent);
+            : await extractMetadataFromHtml(renderedViewContent, renderedViewMetadata);
         const mergedViewContext = {
             ...viewContext,
             runtimeEnvironment,

package/build/es/linkers/legacy_view_bootstrap.js

@@ -1,4 +1,5 @@
-import { kebabCaseToModuleSpecifier, getModuleGraphs, GraphDepth, getModuleUriPrefix, logger, explodeSpecifier, isBundler, getHydrateDirective, } from '@lwrjs/shared-utils';
+import { logger } from '@lwrjs/diagnostics';
+import { kebabCaseToModuleSpecifier, getModuleGraphs, GraphDepth, getModuleUriPrefix, explodeSpecifier, isBundler, getHydrateDirective, } from '@lwrjs/shared-utils';
 import { AppResourceEnum, getAppSpecifier } from '@lwrjs/app-service/identity';
 import { generateHtmlTag, getModuleResourceByUri } from '../utils.js';
 import { flattenCustomElements, getViewBootstrapConfigurationResource, getViewHmrConfigurationResource, } from './utils.js';
@@ -6,7 +7,7 @@ import { setPreloadModulesMeta, getPreloadModulesMeta } from './preload-utils.js
 export async function getHtmlResources(view, viewParams, resourceContext) {
     const { runtimeEnvironment, runtimeParams, moduleRegistry, moduleBundler, resourceRegistry, viewMetadata, } = resourceContext;
     const { lwrVersion, format, hmrEnabled, bundle, debug, minify } = runtimeEnvironment;
-    const { customElements, ssrProps } = viewMetadata;
+    const { customElements, serverData, serverDebug } = viewMetadata;
     const version = lwrVersion;
     const isAMD = format === 'amd';
     const { bundleConfig } = resourceContext;
@@ -209,11 +210,11 @@ export async function getHtmlResources(view, viewParams, resourceContext) {
                 default: getModuleUriPrefix(runtimeEnvironment, runtimeParams),
             },
             rootComponents,
-            ssrProps,
+            serverData,
             ...(isAMD && { requiredModules: requiredAmdModules }),
             // in AMD we need to tell the loader what modules we are preloading
             ...(isAMD && { preloadModules: viewPreloads.specifiers }),
-        }, runtimeEnvironment, runtimeParams));
+        }, runtimeEnvironment, runtimeParams, serverDebug?.message));
     }
     if (!isAMD && hmrEnabled) {
         configResources.unshift(getViewHmrConfigurationResource(view, viewMetadata));

package/build/es/linkers/preload-utils.js

@@ -1,4 +1,5 @@
-import { explodeSpecifier, getGroupName, getVersionedModuleId, normalizeVersionToUri, logger, VERSION_NOT_PROVIDED, getSpecifier, isGroupie, } from '@lwrjs/shared-utils';
+import { logger } from '@lwrjs/diagnostics';
+import { explodeSpecifier, getGroupName, getVersionedModuleId, normalizeVersionToUri, VERSION_NOT_PROVIDED, getSpecifier, isGroupie, } from '@lwrjs/shared-utils';
 /**
  * keeps track of preloadModules metadata
  */

package/build/es/linkers/utils.d.ts

@@ -1,5 +1,5 @@
 import type { ClientBootstrapConfig, RuntimeEnvironment, RuntimeParams, ResourceDefinition, RenderedViewMetadata, CustomElementReference, View, ViewInfo } from '@lwrjs/types';
-export declare function getViewBootstrapConfigurationResource(viewInfo: ViewInfo, config: ClientBootstrapConfig, runtimeEnvironment: RuntimeEnvironment, runtimeParams?: RuntimeParams): ResourceDefinition;
+export declare function getViewBootstrapConfigurationResource(viewInfo: ViewInfo, config: ClientBootstrapConfig, runtimeEnvironment: RuntimeEnvironment, runtimeParams: RuntimeParams, debugMessage?: string): ResourceDefinition;
 export declare function getViewHmrConfigurationResource(view: View, viewMetadata: RenderedViewMetadata): ResourceDefinition;
 export declare function flattenCustomElements(arr: CustomElementReference[], isSSR?: boolean): CustomElementReference[];
 //# sourceMappingURL=utils.d.ts.map

package/build/es/linkers/utils.js

@@ -1,6 +1,6 @@
-import { getMappingUriPrefix, getModuleUriPrefix, getClientBootstrapConfigurationUri, hashContent, } from '@lwrjs/shared-utils';
+import { buildEnvironmentContext, getMappingUriPrefix, getModuleUriPrefix, getClientBootstrapConfigurationUri, hashContent, } from '@lwrjs/shared-utils';
 const CONTENT_TYPE = 'application/javascript';
-export function getViewBootstrapConfigurationResource(viewInfo, config, runtimeEnvironment, runtimeParams) {
+export function getViewBootstrapConfigurationResource(viewInfo, config, runtimeEnvironment, runtimeParams, debugMessage) {
     const { compat, debug, hmrEnabled, apiVersion, format } = runtimeEnvironment;
     const isESM = format === 'esm';
     const defaultUrl = getModuleUriPrefix(runtimeEnvironment, runtimeParams);
@@ -17,6 +17,14 @@ export function getViewBootstrapConfigurationResource(viewInfo, config, runtimeE
         },
         ...(debug && { modifiers: { debug: 'true' } }),
     };
+    const environment = {
+        // TODO: W-12639529 change NODE_ENV after addressing downstream customers
+        NODE_ENV: runtimeEnvironment.serverMode,
+        // Note: SSR is always false because this script is executed on the client
+        SSR: false,
+        // Used by `lwr/environment`
+        ...buildEnvironmentContext(runtimeParams),
+    };
     const configString = [
         '/* This script is generated */',
         '/* Client Bootstrap configuration */',
@@ -25,10 +33,9 @@ export function getViewBootstrapConfigurationResource(viewInfo, config, runtimeE
             ...config,
             endpoints,
         })});`,
-        // TODO: W-12639529 change NODE_ENV after addressing downstream customers
-        // Note: SSR is always false because this script is executed on the client
-        `globalThis.process = { env: { NODE_ENV: "${runtimeEnvironment.serverMode}", SSR: false } };`,
+        `globalThis.process = { env: ${JSON.stringify(environment)} };`,
         `globalThis.lwcRuntimeFlags = { ENABLE_MIXED_SHADOW_MODE: ${viewInfo.mixedMode} };`,
+        debug && debugMessage && `console.warn(${JSON.stringify(debugMessage)});`,
     ]
         .filter(Boolean)
         .join('\n');

package/build/es/linkers/view_bootstrap.js

@@ -1,4 +1,5 @@
-import { kebabCaseToModuleSpecifier, toImportMetadata, getModuleGraphs, getMappingUriPrefix, GraphDepth, logger, explodeSpecifier, isBundler, getHydrateDirective, } from '@lwrjs/shared-utils';
+import { logger } from '@lwrjs/diagnostics';
+import { kebabCaseToModuleSpecifier, toImportMetadata, getModuleGraphs, getMappingUriPrefix, GraphDepth, explodeSpecifier, isBundler, getHydrateDirective, } from '@lwrjs/shared-utils';
 import { AppResourceEnum, getAppSpecifier } from '@lwrjs/app-service/identity';
 import { generateHtmlTag, getModuleResourceByUri } from '../utils.js';
 import { flattenCustomElements, getViewBootstrapConfigurationResource, getViewHmrConfigurationResource, } from './utils.js';
@@ -6,7 +7,7 @@ import { setPreloadModulesMeta, getPreloadModulesMeta } from './preload-utils.js
 export async function getHtmlResources(view, viewParams, resourceContext) {
     const { runtimeEnvironment, runtimeParams, moduleRegistry, moduleBundler, resourceRegistry, viewMetadata, } = resourceContext;
     const { lwrVersion, format, hmrEnabled, bundle, debug, minify } = runtimeEnvironment;
-    const { customElements, ssrProps } = viewMetadata;
+    const { customElements, serverData, serverDebug } = viewMetadata;
     const defRegistry = bundle ? moduleBundler : moduleRegistry;
     const version = lwrVersion;
     const isAMD = format === 'amd';
@@ -195,11 +196,11 @@ export async function getHtmlResources(view, viewParams, resourceContext) {
             imports: importMetadata?.imports,
             index: importMetadata?.index,
             rootComponents,
-            ssrProps,
+            serverData,
             ...(isAMD && { requiredModules: requiredAmdModules }),
             // in AMD we need to tell the loader what modules we are preloading
             ...(isAMD && { preloadModules: viewPreloads.specifiers }),
-        }, runtimeEnvironment, runtimeParams));
+        }, runtimeEnvironment, runtimeParams, serverDebug?.message));
     }
     if (!isAMD && hmrEnabled) {
         configResources.unshift(getViewHmrConfigurationResource(view, viewMetadata));

package/build/es/utils.d.ts

@@ -4,7 +4,7 @@ export declare function generateHtmlTag(definition: HTMLResource): Promise<strin
 export declare function normalizeRenderedResult({ renderedView, metadata, options, }: RenderingResult): NormalizedRenderingResult;
 export declare function reduceSourceAssetReferences(assets: AssetReference[]): RenderedAssetReference[];
 export declare function normalizeRenderOptions(runtimeEnvironment: RuntimeEnvironment, overrideRenderOptions?: RenderOptions, baseRenderOptions?: RenderOptions): Required<RenderOptions>;
-export declare function generatePageContext({ requestPath: url }: ViewRequest, { id, contentTemplate, properties }: LwrRoute | LwrErrorRoute): JsonCompatible<ViewPageContext>;
+export declare function generatePageContext({ requestPath: url }: ViewRequest, { id, contentTemplate, properties }: LwrRoute | LwrErrorRoute, runtimeParams: RuntimeParams): JsonCompatible<ViewPageContext>;
 export declare function isViewResponse(response: RouteHandlerViewResponse): response is ViewResponse;
 export declare function toJsonFormat(viewRequest: ViewRequest, viewDefinition: LinkedViewDefinition, route: LwrRoute | LwrErrorRoute, runtimeEnvironment: RuntimeEnvironment, runtimeParams: RuntimeParams, moduleRegistry: ModuleRegistry): Promise<ViewResponse>;
 export declare function getModuleResource(moduleId: Pick<ModuleId, 'specifier' | 'version'>, runtimeEnvironment: RuntimeEnvironment, moduleResourceMeta: ViewModuleResourceContext, defRegistry: ModuleRegistry | ModuleBundler, runtimeParams: RuntimeParams): Promise<ResourceDefinition>;

package/build/es/utils.js

@@ -58,6 +58,7 @@ export function normalizeRenderedResult({ renderedView, metadata, options, }) {
         metadata: {
             customElements: metadata ? metadata.customElements : [],
             assetReferences: metadata ? metadata.assetReferences : [],
+            serverData: metadata ? metadata.serverData : {},
         },
         options: {
             skipMetadataCollection: options ? options.skipMetadataCollection : false,
@@ -85,15 +86,17 @@ export function normalizeRenderOptions(runtimeEnvironment, overrideRenderOptions
     };
 }
 function getTitleFromFilePath(filePath) {
-    return filePath ? basename(filePath, extname(filePath)) : DEFAULT_TITLE;
+    return filePath && typeof filePath === 'string' ? basename(filePath, extname(filePath)) : DEFAULT_TITLE;
 }
-export function generatePageContext({ requestPath: url }, { id, contentTemplate, properties }) {
+export function generatePageContext({ requestPath: url }, { id, contentTemplate, properties }, runtimeParams) {
     // title is set to the first defined value of the following:
     //      - properties.title from the route (or viewParams.title from the route handler)
     //      - filename from route.contentTemplate
     //      - DEFAULT_TITLE
     const title = properties?.title || getTitleFromFilePath(contentTemplate);
-    return { id, title, url };
+    const locale = runtimeParams.locale;
+    const basePath = runtimeParams.basePath;
+    return { basePath, id, locale, title, url };
 }
 // type guard for ViewDef responses
 export function isViewResponse(response) {

package/build/es/view-handler.d.ts

@@ -10,7 +10,7 @@ export declare class LwrViewHandler implements ViewHandler {
     viewRegistry: ViewRegistry;
     moduleRegistry: ModuleRegistry;
     constructor(context: ViewHandlerContext, globalConfig: NormalizedLwrGlobalConfig);
-    getViewContent(viewRequest: ViewRequest, route: LwrRoute | LwrErrorRoute, runtimeEnvironment: RuntimeEnvironment, runtimeParams?: RuntimeParams): Promise<ViewResponse>;
+    getViewContent(viewRequest: ViewRequest, route: LwrRoute | LwrErrorRoute, runtimeEnvironment: RuntimeEnvironment, runtimeParams: RuntimeParams): Promise<ViewResponse>;
     getViewJson(viewRequest: ViewRequest, route: LwrRoute | LwrErrorRoute, runtimeEnvironment: RuntimeEnvironment, runtimeParams?: RuntimeParams): Promise<ViewResponse>;
     getViewConfiguration(viewRequest: ViewRequest, route: LwrRoute | LwrErrorRoute, runtimeEnvironment: RuntimeEnvironment, runtimeParams?: RuntimeParams): Promise<ViewResponse | undefined>;
     private getDefaultRouteViewDefinition;

package/build/es/view-handler.js

@@ -16,7 +16,7 @@ export class LwrViewHandler {
     // config
     route, 
     // context
-    runtimeEnvironment, runtimeParams = {}) {
+    runtimeEnvironment, runtimeParams) {
         if (route.routeHandler) {
             const response = await this.getRouteHandlerResponse(viewRequest, route, runtimeEnvironment, runtimeParams);
             if (isViewResponse(response)) {
@@ -24,9 +24,10 @@ export class LwrViewHandler {
                 return response;
             }
             // Process ViewDefinitionResponse
-            const { view, viewParams, renderOptions } = normalizeViewProperties(viewRequest, response, route, this.globalConfig);
+            const { view, viewParams, renderOptions } = normalizeViewProperties(viewRequest, response, route, this.globalConfig, runtimeParams);
             const viewDefinition = await this.viewRegistry.getViewDefinition(view, viewParams, runtimeEnvironment, {
                 ...runtimeParams,
+                url: viewRequest.url,
                 params: viewRequest.params,
                 query: viewRequest.query,
             }, renderOptions);
@@ -63,7 +64,7 @@ export class LwrViewHandler {
                 // Return custom view response payload as-is
                 return response;
             }
-            const { view, viewParams, renderOptions } = normalizeViewProperties(viewRequest, response, route, this.globalConfig);
+            const { view, viewParams, renderOptions } = normalizeViewProperties(viewRequest, response, route, this.globalConfig, runtimeParams);
             const viewDefinition = await this.viewRegistry.getViewDefinition(view, viewParams, runtimeEnvironment, runtimeParams, renderOptions);
             return {
                 ...response,
@@ -92,7 +93,7 @@ export class LwrViewHandler {
                 // Return custom view response payload as-is
                 return response;
             }
-            const { view, viewParams, renderOptions } = normalizeViewProperties(viewRequest, response, route, this.globalConfig);
+            const { view, viewParams, renderOptions } = normalizeViewProperties(viewRequest, response, route, this.globalConfig, runtimeParams);
             viewDefinition = await this.viewRegistry.getViewDefinition(view, viewParams, runtimeEnvironment, runtimeParams, renderOptions);
         }
         else {
@@ -122,7 +123,7 @@ export class LwrViewHandler {
     // context
     runtimeEnvironment, runtimeParams = {}) {
         const { id, bootstrap, rootComponent, contentTemplate, layoutTemplate, properties } = route;
-        const page = generatePageContext(viewRequest, route);
+        const page = generatePageContext(viewRequest, route, runtimeParams);
         const viewDefinition = await this.viewRegistry.getViewDefinition({
             id,
             bootstrap,
@@ -131,6 +132,7 @@ export class LwrViewHandler {
             layoutTemplate,
         }, { page, ...properties }, runtimeEnvironment, {
             ...runtimeParams,
+            url: viewRequest.url,
             params: viewRequest.params,
             query: viewRequest.query,
         });
@@ -144,7 +146,8 @@ export class LwrViewHandler {
         if (!route.routeHandler) {
             throw new Error('Route handler is required for a CustomView');
         }
-        const [routeHandlerFn, routeHandlerOptions] = this.routeHandlers[route.routeHandler[0]];
+        const routeHandlerOptions = route.routeHandler[1];
+        const routeHandlerFn = this.routeHandlers[route.routeHandler[0]];
         if (!routeHandlerFn) {
             throw new Error(`Route handler does not exist for id: ${route.routeHandler}`);
         }
@@ -191,7 +194,7 @@ export class LwrViewHandler {
             viewParams,
             renderOptions,
         };
-        const { view: normalizedView, viewParams: normalizedViewParams, renderOptions: normalizedRenderOptions, } = normalizeViewProperties(viewRequest, viewResponse, route, this.globalConfig);
+        const { view: normalizedView, viewParams: normalizedViewParams, renderOptions: normalizedRenderOptions, } = normalizeViewProperties(viewRequest, viewResponse, route, this.globalConfig, runtimeParams);
         const viewDefinition = await this.viewRegistry.getViewDefinition(normalizedView, normalizedViewParams, runtimeEnvironment, runtimeParams, normalizedRenderOptions);
         return {
             body: viewDefinition.renderedView,
@@ -202,7 +205,7 @@ export class LwrViewHandler {
         };
     }
 }
-function normalizeViewProperties(viewRequest, response, route, config) {
+function normalizeViewProperties(viewRequest, response, route, config, runtimeParams) {
     const { view: { rootComponent, contentTemplate: cTemplate, layoutTemplate: lTemplate }, viewParams, renderOptions, } = response;
     const { rootDir, assets, contentDir, layoutsDir } = config;
     const paths = { rootDir, assets, contentDir, layoutsDir };
@@ -211,14 +214,18 @@ function normalizeViewProperties(viewRequest, response, route, config) {
         ...route,
         contentTemplate: cTemplate,
         properties: viewParams,
-    });
+    }, runtimeParams);
     const { id, bootstrap } = route;
     return {
         view: {
             id,
             bootstrap,
             ...(rootComponent && { rootComponent }),
-            ...(cTemplate && { contentTemplate: resolve(normalizeResourcePath(cTemplate, paths)) }),
+            ...(cTemplate && {
+                contentTemplate: typeof cTemplate === 'string'
+                    ? resolve(normalizeResourcePath(cTemplate, paths))
+                    : cTemplate,
+            }),
             ...(lTemplate && { layoutTemplate: resolve(normalizeResourcePath(lTemplate, paths)) }),
         },
         viewParams: { page, ...viewParams },

package/package.json

@@ -4,7 +4,7 @@
     "publishConfig": {
         "access": "public"
     },
-    "version": "0.11.0-alpha.1",
+    "version": "0.11.0-alpha.10",
     "homepage": "https://developer.salesforce.com/docs/platform/lwr/overview",
     "repository": {
         "type": "git",
@@ -30,17 +30,17 @@
         "build/**/*.d.ts"
     ],
     "dependencies": {
-        "@lwrjs/app-service": "0.11.0-alpha.1",
-        "@lwrjs/diagnostics": "0.11.0-alpha.1",
-        "@lwrjs/instrumentation": "0.11.0-alpha.1",
-        "@lwrjs/shared-utils": "0.11.0-alpha.1",
+        "@lwrjs/app-service": "0.11.0-alpha.10",
+        "@lwrjs/diagnostics": "0.11.0-alpha.10",
+        "@lwrjs/instrumentation": "0.11.0-alpha.10",
+        "@lwrjs/shared-utils": "0.11.0-alpha.10",
         "lru-cache": "^10.0.0"
     },
     "devDependencies": {
-        "@lwrjs/types": "0.11.0-alpha.1"
+        "@lwrjs/types": "0.11.0-alpha.10"
     },
     "engines": {
         "node": ">=16.0.0"
     },
-    "gitHead": "6a840d4694fac9f0be5c3a21707015379cbadad7"
+    "gitHead": "34b1e289e8de12531f5624b64512e870157195d4"
 }