feat: allow configuration of how route modules are loaded in the browser

[jacob-ebey]

Adds a new API for bundler plugin usage to take control over the loading of client modules:

// entry.client.tsx
import { startTransition, StrictMode } from "react";
import { hydrateRoot } from "react-dom/client";
import type { unstable_LoadRouteModuleFunction } from "react-router";
import { HydratedRouter } from "react-router/dom";

const loadRouteModule: unstable_LoadRouteModuleFunction = async (
  route,
  routeModulesCache
) => {
  if (route.id in routeModulesCache) {
    return routeModulesCache[route.id];
  }

  console.log("Running custom import logic for route module:", route.module);

  // Note: a proper implementation should handle an error here
  // We trigger a hard reload in RR's default implementation
  let routeModule = await import(route.module);

  routeModulesCache[route.id] = routeModule;
  return routeModule;
};

startTransition(() => {
  hydrateRoot(
    document,
    <StrictMode>
      <HydratedRouter unstable_loadRouteModule={loadRouteModule} />
    </StrictMode>
  );
});

[changeset-bot]

⚠️ No Changeset found

Latest commit: 235eba2

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

[brophdawg11]

Note - this new API would need to be added to the new import() calls for split route modules

[github-actions]

Alpha release created: 0.0.0-experimental-1d8f3ee

⚠️ Note: This release was created from the HEAD of this branch so it may contain commits that have landed in dev but have not been released yet depending on when this branch was created. You can run the following command to see the commits that may not have been released yet:

git log --pretty=oneline [email protected]

[brophdawg11]

@jacob-ebey Can you confirm this is correct?

[github-actions]

Alpha release created: 0.0.0-experimental-235eba2

⚠️ Note: This release was created from the HEAD of this branch so it may contain commits that have landed in dev but have not been released yet depending on when this branch was created. You can run the following command to see the commits that may not have been released yet:

git log --pretty=oneline [email protected]