@lwrjs/view-registry 0.15.0-alpha.3 → 0.15.0-alpha.30

package/build/cjs/index.cjs

@@ -51,7 +51,12 @@ var LwrViewRegistry = class {
     this.globalData = context.globalData;
     this.appEmitter = context.appEmitter;
     const observer = context.appObserver;
-    this.viewDefinitions = new import_lru_cache.LRUCache({max: parseInt(process.env.VIEW_CACHE_SIZE || "500", 10)});
+    this.viewDefinitions = new import_lru_cache.LRUCache({
+      max: parseInt(process.env.VIEW_CACHE_SIZE ?? "500", 10),
+      dispose: (_value, key) => {
+        import_diagnostics.logger.verbose(`View evicted from cache ${key}`);
+      }
+    });
     observer.onViewSourceChange(({payload}) => this.onViewSourceChange(payload));
     observer.onModuleDefinitionChange(({payload}) => this.onModuleDefinitionChange(payload));
     observer.onAssetSourceChange(({payload}) => this.onAssetSourceChange(payload));
@@ -140,28 +145,20 @@ var LwrViewRegistry = class {
     const {contentTemplate, rootComponent} = viewId;
     const compiledViewCacheKey = (0, import_shared_utils.getCacheKeyFromJson)({contentTemplate, rootComponent});
     import_diagnostics.logger.debug(`[view-registry][getView] compiledViewCacheKey=${compiledViewCacheKey}`);
-    if (this.compiledViews.has(compiledViewCacheKey)) {
+    const route = this.globalConfig.routes.find((r) => r.id === viewId.id);
+    const skipCaching = route?.cache?.ttl === 0;
+    if (!skipCaching && this.compiledViews.has(compiledViewCacheKey)) {
       return this.compiledViews.get(compiledViewCacheKey);
     }
     const compiledView = await this.delegateGetView(viewId);
-    this.compiledViews.set(compiledViewCacheKey, compiledView);
+    if (!skipCaching) {
+      this.compiledViews.set(compiledViewCacheKey, compiledView);
+    }
     return compiledView;
   }
   hasViewDefinition(view, viewParams, runtimeEnvironment, runtimeParams, renderOptions) {
-    const {id, bootstrap, rootComponent, contentTemplate, layoutTemplate} = view;
     const {freezeAssets, viewParamCacheKey} = (0, import_utils.normalizeRenderOptions)(this.runtimeEnvironment, renderOptions);
-    const viewDefId = (0, import_shared_utils.getCacheKeyFromJson)({
-      id,
-      bootstrap,
-      rootComponent,
-      contentTemplate,
-      layoutTemplate,
-      freezeAssets,
-      locale: runtimeParams?.locale,
-      basePath: runtimeParams?.basePath,
-      debug: runtimeEnvironment.debug,
-      nonceEnabled: (0, import_shared_utils.getFeatureFlags)().ENABLE_NONCE
-    });
+    const viewDefId = (0, import_utils.getViewDefCacheKey)(view, runtimeEnvironment, freezeAssets, runtimeParams);
     import_diagnostics.logger.debug(`[view-registry][hasViewDefinition] viewDefId=${viewDefId}`);
     const viewParamKey = viewParamCacheKey ? (0, import_shared_utils.getCacheKeyFromJson)(viewParamCacheKey) : (0, import_shared_utils.getCacheKeyFromJson)(viewParams);
     import_diagnostics.logger.debug(`[view-registry][hasViewDefinition] viewParamKey=${viewParamKey}`);
@@ -173,22 +170,16 @@ var LwrViewRegistry = class {
     }
     return false;
   }
-  async getViewDefinition(view, viewParams, runtimeEnvironment, runtimeParams, renderOptions) {
+  async getViewDefinition(view, viewParams, runtimeEnvironment, runtimeParams = {requestCache: {}}, renderOptions) {
+    runtimeParams.requestCache = runtimeParams.requestCache ?? {};
     try {
       const {freezeAssets, viewParamCacheKey} = (0, import_utils.normalizeRenderOptions)(this.runtimeEnvironment, renderOptions);
-      const viewDefCacheKey = (0, import_shared_utils.getCacheKeyFromJson)({
-        ...view,
-        freezeAssets,
-        locale: runtimeParams?.locale,
-        basePath: runtimeParams?.basePath,
-        debug: runtimeEnvironment.debug,
-        nonceEnabled: (0, import_shared_utils.getFeatureFlags)().ENABLE_NONCE
-      });
+      const viewDefCacheKey = (0, import_utils.getViewDefCacheKey)(view, runtimeEnvironment, freezeAssets, runtimeParams);
       import_diagnostics.logger.debug(`[view-registry][getViewDefinition] viewDefCacheKey=${viewDefCacheKey}`);
       const viewParamKey = viewParamCacheKey ? (0, import_shared_utils.getCacheKeyFromJson)(viewParamCacheKey) : (0, import_shared_utils.getCacheKeyFromJson)(viewParams);
       import_diagnostics.logger.debug(`[view-registry][getViewDefinition] viewParamKey=${viewParamKey}`);
-      if (this.viewDefinitions.has(viewDefCacheKey)) {
-        const viewDefinition2 = this.viewDefinitions.get(viewDefCacheKey);
+      if (this.viewDefinitions.has(viewDefCacheKey) || runtimeParams.requestCache[viewDefCacheKey]) {
+        const viewDefinition2 = this.viewDefinitions.get(viewDefCacheKey) || runtimeParams.requestCache[viewDefCacheKey];
         if (viewDefinition2 && viewDefinition2.paramKey === viewParamKey && viewDefinition2.viewDefinition.immutable) {
           return viewDefinition2.viewDefinition;
         }
@@ -202,18 +193,19 @@ var LwrViewRegistry = class {
           view: view.id,
           ssr: view.bootstrap?.ssr === true
         }
-      }, () => this.renderView(view, updatableViewParams, runtimeEnvironment, runtimeParams, renderOptions)));
+      }, () => this.renderView(view, updatableViewParams, runtimeEnvironment, runtimeParams, pendingViewDefCacheKey, renderOptions)));
       viewDefinition.nonce = (0, import_utils.getViewNonce)(updatableViewParams);
       const route = this.globalConfig.routes.find((r) => r.id === view.id);
       const maxViewCacheTtl = (0, import_shared_utils.getFeatureFlags)().MAX_VIEW_CACHE_TTL;
       const maxTtl = maxViewCacheTtl && parseInt(maxViewCacheTtl, 10);
       const leastTtl = (0, import_shared_utils.shortestTtl)(viewDefinition.cache?.ttl, route?.cache?.ttl, maxTtl);
       const ttl = leastTtl !== void 0 ? leastTtl === 0 ? 10 : leastTtl * 1e3 : void 0;
-      this.viewDefinitions.set(viewDefCacheKey, {
-        view,
-        viewDefinition,
-        paramKey: viewParamKey
-      }, {ttl});
+      const viewDefCacheEntry = {view, viewDefinition, paramKey: viewParamKey};
+      if (view.bootstrap?.includeCookiesForSSR) {
+        runtimeParams.requestCache[viewDefCacheKey] = viewDefCacheEntry;
+      } else {
+        this.viewDefinitions.set(viewDefCacheKey, viewDefCacheEntry, {ttl});
+      }
       return viewDefinition;
     } catch (err) {
       if (err instanceof import_diagnostics.DiagnosticsError) {
@@ -225,10 +217,10 @@ var LwrViewRegistry = class {
       throw (0, import_diagnostics.createSingleDiagnosticError)({description: import_diagnostics.descriptions.SERVER.UNEXPECTED_ERROR(message)}, import_diagnostics.LwrServerError);
     }
   }
-  async renderView(view, viewParams, runtimeEnvironment, runtimeParams = {}, renderOptions) {
+  async renderView(view, viewParams, runtimeEnvironment, runtimeParams, viewCacheKey, renderOptions) {
     const {id, contentTemplate, rootComponent, layoutTemplate} = view;
     const lwrResourcesId = `__LWR_RESOURCES__${Date.now()}`;
-    const renderedContent = await this.render({id, contentTemplate, rootComponent}, {...viewParams, lwr_resources: lwrResourcesId}, runtimeParams, runtimeEnvironment, renderOptions);
+    const renderedContent = await this.render({id, contentTemplate, rootComponent}, {...viewParams, lwr_resources: lwrResourcesId}, runtimeParams, runtimeEnvironment);
     let normalizedRenderOptions = (0, import_utils.normalizeRenderOptions)(this.runtimeEnvironment, renderedContent.options, renderOptions);
     const layout = layoutTemplate || renderedContent.compiledView.layoutTemplate;
     if (!layout) {
@@ -238,7 +230,8 @@ var LwrViewRegistry = class {
         runtimeEnvironment,
         runtimeParams,
         renderOptions: normalizedRenderOptions,
-        contentIds: {lwrResourcesId}
+        contentIds: {lwrResourcesId},
+        viewCacheKey
       });
       return renderedViewDef2;
     }
@@ -274,7 +267,8 @@ var LwrViewRegistry = class {
           ...renderedLayout.metadata.serverDebug
         }
       },
-      cache: renderedContent.cache
+      cache: renderedContent.cache,
+      redirect: renderedContent.redirect
     }, {
       view: {...view, layoutTemplate: layoutTemplatePath},
       viewParams,
@@ -282,11 +276,12 @@ var LwrViewRegistry = class {
       runtimeParams,
       renderOptions: normalizedRenderOptions,
       contentIds: {lwrResourcesId},
-      importer: renderedContent.compiledView.filePath
+      importer: renderedContent.compiledView.filePath,
+      viewCacheKey
     });
     return renderedViewDef;
   }
