rasengan 1.2.0-beta.0 → 1.2.0-beta.5

package/CHANGELOG.md

@@ -1,12 +1,23 @@
 ## Unreleased
 
-## 1.2.0-beta.0 (2025-09-18)
+## 1.2.0-beta.5 (2026-01-03)
+
+## 1.2.0-beta.4 (2026-01-02)
+
+## 1.2.0-beta.3 (2026-01-02)
 
-## 1.1.5 (2025-08-30)
+## 1.2.0-beta.2 (2026-01-02)
 
-## 1.1.4 (2025-08-30)
+## 1.2.0-beta.1 (2025-09-19)
+
+- fix(rasengan): falling back to route.data if route.loaderData is undefined [3cc418](https://github.com/rasengan-dev/rasenganjs/3cc4186e34a5d115e6ef69e8c8b36538aa8562ed)
+
+## 1.2.0-beta.0 (2025-09-18)
 
-## 1.1.4 (2025-08-30)
+- feat: adding experiment lazyLoadPage function [017b26](https://github.com/rasengan-dev/rasenganjs/017b26a480815ff480a0f99368fa8fc0c094d5ab)
+- feat(rasengan): synchronizing metadata on client navigation [75374b](https://github.com/rasengan-dev/rasenganjs/75374b958180ad1f46bb00f91235e22bfa11a321)
+- feat(rasengan): adding support for lazy route loading into file-base routing [1161bc](https://github.com/rasengan-dev/rasenganjs/1161bc409679630e293a376536b2e749cbeeaab8)
+- feat: start adding support for lazy loading pages into file-based routing [cbcfdb](https://github.com/rasengan-dev/rasenganjs/cbcfdb6a1f4992b6cfacc280c68dc0d8fe42059c)
 
 ## 1.1.3 (2025-08-30)
 

package/lib/esm/core/config/utils/define-config.js

@@ -21,7 +21,10 @@ export const defineConfig = async (loadedConfig) => {
         else {
             config = loadedConfig;
         }
-        const { ssr, server, vite, redirects } = config;
+        const { ssr, prerender, sageMode, server, vite, redirects } = config;
+        const defaultSageModeConfig = {
+            reactCompiler: sageMode?.reactCompiler ?? false,
+        };
         // Define default values for vite config coming from loadedConfig.vite
         const defaultViteConfig = {
             ...vite,
@@ -42,7 +45,9 @@ export const defineConfig = async (loadedConfig) => {
         try {
             const config = {
                 ssr: ssr ?? true,
+                prerender: prerender ?? false,
                 server: defaultServerConfig,
+                sageMode: defaultSageModeConfig,
                 vite: {
                     ...defaultViteConfig,
                     resolve: {
@@ -62,6 +67,10 @@ export const defineConfig = async (loadedConfig) => {
         catch (error) {
             return {
                 ssr: true,
+                prerender: false,
+                sageMode: {
+                    reactCompiler: false,
+                },
                 vite: {
                     appType: 'custom',
                     resolve: {

package/lib/esm/core/config/utils/path.js

@@ -12,5 +12,5 @@ export const resolvePath = (pathValue) => {
     if (isWindows) {
         return `file:///${path.normalize(pathValue)}`;
     }
-    return path.normalize(pathValue);
+    return path.resolve(path.normalize(pathValue));
 };

package/lib/esm/core/config/vite/defaults.js

@@ -29,15 +29,21 @@ export const createDefaultViteConfig = (rootPath, __dirname, mode, config) => {
             chunkSizeWarningLimit: 2000,
         },
         environments: {
+            /**
+             * Client Environment
+             */
             client: {
                 build: {
                     manifest: true,
-                    outDir: config.ssr ? 'dist/client' : 'dist',
+                    outDir: config.ssr || config.prerender ? 'dist/client' : 'dist',
                     rollupOptions: {
                         input: './src/index',
                     },
                 },
             },
+            /**
+             * SSR Environment
+             */
             ssr: {
                 build: {
                     outDir: 'dist/server',
@@ -52,6 +58,23 @@ export const createDefaultViteConfig = (rootPath, __dirname, mode, config) => {
                     ssrEmitAssets: false,
                 },
             },
+            /**
+             * SSG Environment
+             */
+            ssg: {
+                build: {
+                    outDir: 'dist/prerender',
+                    rollupOptions: {
+                        input: {
+                            'entry.server': join(__dirname, './lib/esm/entries/server/entry.server.js'),
+                            'app.router': './src/app/app.router',
+                            main: './src/main',
+                            template: './src/template',
+                        },
+                    },
+                    ssrEmitAssets: false,
+                },
+            },
         },
         // Resolve config
         resolve: {
@@ -66,7 +89,12 @@ export const createDefaultViteConfig = (rootPath, __dirname, mode, config) => {
         builder: {
             buildApp: async (builder) => {
                 if (config.ssr) {
-                    await builder.build(builder.environments.ssr);
+                    if (!config.prerender) {
+                        await builder.build(builder.environments.ssr);
+                    }
+                }
+                if (config.prerender) {
+                    await builder.build(builder.environments.ssg);
                 }
                 await builder.build(builder.environments.client);
             },

package/lib/esm/core/plugins/index.js

@@ -5,6 +5,7 @@ import { resolveBuildOptions } from '../../server.js';
 import { renderIndexHTML } from '../../server/build/rendering.js';
 import { createVirtualModule } from '../../server/virtual/index.js';
 import { pathToFileURL } from 'url';
+import { preRenderApp } from '../../server/node/index.js';
 function loadRasenganGlobal() {
     return {
         name: 'vite-plugin-rasengan-config',
@@ -84,7 +85,6 @@ function flatRoutesPlugin() {
                 '/src/app/_routes/**/layout.{js,ts,jsx,tsx}',
                 '/src/app/_routes/**/*.page.{md,mdx,js,ts,jsx,tsx}',
               ],
-              // { eager: true }
             );
           });
 
@@ -179,32 +179,65 @@ export function rasengan({ adapter = { name: Adapters.DEFAULT, prepare: async ()
             const module = await this.load({ id: modulePath });
             // SPA mode only
             if (!config.ssr) {
-                // Generate the template.js file into the dist/assets
-                fs.writeFileSync(path.posix.join(process.cwd(), buildOptions.buildDirectory, buildOptions.assetPathDirectory, 'template.js'), module.code, 'utf-8');
+                if (!config.prerender) {
+                    // Generate the template.js file into the dist/assets
+                    fs.writeFileSync(path.posix.join(process.cwd(), buildOptions.buildDirectory, buildOptions.assetPathDirectory, 'template.js'), module.code, 'utf-8');
+                }
             }
         },
         async closeBundle() {
             // We check here if the environment is client has been built because it's the
             // last environment to be built in the Vite build process
             if (this.environment.name === 'client') {
-                // Check if SPA mode is enabled
-                if (!config.ssr) {
+                // Generate a config.json file into the dist/client/assets or dist/assets
+                const minimizedConfig = {
+                    buildOptions,
+                    ssr: config.ssr,
+                    prerender: !!config.prerender,
+                    redirects: await config.redirects(),
+                };
+                fs.writeFileSync(path.posix.join(process.cwd(), buildOptions.buildDirectory, config.ssr || config.prerender
+                    ? buildOptions.clientPathDirectory
+                    : '', buildOptions.assetPathDirectory, 'config.json'), JSON.stringify(minimizedConfig), 'utf-8');
+                // Enable the generation of spa-fallback.html during pre-rendering
+                // Only if every pages are not generated
+                // @default to false - we assume that all pages are not generated
+                let enableIndexFallback = false;
+                // Handling the prerendering
+                if (config.prerender) {
+                    let routes = [];
+                    const buildOptions = resolveBuildOptions({
+                        serverPathDirectory: 'prerender',
+                    });
+                    if (typeof config.prerender === 'object') {
+                        routes = config.prerender.routes || [];
+                    }
+                    const outDir = `${process.cwd()}/static`;
+                    const { isIndexPrerendered } = await preRenderApp({
+                        build: buildOptions,
+                        outDir,
+                        routes,
+                    });
+                    enableIndexFallback = isIndexPrerendered;
+                }
+                // Check if SPA or SSG mode is enabled
+                if (!config.ssr || config.prerender) {
                     // Load the template.js file
-                    const templatePath = path.posix.join(process.cwd(), buildOptions.buildDirectory, buildOptions.assetPathDirectory, 'template.js');
+                    let templatePath = '';
+                    if (config.prerender) {
+                        templatePath = path.posix.join(process.cwd(), buildOptions.buildDirectory, 'prerender', 'template.js');
+                    }
+                    else {
+                        templatePath = path.posix.join(process.cwd(), buildOptions.buildDirectory, buildOptions.assetPathDirectory, 'template.js');
+                    }
                     const Template = (await import(templatePath)).default;
                     // Render the index.html file
                     await renderIndexHTML(Template, {
                         rootPath: process.cwd(),
                         config,
+                        enableIndexFallback,
                     });
                 }
-                // Generate a config.json file into the dist/client/assets or dist/assets
-                const minimizedConfig = {
-                    buildOptions,
-                    ssr: config.ssr,
-                    redirects: await config.redirects(),
-                };
-                fs.writeFileSync(path.posix.join(process.cwd(), buildOptions.buildDirectory, config.ssr ? buildOptions.clientPathDirectory : '', buildOptions.assetPathDirectory, 'config.json'), JSON.stringify(minimizedConfig), 'utf-8');
                 // Prepare the app for deployment
                 await prepareToDeploy(adapter);
             }

package/lib/esm/entries/server/entry.server.js

@@ -2,7 +2,7 @@ import { jsx as _jsx } from "react/jsx-runtime";
 import { loadModuleSSR } from '../../core/config/utils/load-modules.js';
 import { TemplateLayout } from './index.js';
 import { join, posix } from 'path/posix';
-import { renderToStream } from '../../server/node/rendering.js';
+import { renderToStream, renderToString } from '../../server/node/rendering.js';
 /**
  * Render the app to a stream
  * @param StaticRouterComponent
@@ -10,7 +10,7 @@ import { renderToStream } from '../../server/node/rendering.js';
  * @param res
  * @returns
  */
-export const render = async (StaticRouterComponent, res, options) => {
+export const render = async (StaticRouterComponent, res, options, stream = true) => {
     const { metadata, assets, buildOptions } = options;
     // Root path
     const rootPath = process.cwd();
@@ -27,5 +27,11 @@ export const render = async (StaticRouterComponent, res, options) => {
         // Import Template
         Template = (await loadModuleSSR(`${rootPath}/src/template`)).default;
     }
-    await renderToStream(_jsx(TemplateLayout, { StaticRouterComponent: StaticRouterComponent, metadata: metadata, assets: assets, App: App, Template: Template }), res);
+    if (stream) {
+        await renderToStream(_jsx(TemplateLayout, { StaticRouterComponent: StaticRouterComponent, metadata: metadata, assets: assets, App: App, Template: Template }), res);
+    }
+    else {
+        const html = renderToString(_jsx(TemplateLayout, { StaticRouterComponent: StaticRouterComponent, metadata: metadata, assets: assets, App: App, Template: Template }));
+        return html;
+    }
 };

package/lib/esm/routing/index.js

@@ -1,5 +1,5 @@
 import { CustomLink, ScrollRestoration } from './components/index.js';
-export { defineRouter, defineRoutesGroup, flatRoutes } from './utils/index.js';
+export { defineRouter, defineRoutesGroup, defineStaticPaths, flatRoutes, } from './utils/index.js';
 export { RouterComponent } from './interfaces.js';
 export { Outlet, useLocation, useNavigate, useNavigation, useParams, useSearchParams, useFetcher, useMatch, useRoutes, useResolvedPath, matchRoutes, generatePath, matchPath, createRoutesFromChildren, Navigate, NavLink, } from 'react-router';
 export { CustomLink as Link, ScrollRestoration };

package/lib/esm/routing/providers/metadata.js

@@ -10,43 +10,44 @@ export default function MetadataProvider({ children, }) {
         if (typeof window === 'undefined')
             return;
         (async () => {
-            const loadersData = routes.map((route) => route.loaderData);
-            await handleApplyMetadata(loadersData);
+            const loadersData = routes.map((route) => route.loaderData ?? route.data // Normally the route.data is deprecated, we need to consider route.loaderData, but in some cases, route.loaderData is undefined and I don't know why, that's why we are using route.data instead
+            );
+            handleInjectMetadata(loadersData);
         })();
     }, [location]);
-    const handleApplyMetadata = async (loadersData) => {
+    /**
+     * This function is responsible to inject the correct metadata on client routing based on the current URL of the page
+     * @param loadersData The metadata coming from loaders functions
+     * @returns
+     */
+    const handleInjectMetadata = (loadersData) => {
         // We generate the metadata
-        const metadatas = generateMetadata(loadersData.map((item) => item.meta));
+        const metadatas = generateMetadata(loadersData.map((item) => (item.meta ? item.meta : {})));
         // We get the last metadata
         // This is the metadata of the page
-        const leafMetadata = loadersData.at(-1)?.meta;
-        handleInjectMetadata(metadatas, leafMetadata);
-    };
-    const handleInjectMetadata = (metaTags, leafMetadata) => {
-        // Check if we are on the browser
-        if (typeof window !== 'undefined') {
-            // Find all meta tags with data-rg attribute and remove them
-            const metaTagsToRemove = document.querySelectorAll('meta[data-rg="true"]');
-            metaTagsToRemove.forEach((metaTag) => {
-                metaTag.remove();
-            });
-            // Inject the meta tags
-            metaTags.forEach((metaTag) => {
-                // Convert React element to string
-                const metaTagString = ReactDOMServer.renderToStaticMarkup(metaTag);
-                document.head.insertAdjacentHTML('beforeend', metaTagString);
-            });
-            if (!leafMetadata)
-                return;
-            // Change the title of the page
-            document.title = leafMetadata.title;
-            // Change the description of the page
-            const metaDescription = document.createElement('meta');
-            metaDescription.setAttribute('name', 'description');
-            metaDescription.setAttribute('content', leafMetadata.description);
-            metaDescription.setAttribute('data-rg', 'true');
-            document.head.appendChild(metaDescription);
-        }
+        const leaf = loadersData.at(-1);
+        const leafMetadata = leaf ? leaf.meta : {};
+        // Find all meta tags with data-rg attribute and remove them
+        const metaTagsToRemove = document.querySelectorAll('meta[data-rg="true"]');
+        metaTagsToRemove.forEach((metaTag) => {
+            metaTag.remove();
+        });
+        // Inject the meta tags
+        metadatas.forEach((metaTag) => {
+            // Convert React element to string
+            const metaTagString = ReactDOMServer.renderToStaticMarkup(metaTag);
+            document.head.insertAdjacentHTML('beforeend', metaTagString);
+        });
+        if (!leafMetadata)
+            return;
+        // Change the title of the page
+        document.title = leafMetadata.title;
+        // Change the description of the page
+        const metaDescription = document.createElement('meta');
+        metaDescription.setAttribute('name', 'description');
+        metaDescription.setAttribute('content', leafMetadata.description);
+        metaDescription.setAttribute('data-rg', 'true');
+        document.head.appendChild(metaDescription);
     };
     return _jsx(_Fragment, { children: children });
 }

package/lib/esm/routing/utils/define-router.js

@@ -71,14 +71,27 @@ export const isMDXPage = (page) => {
     }
     return false;
 };
+/**
+ * Load thr MDXRenderer is the dedicated package is installed
+ * @returns
+ */
 const loadMDXRenderer = async () => {
     try {
-        // @ts-ignore
-        const { MDXRenderer } = await import('@rasenganjs/mdx');
-        return MDXRenderer;
+        // Dynamically import only if the package exists
+        const mod = await import('@rasenganjs/mdx');
+        return mod.MDXRenderer;
     }
-    catch (e) {
-        console.error(e);
-        throw e;
+    catch (error) {
+        // Handle the case when the package is not installed
+        if (error.code === 'MODULE_NOT_FOUND' ||
+            /Cannot find module '@rasenganjs\/mdx'/.test(error.message)) {
+            if (process.env.NODE_ENV === 'development') {
+                console.warn('[Rasengan.js] MDX package not found — skipping MDX rendering.');
+            }
+            return null;
+        }
+        // Other unexpected errors (e.g. runtime bug in the module)
+        console.error('[Rasengan.js] Unexpected error while loading MDX module:', error);
+        throw error;
     }
 };

package/lib/esm/routing/utils/define-static-paths.js

@@ -0,0 +1,10 @@
+/**
+ * Define static paths for a page
+ * @param items - List of params
+ * @returns
+ */
+export function defineStaticPaths(items) {
+    return {
+        paths: items.map((params) => ({ params })),
+    };
+}