rasengan 1.0.0-beta.9 → 1.1.0-beta.2

package/CHANGELOG.md

@@ -0,0 +1,44 @@
+## Unreleased
+
+## 1.1.0-beta.2 (2025-07-09)
+
+## 1.1.0-beta.1 (2025-07-09)
+
+## 1.1.0-beta.0 (2025-07-09)
+
+## 1.0.0 (2025-04-26)
+
+- fix: handling metadata on client when navigating between pages [5fbbaca](https://github.com/rasengan-dev/rasenganjs/5fbbaca5ce206d693b5a5d394827a3804838ba5c)
+- feat(rasengan): update metadata on client while navigating [1c373ff](https://github.com/rasengan-dev/rasenganjs/1c373ff3e7dacee52dde81f8bb0689856ffe0393)
+- fix: fix build issue in ssr mode [6dfde61](https://github.com/rasengan-dev/rasenganjs/6dfde618f4f0e43d801b67afc4f4235e98a3976c)
+- feat: generate output inside the ./dist folder in spa mode instead of ./dist/client [cf2b7b2](https://github.com/rasengan-dev/rasenganjs/cf2b7b29133ff4f3256c131fa895fcde4d590e93)
+- feat: handling proxy in spa mode [7616f67](https://github.com/rasengan-dev/rasenganjs/7616f670d8f7ae0a02d494b13bbe03efc25cc26e)
+- feat: generate template.js, config.json and index.html during build for spa [ed345f2](https://github.com/rasengan-dev/rasenganjs/ed345f2abda7c508a384a16409fc28799085476c)
+- feat: Handling client rendering for spa mode [980eefc](https://github.com/rasengan-dev/rasenganjs/980eefc65a17016544c94b323d69a92d24ac149d)
+- feat: adding handleSpaModeHandle to render blank html in dev server mode [fe6b79b](https://github.com/rasengan-dev/rasenganjs/fe6b79b370e8626ddc65a6f4142225fd71880a5a)
+- feat: adding option 'ssr' into defineConfig to enable spa mode [d2da64d](https://github.com/rasengan-dev/rasenganjs/d2da64d8a372f5ad71ff26196c37658e78e71cc7)
+- feat: merge static metadata and dynamic metadata [c979609](https://github.com/rasengan-dev/rasenganjs/c979609e5b45b45f9965a81c34fa73284dce3e09)
+- feat: Enabling keypress event capture by using readline built in nodejs package [72422fd](https://github.com/rasengan-dev/rasenganjs/72422fd8f5eee401f0ba0468a51d09097dc3ae8d)
+- feat: implement the mergeMetadata function to merge static and dynamic metadata together [29a88dd](https://github.com/rasengan-dev/rasenganjs/29a88ddc727f523d6fedb28b5166501fe48ee275)
+
+## 1.0.0-beta.62 (2025-04-26)
+
+## 1.0.0-beta.61 (2025-03-22)
+
+## 1.0.0-beta.60 (2025-03-16)
+
+## 1.0.0-beta.59 (2025-03-16)
+
+## 1.0.0-beta.58 (2025-03-12)
+
+## 1.0.0-beta.57 (2025-03-04)
+
+## 1.0.0-beta.56 (2025-03-03)
+
+## 1.0.0-beta.55 (2025-02-28)
+
+## 1.0.0-beta.54 (2025-02-28)
+
+## 1.0.0-beta.53 (2025-02-28)
+
+## 1.0.0-beta.53 (2025-02-28)

package/README.md

@@ -0,0 +1,36 @@
+[![Rasengan Logo](https://www.beta.rasengan.dev/home.png)](https://rasengan.dev)
+
+[![npm version](https://badge.fury.io/js/rasengan.svg)](https://badge.fury.io/js/rasengan)
+[![npm downloads](https://img.shields.io/npm/dm/rasengan)](https://www.npmjs.com/package/rasengan)
+[![GitHub license](https://img.shields.io/github/license/rasengan-dev/rasenganjs)](https://github.com/rasengan-dev/rasenganjs/blob/main/LICENSE)
+
+## Getting Started
+
+Based on modern tools, Rasengan.js will help you to create **high-quality web applications** with the benefit of React Components. It's a simple and easy-to-use framework that will help you to create a **beautiful and responsive web application**.
+
+- Visit the [Rasengan.js Showcase](https://rasengan.dev/showcase) to see more sites built with Rasengan.js.
+- Visit the [Rasengan.js Blog](https://rasengan.dev/blog) to get all news related to Rasengan.js.
+
+## Documentation
+
+Visit [https://rasengan.dev/docs](https://rasengan.dev/docs) to view the full documentation.
+
+## Community
+
+The Rasengan.js community can be found on [GitHub Discussions](https://github.com/rasengan-dev/rasenganjs/discussions) where you can ask questions, voice ideas, and share your projects with other people.
+
+We also have a [Twitter](https://twitter.com/rasenganjs) account where you can follow us to get the latest news about Rasengan.js.
+
+## License
+
+Rasengan.js is [MIT licensed](https://github.com/rasengan-dev/rasenganjs/blob/main/LICENSE).
+
+## Contributing
+
+We are open to all contributions. If you want to contribute to Rasengan.js, please read the [Contributing Guide](https://github.com/rasengan-dev/rasenganjs/blob/main/CONTRIBUTING.md) to get started.
+
+## Authors
+
+Here are the authors of Rasengan.js, the people who are at the origin of this great framework:
+
+- Dilane Kombou ([**@dilanekombou**](https://twitter.com/dilanekombou))

package/bin.js

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+
+// Import `process` explicitly if needed (e.g., in certain runtime environments).
+import process from 'process';
+
+// If not already set, default `NODE_ENV=development`
+process.env.NODE_ENV = process.env.NODE_ENV ?? 'development';
+
+// Import and execute the CLI script
+import('./lib/esm/cli/index.js').catch((err) => {
+  console.error('Failed to start the Rasengan CLI:', err);
+  process.exit(1);
+});

package/lib/esm/cli/index.js

@@ -1,149 +1,40 @@
-#!/usr/bin/env node
-var __assign = (this && this.__assign) || function () {
-    __assign = Object.assign || function(t) {
-        for (var s, i = 1, n = arguments.length; i < n; i++) {
-            s = arguments[i];
-            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
-                t[p] = s[p];
-        }
-        return t;
-    };
-    return __assign.apply(this, arguments);
-};
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-var __generator = (this && this.__generator) || function (thisArg, body) {
-    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
-    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
-    function verb(n) { return function (v) { return step([n, v]); }; }
-    function step(op) {
-        if (f) throw new TypeError("Generator is already executing.");
-        while (g && (g = 0, op[0] && (_ = 0)), _) try {
-            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
-            if (y = 0, t) op = [op[0] & 2, t.value];
-            switch (op[0]) {
-                case 0: case 1: t = op; break;
-                case 4: _.label++; return { value: op[1], done: false };
-                case 5: _.label++; y = op[1]; op = [0]; continue;
-                case 7: op = _.ops.pop(); _.trys.pop(); continue;
-                default:
-                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
-                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
-                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
-                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
-                    if (t[2]) _.ops.pop();
-                    _.trys.pop(); continue;
-            }
-            op = body.call(thisArg, _);
-        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
-        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
-    }
-};
-import chalk from "chalk";
-import { Command } from "commander";
-import { execa } from "execa";
-// Config
-// @ts-ignore
-import config from "../../../../../rasengan.config.js";
-var program = new Command();
+import chalk from 'chalk';
+import { Command } from 'commander';
+import { execa } from 'execa';
+const program = new Command();
 program
-    .name(chalk.blue("rasengan"))
-    .version("1.0.0", "-v, --version", "Output the current version number");
+    .name(chalk.blue('rasengan'))
+    .version('1.0.0', '-v, --version', 'Output the current version number');
 // Handle the dev command
 program
-    .command("dev")
-    .option("-p <port>")
-    .description("Start development server")
-    .action(function (_a) {
-    var port = _a.p;
-    return __awaiter(void 0, void 0, void 0, function () {
-        var convertedPort;
-        return __generator(this, function (_b) {
-            convertedPort = Number(port);
-            // Checking port
-            if (port &&
-                (isNaN(convertedPort) || convertedPort < 0 || convertedPort > 65535)) {
-                console.log("");
-                console.log(chalk.red("Please provide a valid port number between 0-65535"));
-                console.log("");
-                process.exit(1);
-            }
-            execa("node", ["node_modules/rasengan/server"], {
-                stdio: "inherit",
-                env: __assign(__assign({}, process.env), { PORT: convertedPort ? convertedPort.toString() : undefined }),
-            });
-            return [2 /*return*/];
-        });
+    .command('dev')
+    .option('-p <port>')
+    .description('Start development server')
+    .action(async ({ p: port }) => {
+    const convertedPort = Number(port);
+    // Checking port
+    if (port &&
+        (isNaN(convertedPort) || convertedPort < 0 || convertedPort > 65535)) {
+        console.log('');
+        console.log(chalk.red('Please provide a valid port number between 0-65535'));
+        console.log('');
+        process.exit(1);
+    }
+    execa('node', ['node_modules/rasengan/lib/esm/server/dev/server'], {
+        stdio: 'inherit',
+        env: {
+            ...process.env,
+            PORT: convertedPort ? convertedPort.toString() : undefined,
+        },
     });
 });
 // Handle the build command
 program
-    .command("build")
-    .description("Build the project")
-    .action(function () {
-    execa("npm", ["run", "build"], {
-        cwd: "node_modules/rasengan",
-        stdio: "inherit", // Pipe child process output to the parent process
+    .command('build')
+    .description('Build the project')
+    .action(async () => {
+    execa('node', ['node_modules/rasengan/lib/esm/scripts/build-command'], {
+        stdio: 'inherit',
     });
 });
-// Handle the prebuild command
-program
-    .command("prepare")
-    .description("Prepare the project")
-    .action(function () {
-    var _a, _b;
-    // Displaying the message
-    console.log("");
-    console.log(chalk.blue("Preparing your project for production..."));
-    console.log("");
-    // Checking the config file in order to know about hosting strategy
-    var server = config.server;
-    var hostingStrategy = (_b = (_a = server === null || server === void 0 ? void 0 : server.production) === null || _a === void 0 ? void 0 : _a.hosting) !== null && _b !== void 0 ? _b : "custom";
-    if (hostingStrategy === "vercel") {
-        // Displaying the message
-        console.log("Your project is configured to be hosted on ".concat(chalk.bold.blue(hostingStrategy), "\n"));
-        // Copying the api folder to the root directory
-        execa("cp", ["-r", "node_modules/rasengan/lib/server/functions/vercel/api", "."], {
-            stdio: "inherit",
-        });
-        // Copying the vercel.json file to the root directory
-        execa("cp", ["node_modules/rasengan/lib/server/functions/vercel/vercel.json", "."], {
-            stdio: "inherit",
-        });
-        // Removing index.d.ts and index.js.map files from the api folder
-        execa("rm", ["api/index.d.ts"], {
-            stdio: "inherit",
-        });
-    }
-    else if (hostingStrategy === "netlify") {
-        // Copying the netlify.toml file to the root directory
-        // execa(
-        //   "cp",
-        //   ["node_modules/rasengan/src/server/functions/netlify/netlify.toml", "."],
-        //   {
-        //     stdio: "inherit",
-        //   }
-        // );
-    }
-});
-// Handle the start command
-program
-    .command("start")
-    .description("Start the project in production mode")
-    .action(function () { return __awaiter(void 0, void 0, void 0, function () {
-    return __generator(this, function (_a) {
-        execa("npm", ["run", "preview"], {
-            cwd: "node_modules/rasengan",
-            stdio: "inherit", // Pipe child process output to the parent process
-        });
-        return [2 /*return*/];
-    });
-}); });
 program.parse(process.argv);

package/lib/esm/client.js

@@ -0,0 +1,2 @@
+import renderApp from './entries/client/render.js';
+export { renderApp };

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

@@ -0,0 +1,3 @@
+import { defineConfig } from './utils/define-config.js';
+import { resolvePath } from './utils/path.js';
+export { defineConfig, resolvePath };

package/lib/esm/core/config/type.js

@@ -0,0 +1,6 @@
+export {};
+// export type ConfigOptions = {
+//   mode: 'development' | 'production' | 'test';
+//   command: 'serve' | 'build';
+//   isSsrBuild?: boolean;
+// };

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

@@ -0,0 +1,80 @@
+/**
+ * Function to define the config for the app
+ * It will be used by vite.config.ts and other files in other to configure the app
+ * @param {AppConfig | AppConfigFunction | AppConfigFunctionAsync} loadedConfig
+ */
+export const defineConfig = async (loadedConfig) => {
+    return async () => {
+        let config;
+        // Check if the loadedConfig is a function
+        if (typeof loadedConfig === 'function') {
+            // Call the function to get the config
+            const result = loadedConfig();
+            // Check if it's a promise (asynchronous function)
+            if (result instanceof Promise) {
+                config = await result; // Await the promise result (AppConfigFunctionAsync)
+            }
+            else {
+                config = result; // Synchronous function result (AppConfigFunction)
+            }
+        }
+        else {
+            config = loadedConfig;
+        }
+        const { ssr, server, vite, redirects } = config;
+        // Define default values for vite config coming from loadedConfig.vite
+        const defaultViteConfig = {
+            ...vite,
+            resolve: {
+                symbole: vite?.resolve?.symbole || '@',
+                alias: vite?.resolve?.alias || [],
+            },
+        };
+        // Define default values for server config coming from loadedConfig.server
+        const defaultServerConfig = {
+            development: {
+                port: server?.development?.port || undefined,
+                open: server?.development?.open || false,
+            },
+        };
+        // Define default values for redirects config coming from loadedConfig.redirects
+        const defaultRedirectsConfig = redirects || (() => new Promise((resolve) => resolve([])));
+        try {
+            const config = {
+                ssr: ssr ?? true,
+                server: defaultServerConfig,
+                vite: {
+                    ...defaultViteConfig,
+                    resolve: {
+                        alias: [
+                            {
+                                find: defaultViteConfig.resolve.symbole,
+                                replacement: './src',
+                            },
+                            ...defaultViteConfig.resolve.alias,
+                        ],
+                    },
+                },
+                redirects: defaultRedirectsConfig,
+            };
+            return config;
+        }
+        catch (error) {
+            return {
+                ssr: true,
+                vite: {
+                    appType: 'custom',
+                    resolve: {
+                        alias: [
+                            {
+                                find: '@',
+                                replacement: './src',
+                            },
+                        ],
+                    },
+                },
+                redirects: () => new Promise((resolve) => resolve([])),
+            };
+        }
+    };
+};

package/lib/esm/core/config/utils/load-modules.js

@@ -0,0 +1,78 @@
+import { resolvePath } from './path.js';
+import fs from 'fs/promises';
+export const extensions = [
+    '.mjs',
+    '.js',
+    '.mts',
+    '.ts',
+    '.jsx',
+    '.tsx',
+    '.json',
+];
+/**
+ * Asynchronously loads a module from a file path only in the server-side environment.
+ *
+ * @param path - The path to the module.
+ * @returns The loaded module.
+ */
+export const loadModuleSSR = async (path) => {
+    try {
+        let modulePath = path;
+        // Check if the module path has an extension
+        const moduleExtension = path.split('.').pop(); // eg: js or ts
+        if (!moduleExtension || !extensions.includes(`.${moduleExtension}`)) {
+            const { path: newPath } = await findModulePath(path);
+            modulePath = newPath;
+        }
+        const module = await import(/* @vite-ignore */ resolvePath(modulePath));
+        return module;
+    }
+    catch (error) {
+        throw new Error(error);
+    }
+};
+/**
+ * Finds the module path with the right extension.
+ *
+ * @param path - The path to the module.
+ * @returns The module path and extension.
+ */
+export const findModulePath = async (path) => {
+    try {
+        let modulePath = path;
+        let rightExtension = '';
+        // Check if the module path has an extension
+        const moduleExtension = path.split('.').pop(); // eg: js or ts
+        if (!moduleExtension || !extensions.includes(`.${moduleExtension}`)) {
+            for (let ext of extensions) {
+                const newModulePath = `${modulePath}${ext}`;
+                try {
+                    await fs.access(newModulePath);
+                    modulePath = newModulePath;
+                    rightExtension = ext;
+                    break;
+                }
+                catch (error) {
+                    continue;
+                }
+            }
+            if (modulePath === path) {
+                throw new Error(`Module "${path}" not found`);
+            }
+        }
+        return {
+            path: modulePath,
+            extension: rightExtension,
+        };
+    }
+    catch (error) {
+        throw new Error(error);
+    }
+};
+export const getDirname = async (url) => {
+    // Load the dirname function from the path module
+    // and return the dirname of the file URL
+    const { dirname } = await import('node:path');
+    const { fileURLToPath } = await import('node:url');
+    return dirname(fileURLToPath(url));
+};

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

@@ -0,0 +1,16 @@
+import path from 'node:path';
+/**
+ * Adapts the provided file path to a valid URL format based on the operating system.
+ *
+ * @param path - The file path to be adapted.
+ * @returns The adapted file path in a valid URL format.
+ */
+export const resolvePath = (pathValue) => {
+    // Check the OS
+    const isWindows = process.platform === 'win32';
+    // Adapt the path
+    if (isWindows) {
+        return `file:///${path.normalize(pathValue)}`;
+    }
+    return path.normalize(pathValue);
+};

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

@@ -0,0 +1,92 @@
+// core/config/defaults.ts
+import { join } from 'node:path';
+// Define core external packages
+const CORE_EXTERNALS = [
+// '@rasenganjs/mdx',
+// '@rasenganjs/vercel',
+// '@rasenganjs/netlify',
+];
+export const createDefaultViteConfig = (rootPath, __dirname, mode, config) => {
+    // Combine core externals with user-defined externals
+    const externals = [
+        ...CORE_EXTERNALS,
+        ...(Array.isArray(config.vite?.build?.external)
+            ? config.vite.build.external
+            : []),
+    ];
+    return {
+        ...config.vite,
+        root: rootPath,
+        build: {
+            sourcemap: mode === 'development',
+            rollupOptions: {
+                external: externals,
+                input: './src/index',
+                output: {
+                    manualChunks(id) {
+                        if (id.includes('node_modules'))
+                            return 'vendor';
+                        if (id.includes('src/components'))
+                            return 'shared-components';
+                        if (config.ssr) {
+                            if (id.includes('src/app') && id.includes('.page.')) {
+                                const parts = id.split('src/app')[1]?.split('/');
+                                if (parts?.length) {
+                                    const pageName = parts.pop()?.split('.')[0];
+                                    return pageName ? `page-${pageName}` : undefined;
+                                }
+                            }
+                        }
+                        return undefined;
+                    },
+                },
+            },
+            outDir: 'dist',
+            chunkSizeWarningLimit: 1000,
+        },
+        environments: {
+            client: {
+                build: {
+                    manifest: true,
+                    outDir: config.ssr ? 'dist/client' : 'dist',
+                    rollupOptions: {
+                        input: './src/index',
+                    },
+                },
+            },
+            ssr: {
+                build: {
+                    outDir: 'dist/server',
+                    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: {
+            alias: Array.isArray(config.vite?.resolve?.alias)
+                ? config.vite.resolve.alias.map(({ find, replacement }) => ({
+                    find,
+                    replacement: join(rootPath, replacement),
+                }))
+                : [],
+        },
+        builder: {
+            buildApp: async (builder) => {
+                if (config.ssr) {
+                    await builder.build(builder.environments.ssr);
+                }
+                await builder.build(builder.environments.client);
+            },
+        },
+        cacheDir: '.rasengan/',
+        envPrefix: 'RASENGAN_',
+        appType: 'custom',
+    };
+};

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

@@ -0,0 +1,21 @@
+import { Fragment as _Fragment, jsx as _jsx } from "react/jsx-runtime";
+import { Suspense, lazy } from 'react';
+/**
+ * It allows you to defer loading of Client Components,
+ * and only include them in the client bundle when they're needed
+ * @param load
+ * @param fallback
+ * @returns
+ */
+export function dynamicLoad(load, fallback = _jsx(_Fragment, {}) // Default pending UI element
+) {
+    try {
+        const LazyComponent = lazy(load);
+        // Return a functional component preserving the exact props type
+        const WrappedComponent = (props) => (_jsx(Suspense, { fallback: fallback, children: _jsx(LazyComponent, { ...props }) }));
+        return WrappedComponent;
+    }
+    catch (error) {
+        throw new Error(error);
+    }
+}

package/lib/esm/core/index.js

@@ -1 +1,2 @@
-export { Body, Scripts } from "./components/index.js";
+// export { defineConfig, resolvePath } from "./config/index.js";
+export {};

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

@@ -0,0 +1 @@
+export * from './logger.js';

package/lib/esm/core/middlewares/logger.js

@@ -0,0 +1,6 @@
+import { logGetRequest as log } from '../utils/log.js';
+export const loggerMiddleware = (req, _, next) => {
+    const url = req.originalUrl;
+    log(url);
+    next();
+};