-  async render(viewId, viewParams, runtimeParams, runtimeEnvironment, renderOptions) {
+  async render(viewId, viewParams, runtimeParams, runtimeEnvironment) {
     const globalContext = this.globalData;
     const {id, rootComponent, contentTemplate} = viewId;
     const compiledView = await this.getView({id, contentTemplate, rootComponent});
@@ -310,7 +305,8 @@ var LwrViewRegistry = class {
       runtimeParams,
       renderOptions,
       contentIds,
-      importer
+      importer,
+      viewCacheKey
     } = viewContext;
     const {skipMetadataCollection, freezeAssets} = renderOptions;
     const {lwrResourcesId} = contentIds;
@@ -321,19 +317,37 @@ var LwrViewRegistry = class {
       metadata: renderedViewMetadata,
       compiledView: {immutable = true}
     } = renderedView;
-    const linkedMetadata = skipMetadataCollection ? renderedViewMetadata : await (0, import_shared_utils.extractMetadataFromHtml)(renderedViewContent, renderedViewMetadata, this.globalConfig);
+    const {linkedMetadata, stringBuilder} = await (0, import_instrumentation.getTracer)().trace({
+      name: import_instrumentation.ViewSpan.ParseView,
+      attributes: {
+        view: view.id,
+        ssr: view.bootstrap?.ssr === true
+      }
+    }, async () => {
+      const linkedMetadata2 = skipMetadataCollection ? renderedViewMetadata : await (0, import_shared_utils.extractMetadataFromHtml)(renderedViewContent, renderedViewMetadata, this.globalConfig);
+      const stringBuilder2 = (0, import_shared_utils.createStringBuilder)(renderedViewContent);
+      return {linkedMetadata: linkedMetadata2, stringBuilder: stringBuilder2};
+    });
     const mergedViewContext = {
       ...viewContext,
       config: this.globalConfig,
       runtimeEnvironment,
       importer: importer || renderedView.compiledView.filePath
     };
-    const stringBuilder = (0, import_shared_utils.createStringBuilder)(renderedViewContent);
     let pageTtl = renderedView.cache.ttl;
+    let pageRedirect = renderedView.redirect;
     for (const viewTransformer of this.viewTransformers) {
-      const linkResults = await viewTransformer.link?.(stringBuilder, mergedViewContext, linkedMetadata);
+      const linkResults = await (0, import_instrumentation.getTracer)().trace({
+        name: import_instrumentation.ViewSpan.Transform,
+        attributes: {
+          name: viewTransformer.name
+        }
+      }, () => viewTransformer.link?.(stringBuilder, mergedViewContext, linkedMetadata));
       const ttl = linkResults && linkResults.cache?.ttl;
       pageTtl = (0, import_shared_utils.shortestTtl)(ttl || void 0, pageTtl);
+      if (!pageRedirect) {
+        pageRedirect = linkResults ? linkResults.redirect : void 0;
+      }
     }
     const linkedAssetContent = stringBuilder.toString();
     if (linkedAssetContent.includes(lwrResourcesId)) {
@@ -345,7 +359,9 @@ var LwrViewRegistry = class {
         resourceRegistry,
         runtimeEnvironment,
         runtimeParams,
-        bundleConfig: this.globalConfig.bundleConfig
+        bundleConfig: this.globalConfig.bundleConfig,
+        unsafeEnableViewLinkCaching: this.globalConfig.unsafeEnableViewLinkCaching,
+        viewLinkCacheKey: viewCacheKey
       });
       return {
         renderedView: linkedView,
@@ -354,7 +370,8 @@ var LwrViewRegistry = class {
           assetReferences: (0, import_utils.reduceSourceAssetReferences)(linkedMetadata.assetReferences),
           ...viewRecord
         },
-        cache: {ttl: pageTtl}
+        cache: {ttl: pageTtl},
+        redirect: pageRedirect
       };
     }
     return {
@@ -364,7 +381,8 @@ var LwrViewRegistry = class {
         assetReferences: (0, import_utils.reduceSourceAssetReferences)(linkedMetadata.assetReferences),
         moduleResources: []
       },
-      cache: {ttl: pageTtl}
+      cache: {ttl: pageTtl},
+      redirect: pageRedirect
     };
   }
 };

