@modern-js/app-tools 3.2.1 → 3.3.0

package/dist/types/builder/shared/lazyCompilation.d.ts

@@ -0,0 +1,43 @@
+import { type EagerRouteComponentFilesByEntry } from '@modern-js/utils';
+export { type EagerRouteComponentFilesByEntry, type RouteComponentFileCollection, collectRouteComponentFiles, normalizeModulePath, } from '@modern-js/utils';
+type ModuleLike = {
+    resource?: string;
+};
+type LazyCompilationTestFn = (m: ModuleLike) => boolean;
+/** Matches Rspack's `LazyCompilationOptions['test']`. */
+type LazyCompilationTest = RegExp | LazyCompilationTestFn | undefined;
+export type EagerRouteComponentInfo = {
+    files: Set<string>;
+    /** Specifiers that could not be resolved, keyed by entry name. */
+    unresolvedByEntry: Map<string, string[]>;
+};
+/**
+ * Aggregate the per-entry route component data (collected by the router plugin
+ * during route generation and threaded in as
+ * `BuilderOptions.eagerRouteComponentFilesByEntry`) into the flat shape
+ * {@link planSSRLazyCompilation} expects: one Set of all route files plus the
+ * unresolved specifiers keyed by entry.
+ */
+export declare function aggregateEagerRouteComponentFiles(byEntry: EagerRouteComponentFilesByEntry | undefined): EagerRouteComponentInfo;
+/**
+ * Build a `lazyCompilation.test` that forces route component modules to compile
+ * eagerly (so SSR first-screen chunk/CSS injection has the assets it needs at
+ * render time), while delegating all other modules to the user's `test`
+ * (defaulting to lazy when the user did not provide one).
+ */
+export declare function buildSSRLazyCompilationTest(eagerRouteFiles: Set<string>, userTest?: LazyCompilationTest): LazyCompilationTestFn;
+export type SSRLazyPlan = {
+    apply: false;
+    unresolvedByEntry?: Map<string, string[]>;
+} | {
+    apply: true;
+    lazyCompilation: Record<string, unknown>;
+};
+/**
+ * Decide whether to apply the route-eager lazy compilation for an SSR project.
+ * Checks unresolved route components FIRST: if any exist we cannot guarantee
+ * they are eager, so we skip the optimization (and surface them so the caller
+ * can warn) rather than silently leaving a route lazy. `current` is the
+ * existing `dev.lazyCompilation` value (lazy must be enabled for this to apply).
+ */
+export declare function planSSRLazyCompilation(current: unknown, info: EagerRouteComponentInfo): SSRLazyPlan;

package/dist/types/builder/shared/types.d.ts

@@ -1,6 +1,16 @@
+import type { EagerRouteComponentFilesByEntry } from '@modern-js/utils';
 import type { AppNormalizedConfig } from '../../types';
 import type { AppToolsContext } from '../../types/plugin';
 export type BuilderOptions = {
     normalizedConfig: AppNormalizedConfig;
     appContext: AppToolsContext;
+    /**
+     * Route component files collected from the FINAL file-system routes (after
+     * all `modifyFileSystemRoutes` consumers ran), keyed by entry name. Populated
+     * by the router plugin during route generation and threaded in here (read
+     * FRESH from the app context AFTER `generateEntryCode` runs) so the SSR
+     * builder plugin can force route component chunks eager under lazy
+     * compilation. Explicit param instead of a direct `_internalContext` read.
+     */
+    eagerRouteComponentFilesByEntry?: EagerRouteComponentFilesByEntry;
 };

package/dist/types/config/default.d.ts

@@ -1,3 +1,9 @@
 import type { AppUserConfig } from '../types';
 import type { AppToolsContext } from '../types/plugin';
 export declare function createDefaultConfig(appContext: AppToolsContext): AppUserConfig;
+/**
+ * Default-enable lazy compilation for pure CSR and stream SSR. Stream SSR keeps
+ * first-screen route assets correct via the route-eager lazyCompilation.test
+ * injected by the SSR builder plugin. String SSR, RSC and SSG stay disabled.
+ */
+export declare function isLazyCompilationSafeByDefault(userConfig: Pick<AppUserConfig, 'server' | 'output'>): boolean;

package/dist/types/types/plugin.d.ts