package/build/cjs/linkers/legacy_view_bootstrap.cjs

@@ -32,6 +32,7 @@ var import_identity = __toModule(require("@lwrjs/app-service/identity"));
 var import_utils = __toModule(require("../utils.cjs"));
 var import_utils2 = __toModule(require("./utils.cjs"));
 var import_preload_utils = __toModule(require("./preload-utils.cjs"));
+var import_lru_cache = __toModule(require("lru-cache"));
 function includeIdFactory(bundleConfig) {
   return (moduleRef) => {
     if ((0, import_shared_utils.isExternalSpecifier)(moduleRef.specifier, bundleConfig)) {
@@ -40,6 +41,8 @@ function includeIdFactory(bundleConfig) {
     return true;
   };
 }
+var moduleGraphsCache = new import_lru_cache.LRUCache({max: 500});
+var isRunningLocalDev = (0, import_shared_utils.isLocalDev)();
 async function getHtmlResources(view, viewParams, resourceContext) {
   const {
     runtimeEnvironment,
@@ -47,14 +50,16 @@ async function getHtmlResources(view, viewParams, resourceContext) {
     moduleRegistry,
     moduleBundler,
     resourceRegistry,
-    viewMetadata
+    viewMetadata,
+    viewLinkCacheKey
   } = resourceContext;
   const {format, hmrEnabled, bundle, debug, minify} = runtimeEnvironment;
   const {customElements, serverData, serverDebug} = viewMetadata;
   const isAMD = format === "amd";
-  const {bundleConfig} = resourceContext;
+  const {bundleConfig, unsafeEnableViewLinkCaching} = resourceContext;
   const {external = {}, exclude = []} = bundleConfig;
   const groups = isAMD ? bundleConfig.groups || {} : {};
+  const enableModuleGraphsCache = unsafeEnableViewLinkCaching && !isRunningLocalDev && !process.env.NOCACHE;
   const getPreloadUri = function(rawSpecifier, uriMap) {
     const {specifier} = (0, import_shared_utils.explodeSpecifier)(rawSpecifier);
     if (Object.keys(external).some((e) => specifier === e))
@@ -139,7 +144,14 @@ async function getHtmlResources(view, viewParams, resourceContext) {
       (0, import_utils.addExternalScriptNonce)(errorShimDef, nonce);
       requiredResources.push(errorShimDef);
     }
-    const bootstrapModuleGraph = await (0, import_shared_utils.getModuleGraphs)(bootstrapSpecifier, {includeUris: true, includeLinkedDefinitions: true, depth}, moduleRegistry, defRegistry, runtimeEnvironment, runtimeParams, visitedCache);
+    let bootstrapModuleGraph;
+    const bootstrapModuleGraphCacheKey = (0, import_utils.getModuleGraphCacheKey)(bootstrapSpecifier, viewLinkCacheKey);
+    if (enableModuleGraphsCache && moduleGraphsCache.has(bootstrapModuleGraphCacheKey)) {
+      bootstrapModuleGraph = moduleGraphsCache.get(bootstrapModuleGraphCacheKey);
+    } else {
+      bootstrapModuleGraph = await (0, import_shared_utils.getModuleGraphs)(bootstrapSpecifier, {includeUris: true, includeLinkedDefinitions: true, depth}, moduleRegistry, defRegistry, runtimeEnvironment, runtimeParams, visitedCache);
+      enableModuleGraphsCache && moduleGraphsCache.set(bootstrapModuleGraphCacheKey, bootstrapModuleGraph);
+    }
     bootstrapModuleRef = {
       specifier: bootstrapModuleGraph.graphs[0].specifier,
       flatGraph: bootstrapModuleGraph,
@@ -188,7 +200,16 @@ async function getHtmlResources(view, viewParams, resourceContext) {
     }
   }
   await Promise.all(flattenedElements.map(async ({tagName: element, props}) => {
-    const graph = await (0, import_shared_utils.getModuleGraphs)((0, import_shared_utils.kebabCaseToModuleSpecifier)(element), {includeUris: true, includeLinkedDefinitions: true, depth}, moduleRegistry, defRegistry, runtimeEnvironment, runtimeParams ? runtimeParams : {}, visitedCache);
+    const hydrateDirective = (0, import_shared_utils.getHydrateDirective)(props);
+    const isSsrOnly = isSSR && !hydrateDirective;
+    const moduleGraphCacheKey = (0, import_utils.getModuleGraphCacheKey)(element, viewLinkCacheKey);
+    let graph;
+    if (enableModuleGraphsCache && moduleGraphsCache.has(moduleGraphCacheKey)) {
+      graph = moduleGraphsCache.get(moduleGraphCacheKey);
+    } else {
+      graph = await (0, import_shared_utils.getModuleGraphs)((0, import_shared_utils.kebabCaseToModuleSpecifier)(element), {includeUris: true, includeLinkedDefinitions: true, depth}, moduleRegistry, defRegistry, runtimeEnvironment, {...runtimeParams, ssr: isSsrOnly}, visitedCache);
+      enableModuleGraphsCache && moduleGraphsCache.set(moduleGraphCacheKey, graph);
+    }
     customElementsRecords.push({elementName: element, flatGraph: graph});
     if (!isSSR || (0, import_shared_utils.getHydrateDirective)(props)) {
       const specifier = graph.graphs[0].specifier;
@@ -231,7 +252,8 @@ async function getHtmlResources(view, viewParams, resourceContext) {
       url: viewParams?.page?.url,
       configAsSrc: view.bootstrap?.configAsSrc || false,
       mixedMode: view.bootstrap?.mixedMode || false,
-      nonce: viewParams?.page?.nonce
+      nonce: viewParams?.page?.nonce,
+      ssr: view.bootstrap?.ssr || false
     }, {
       appId: appIdentity.appName,
       bootstrapModule: versionedSpecifier,

package/build/cjs/linkers/link-lwr-resources.cjs

@@ -32,16 +32,16 @@ var import_legacy_view_bootstrap = __toModule(require("./legacy_view_bootstrap.c
 async function linkLwrResources(source, view, viewParams, cxt) {
   const {lwrResourcesId, ...resourceContext} = cxt;
   const LEGACY_LOADER = !!resourceContext.runtimeEnvironment.featureFlags.LEGACY_LOADER;
-  const {partial, viewRecord} = await (0, import_instrumentation.getTracer)().trace({
+  return await (0, import_instrumentation.getTracer)().trace({
     name: import_instrumentation.ViewSpan.Generate,
     attributes: {
       legacyLoader: LEGACY_LOADER
     }
-  }, () => {
-    return LEGACY_LOADER ? (0, import_legacy_view_bootstrap.getHtmlResources)(view, viewParams, resourceContext) : (0, import_view_bootstrap.getHtmlResources)(view, viewParams, resourceContext);
+  }, async () => {
+    const {partial, viewRecord} = await (LEGACY_LOADER ? (0, import_legacy_view_bootstrap.getHtmlResources)(view, viewParams, resourceContext) : (0, import_view_bootstrap.getHtmlResources)(view, viewParams, resourceContext));
+    return {
+      renderedView: source.replace(lwrResourcesId, () => partial),
+      viewRecord
+    };
   });
-  return {
-    renderedView: source.replace(lwrResourcesId, partial),
-    viewRecord
-  };
 }

package/build/cjs/linkers/utils.cjs

@@ -63,7 +63,7 @@ function getViewBootstrapConfigurationResource(viewInfo, config, runtimeEnvironm
     })});`,
     `globalThis.LWR = {...globalThis.LWR, env: ${JSON.stringify(lwrEnv)}};`,
     `globalThis.process={...globalThis.process,env:{...globalThis.process?.env,...${JSON.stringify(nodeEnv)}}};`,
-    `globalThis.lwcRuntimeFlags = { ENABLE_MIXED_SHADOW_MODE: ${viewInfo.mixedMode} };`,
+    `globalThis.lwcRuntimeFlags = { ENABLE_MIXED_SHADOW_MODE: ${viewInfo.mixedMode}, ENABLE_WIRE_SYNC_EMIT: ${viewInfo.ssr} };`,
     debug && debugMessage && `console.error(${JSON.stringify(debugMessage)});`
   ].filter(Boolean).join("\n");
   if (viewInfo.configAsSrc) {

package/build/cjs/linkers/view_bootstrap.cjs

@@ -28,10 +28,14 @@ __export(exports, {
 });
 var import_diagnostics = __toModule(require("@lwrjs/diagnostics"));
 var import_shared_utils = __toModule(require("@lwrjs/shared-utils"));
+var import_lru_cache = __toModule(require("lru-cache"));
 var import_identity = __toModule(require("@lwrjs/app-service/identity"));
 var import_utils = __toModule(require("../utils.cjs"));
 var import_utils2 = __toModule(require("./utils.cjs"));
+var import_utils3 = __toModule(require("../utils.cjs"));
 var import_preload_utils = __toModule(require("./preload-utils.cjs"));
+var moduleGraphsCache = new import_lru_cache.LRUCache({max: 500});
+var isRunningLocalDev = (0, import_shared_utils.isLocalDev)();
 async function getHtmlResources(view, viewParams, resourceContext) {
   const {
     runtimeEnvironment,
@@ -39,16 +43,18 @@ async function getHtmlResources(view, viewParams, resourceContext) {
     moduleRegistry,
     moduleBundler,
     resourceRegistry,
-    viewMetadata
+    viewMetadata,
+    viewLinkCacheKey
   } = resourceContext;
   const {format, hmrEnabled, bundle, debug, minify} = runtimeEnvironment;
   const {customElements, serverData, serverDebug} = viewMetadata;
   const defRegistry = bundle ? moduleBundler : moduleRegistry;
   const isAMD = format === "amd";
   const depth = isAMD ? {static: import_shared_utils.GraphDepth.ALL, dynamic: 1} : {static: import_shared_utils.GraphDepth.NONE, dynamic: 1};
-  const {bundleConfig} = resourceContext;
+  const {bundleConfig, unsafeEnableViewLinkCaching} = resourceContext;
   const {external = {}, exclude = []} = bundleConfig;
   const groups = isAMD ? bundleConfig.groups || {} : {};
+  const enableModuleGraphsCache = unsafeEnableViewLinkCaching && !isRunningLocalDev && !process.env.NOCACHE;
   const getPreloadUri = function(rawSpecifier, uriMap) {
     const {specifier} = (0, import_shared_utils.explodeSpecifier)(rawSpecifier);
     if (Object.keys(external).some((e) => specifier === e))
@@ -119,7 +125,14 @@ async function getHtmlResources(view, viewParams, resourceContext) {
       (0, import_utils.addExternalScriptNonce)(errorShimDef, nonce);
       requiredResources.push(errorShimDef);
     }
-    const bootstrapModuleGraph = await (0, import_shared_utils.getModuleGraphs)(bootstrapSpecifier, {includeUris: true, includeLinkedDefinitions: true, depth}, moduleRegistry, defRegistry, runtimeEnvironment, runtimeParams, visitedCache);
+    let bootstrapModuleGraph;
+    const bootstrapModuleGraphCacheKey = (0, import_utils3.getModuleGraphCacheKey)(bootstrapSpecifier, viewLinkCacheKey);
+    if (enableModuleGraphsCache && moduleGraphsCache.has(bootstrapModuleGraphCacheKey)) {
+      bootstrapModuleGraph = moduleGraphsCache.get(bootstrapModuleGraphCacheKey);
+    } else {
+      bootstrapModuleGraph = await (0, import_shared_utils.getModuleGraphs)(bootstrapSpecifier, {includeUris: true, includeLinkedDefinitions: true, depth}, moduleRegistry, defRegistry, runtimeEnvironment, runtimeParams, visitedCache);
+      enableModuleGraphsCache && moduleGraphsCache.set(bootstrapModuleGraphCacheKey, bootstrapModuleGraph);
+    }
     bootstrapModuleRef = {
       specifier: bootstrapModuleGraph.graphs[0].specifier,
       flatGraph: bootstrapModuleGraph,
@@ -169,7 +182,16 @@ async function getHtmlResources(view, viewParams, resourceContext) {
     importMetadata = await (0, import_shared_utils.toImportMetadata)(bootstrapModuleGraph, {imports: {}, index: {}}, moduleRegistry, runtimeEnvironment, runtimeParams);
   }
   for (const {tagName: element, props} of flattenedElements) {
-    const graph = await (0, import_shared_utils.getModuleGraphs)((0, import_shared_utils.kebabCaseToModuleSpecifier)(element), {includeUris: true, includeLinkedDefinitions: true, depth}, moduleRegistry, defRegistry, runtimeEnvironment, runtimeParams ? runtimeParams : {}, visitedCache);
+    const hydrateDirective = (0, import_shared_utils.getHydrateDirective)(props);
+    const isSsrOnly = isSSR && !hydrateDirective;
+    const moduleGraphCacheKey = (0, import_utils3.getModuleGraphCacheKey)(element, viewLinkCacheKey);
+    let graph;
+    if (enableModuleGraphsCache && moduleGraphsCache.has(moduleGraphCacheKey)) {
+      graph = moduleGraphsCache.get(moduleGraphCacheKey);
+    } else {
+      graph = await (0, import_shared_utils.getModuleGraphs)((0, import_shared_utils.kebabCaseToModuleSpecifier)(element), {includeUris: true, includeLinkedDefinitions: true, depth}, moduleRegistry, defRegistry, runtimeEnvironment, {...runtimeParams, ssr: isSsrOnly}, visitedCache);
+      enableModuleGraphsCache && moduleGraphsCache.set(moduleGraphCacheKey, graph);
+    }
     customElementsRecords.push({elementName: element, flatGraph: graph});
     if (!isSSR || (0, import_shared_utils.getHydrateDirective)(props)) {
       const specifier = graph.graphs[0].specifier;
@@ -206,7 +228,8 @@ async function getHtmlResources(view, viewParams, resourceContext) {
       url: viewParams?.page?.url,
       configAsSrc: view.bootstrap?.configAsSrc || false,
       mixedMode: view.bootstrap?.mixedMode || false,
-      nonce: viewParams?.page?.nonce
+      nonce: viewParams?.page?.nonce,
+      ssr: view.bootstrap?.ssr || false
     }, {
       appId: appIdentity.appName,
       bootstrapModule: versionedSpecifier,

package/build/cjs/utils.cjs

@@ -27,11 +27,15 @@ __export(exports, {
   addExternalScriptNonce: () => addExternalScriptNonce,
   createJsonModule: () => createJsonModule,
   generateHtmlTag: () => generateHtmlTag,
+  generateLinkHeaders: () => generateLinkHeaders,
   generatePageContext: () => generatePageContext,
   generateViewNonce: () => generateViewNonce,
+  getModuleGraphCacheKey: () => getModuleGraphCacheKey,
   getModuleResource: () => getModuleResource,
   getModuleResourceByUri: () => getModuleResourceByUri,
+  getViewDefCacheKey: () => getViewDefCacheKey,
   getViewNonce: () => getViewNonce,
+  isViewDefinitionResponse: () => isViewDefinitionResponse,
   isViewResponse: () => isViewResponse,
   normalizeRenderOptions: () => normalizeRenderOptions,
   normalizeRenderedResult: () => normalizeRenderedResult,
@@ -108,7 +112,8 @@ function normalizeRenderedResult({
   renderedView,
   metadata,
   options,
-  cache
+  cache,
+  redirect
 }) {
   return {
     renderedView,
@@ -121,7 +126,8 @@ function normalizeRenderedResult({
     options: {
       skipMetadataCollection: options ? options.skipMetadataCollection : false
     },
-    cache: cache || {}
+    cache: cache || {},
+    redirect
   };
 }
 function reduceSourceAssetReferences(assets) {
@@ -149,11 +155,16 @@ function generatePageContext({requestPath: url}, {id, contentTemplate, propertie
   const title = properties?.title || getTitleFromFilePath(contentTemplate);
   const locale = runtimeParams.locale;
   const basePath = runtimeParams.basePath;
-  return {basePath, id, locale, title, url};
+  const assetBasePath = runtimeParams.assetBasePath;
+  const uiBasePath = runtimeParams.uiBasePath;
+  return {assetBasePath, basePath, id, locale, title, url, uiBasePath};
 }
 function isViewResponse(response) {
   return response.body !== void 0;
 }
+function isViewDefinitionResponse(response) {
+  return response.view !== void 0;
+}
 async function toJsonFormat(viewRequest, viewDefinition, route, runtimeEnvironment, runtimeParams, moduleRegistry) {
   const {viewRecord} = viewDefinition;
   const {bootstrap, id: appName} = route;
@@ -291,3 +302,41 @@ function addExternalScriptNonce(def, nonce) {
     def.nonce = nonce;
   }
 }
+function generateLinkHeaders(assets, patterns) {
+  const assetConfig = {};
+  for (let i = 0; i < patterns.length; i++) {
+    const pattern = patterns[i].match;
+    assets.forEach((asset) => {
+      const path = (asset.override?.uri || asset.url).split("?")[0];
+      if (typeof pattern === "string" && path.endsWith(pattern) || typeof pattern === "object" && pattern.some((match) => path.endsWith(match))) {
+        assetConfig[path] = patterns[i].attributes;
+      }
+    });
+  }
+  return Object.keys(assetConfig).reduce((linkHeader, path) => {
+    linkHeader = `${linkHeader ? linkHeader + ", " : ""}<${path}>`;
+    const properties = assetConfig[path];
+    for (const prop in properties) {
+      linkHeader += properties[prop] !== "" ? `; ${prop}=${properties[prop]}` : `; ${prop}`;
+    }
+    return linkHeader;
+  }, "");
+}
+function getViewDefCacheKey(view, runtimeEnvironment, freezeAssets, runtimeParams) {
+  const {id, bootstrap, rootComponent, contentTemplate, layoutTemplate} = view;
+  return (0, import_shared_utils.getCacheKeyFromJson)({
+    id,
+    bootstrap,
+    rootComponent,
+    contentTemplate,
+    layoutTemplate,
+    freezeAssets,
+    locale: runtimeParams?.locale,
+    basePath: runtimeParams?.basePath,
+    debug: runtimeEnvironment.debug,
+    nonceEnabled: (0, import_shared_utils.getFeatureFlags)().ENABLE_NONCE
+  });
+}
+function getModuleGraphCacheKey(specifier, viewLinkCacheKey) {
+  return specifier + viewLinkCacheKey;
+}

package/build/cjs/view-handler.cjs

@@ -46,9 +46,11 @@ var LwrViewHandler = class {
       }
       const {view, viewParams, renderOptions} = normalizeViewProperties(viewRequest, response, route, this.globalConfig, runtimeParams);
       const viewDefinition2 = await this.viewRegistry.getViewDefinition(view, viewParams, runtimeEnvironment, runtimeParams, renderOptions);
+      const link2 = !!route?.bootstrap?.preloadResources?.patterns?.length && (0, import_utils.generateLinkHeaders)(viewDefinition2.viewRecord.assetReferences || [], route?.bootstrap?.preloadResources?.patterns || []);
       return {
         ...response,
         body: viewDefinition2.renderedView,
+        ...!!link2 && {headers: {link: link2}},
         metadata: {
           viewDefinition: viewDefinition2
         },
@@ -56,12 +58,14 @@ var LwrViewHandler = class {
       };
     }
     const viewDefinition = await this.getDefaultRouteViewDefinition(viewRequest, route, runtimeEnvironment, runtimeParams);
+    const link = !!route?.bootstrap?.preloadResources?.patterns?.length && (0, import_utils.generateLinkHeaders)(viewDefinition.viewRecord.assetReferences || [], route.bootstrap?.preloadResources?.patterns || []);
     return {
       body: viewDefinition.renderedView,
       metadata: {
         viewDefinition
       },
-      cache: viewDefinition.cache
+      cache: viewDefinition.cache,
+      ...!!link && {headers: {link}}
     };
   }
   async getViewJson(viewRequest, route, runtimeEnvironment, runtimeParams = {}) {
@@ -153,6 +157,22 @@ var LwrViewHandler = class {
     if (response?.locale) {
       runtimeParams.locale = response.locale;
     }
+    const preloadResources = route?.bootstrap?.preloadResources?.patterns;
+    if (preloadResources && preloadResources.length) {
+      let viewDefintionMeta = response.metadata?.viewDefinition;
+      if (!viewDefintionMeta && (0, import_utils.isViewDefinitionResponse)(response)) {
+        viewDefintionMeta = (await viewApi.getViewResponse(response.view, response.viewParams, response.renderOptions)).metadata?.viewDefinition;
+      }
+      if (viewDefintionMeta) {
+        const link = (0, import_utils.generateLinkHeaders)(viewDefintionMeta?.viewRecord.assetReferences || [], preloadResources);
+        if (link) {
+          response.headers = {
+            ...response.headers,
+            link
+          };
+        }
+      }
+    }
     return response;
   }
   getBoundApi(viewRequest, route, runtimeEnvironment, runtimeParams) {