@@ -1,6 +1,7 @@
 import type { AppContext, AsyncHook, InternalContext, PluginHook, PluginHookTap, TransformFunction } from '@modern-js/plugin';
 import type { Hooks } from '@modern-js/plugin/cli';
 import type { Entrypoint, HtmlPartials, HtmlTemplates, NestedRouteForCli, PageRoute, RouteLegacy, ServerPlugin, ServerRoute } from '@modern-js/types';
+import type { EagerRouteComponentFilesByEntry } from '@modern-js/utils';
 import type { AppTools } from '.';
 import type { getHookRunners } from '../compat/hooks';
 import type { AppToolsNormalizedConfig, AppToolsUserConfig } from './config';
@@ -109,6 +110,19 @@ export interface AppToolsExtendContext {
      * @private
      */
     bffRuntimeFramework?: string;
+    /**
+     * Route component files collected from the FINAL file-system routes (after all
+     * `modifyFileSystemRoutes` consumers ran), keyed by entry name. Populated by
+     * the router plugin during route generation and consumed (currently by stream
+     * SSR lazy compilation) to force route component chunks eager.
+     *
+     * Published via the app context (`api.updateAppContext`) by the router plugin,
+     * then read fresh when assembling the builder options and threaded into
+     * `BuilderOptions.eagerRouteComponentFilesByEntry`; the SSR builder plugin
+     * reads it from those options (not from the context directly).
+     * @private
+     */
+    eagerRouteComponentFilesByEntry?: EagerRouteComponentFilesByEntry;
 }
 export type AppToolsContext = AppContext<AppTools> & AppToolsExtendContext;
 export type AppToolsHooks = Hooks<AppToolsUserConfig, AppToolsNormalizedConfig, {}, {}> & AppToolsExtendHooks;

package/package.json

@@ -15,7 +15,7 @@
     "modern",
     "modern.js"
   ],
-  "version": "3.2.1",
+  "version": "3.3.0",
   "types": "./dist/types/index.d.ts",
   "main": "./dist/cjs/index.js",
   "exports": {
@@ -80,32 +80,32 @@
     "modern-app": "./bin/modern.js"
   },
   "dependencies": {
-    "@babel/parser": "^7.29.3",
-    "@babel/traverse": "^7.29.0",
-    "@babel/types": "^7.29.0",
-    "@rsbuild/core": "2.0.0",
-    "@swc/core": "1.15.33",
+    "@babel/parser": "^7.29.7",
+    "@babel/traverse": "^7.29.7",
+    "@babel/types": "^7.29.7",
+    "@rsbuild/core": "2.0.10",
+    "@swc/core": "1.15.40",
     "@swc/helpers": "^0.5.17",
     "es-module-lexer": "^1.7.0",
-    "import-meta-resolve": "^4.2.0",
     "flatted": "^3.4.2",
+    "import-meta-resolve": "^4.2.0",
     "mlly": "^1.8.2",
     "ndepe": "^0.1.13",
     "pkg-types": "^1.3.1",
     "std-env": "^3.10.0",
-    "@modern-js/builder": "3.2.1",
-    "@modern-js/plugin": "3.2.1",
-    "@modern-js/i18n-utils": "3.2.1",
-    "@modern-js/plugin-data-loader": "3.2.1",
-    "@modern-js/prod-server": "3.2.1",
-    "@modern-js/server": "3.2.1",
-    "@modern-js/server-core": "3.2.1",
-    "@modern-js/server-utils": "3.2.1",
-    "@modern-js/types": "3.2.1",
-    "@modern-js/utils": "3.2.1"
+    "@modern-js/i18n-utils": "3.3.0",
+    "@modern-js/plugin": "3.3.0",
+    "@modern-js/builder": "3.3.0",
+    "@modern-js/plugin-data-loader": "3.3.0",
+    "@modern-js/prod-server": "3.3.0",
+    "@modern-js/server": "3.3.0",
+    "@modern-js/server-core": "3.3.0",
+    "@modern-js/server-utils": "3.3.0",
+    "@modern-js/types": "3.3.0",
+    "@modern-js/utils": "3.3.0"
   },
   "devDependencies": {
-    "@rslib/core": "0.21.5",
+    "@rslib/core": "0.22.0",
     "@types/babel__traverse": "7.28.0",
     "@types/node": "^20",
     "ts-node": "^10.9.2",