arcanajs 1.0.0 → 2.0.1

package/README.md

@@ -1,115 +1,17 @@
-<div align="center">
-  <img src="https://digiclips.ma/arcanajs.png" alt="ArcanaJS Logo" width="200" style="border-radius: 9px;"/>
-  
-  <p><strong>ArcanaJS A modern, full-stack JavaScript framework for building fast, SEO-friendly web applications</strong></p>
+# ArcanaJS Framework
 
-[![npm version](https://img.shields.io/npm/v/arcanajs.svg?style=flat-square)](https://www.npmjs.com/package/arcanajs)
-[![license](https://img.shields.io/npm/l/arcanajs.svg?style=flat-square)](https://github.com/arcanajs/arcanajs/blob/main/LICENSE)
-[![downloads](https://img.shields.io/npm/dm/arcanajs.svg?style=flat-square)](https://www.npmjs.com/package/arcanajs)
-[![Build Status](https://img.shields.io/github/actions/workflow/status/arcanajs/arcanajs/ci.yml?style=flat-square)](https://github.com/arcanajs/arcanajs/actions)
+ArcanaJS is a modern React framework for building server-side rendered (SSR) applications with ease. It combines the power of Express, React, and TypeScript to provide a seamless development experience.
 
-[Website](https://arcanajs.com) • [Documentation](https://arcanajs.com/docs) • [Examples](https://github.com/arcanajs/examples) • [Community](https://discord.gg/zkFDewQ7TW)
+## Features
 
-</div>
+- **Server-Side Rendering (SSR):** Fast initial load times and SEO-friendly pages.
+- **TypeScript Support:** Built with TypeScript for type safety and better developer experience.
+- **File-based Routing:** Intuitive routing based on your file structure.
+- **Hot Module Replacement (HMR):** Fast development cycle with instant updates.
+- **Tailwind CSS:** Integrated support for utility-first CSS.
 
-## 📚 Documentation
 
-Comprehensive guides, API references, and tutorials are available at: **[https://arcanajs.com/docs](https://arcanajs.com/docs)**
 
-## 🤝 Contributing
+## License
 
-We welcome contributions from the community! Whether it's:
-
-- 🐛 **Bug reports** – Help us identify and fix issues
-- 💡 **Feature requests** – Share your ideas for improvements
-- 📝 **Documentation** – Improve or translate our docs
-- 🔧 **Code contributions** – Submit bug fixes or new features
-
-### How to Contribute
-
-1. **Fork** the repository
-2. **Create** a feature branch:
-   ```bash
-   git checkout -b feature/amazing-feature
-   ```
-3. **Commit** your changes:
-   ```bash
-   git commit -m "feat: add amazing feature"
-   ```
-4. **Push** to your branch:
-   ```bash
-   git push origin feature/amazing-feature
-   ```
-5. **Open** a Pull Request
-
-### Contribution Guidelines
-
-- Follow the existing code style and conventions
-- Write clear commit messages (we use [Conventional Commits](https://www.conventionalcommits.org/))
-- Add tests for new features
-- Update documentation as needed
-- Ensure all tests pass before submitting PR
-
-Refer to our [Contributing Guidelines](CONTRIBUTING.md) for detailed information.
-
----
-
-## 💬 Community
-
-Join our growing community:
-
-- **Discord** – [Join our Discord server](https://discord.gg/zkFDewQ7TW) for discussions and support
-- **Twitter** – Follow [@ArcanaJS](https://twitter.com/arcanajs) for updates
-- **Stack Overflow** – Tag your questions with `arcanajs`
-- **GitHub Discussions** – [Start a discussion](https://github.com/arcanajs/arcanajs/discussions)
-
-## 🙏 Acknowledgments
-
-ArcanaJS is built on the shoulders of giants. Special thanks to:
-
-- The **React** team for the amazing UI library
-- The **Express** community for the robust web framework
-- The **MongoDB** team for the flexible database
-- All our [contributors](https://github.com/arcanajs/arcanajs/graphs/contributors) who make this project better
-
-### Inspiration
-
-ArcanaJS draws inspiration from excellent frameworks like:
-
-- [NestJS](https://nestjs.com/) – Progressive Node.js framework
-- [Laravel](https://laravel.com/) – PHP framework with elegant syntax
-
----
-
-## 👨‍💻 Author
-
-<div align="center">
-  <img src="https://github.com/mohammed-ben-cheikh.png" width="100" style="border-radius: 50%;" alt="Mohammed Ben Cheikh"/>
-  
-  **Mohammed Ben Cheikh**
-  
-  Full-Stack Developer & Framework Architect
-  
-  [![Website](https://img.shields.io/badge/Website-mohammedbencheikh.com-blue?style=flat-square)](https://mohammedbencheikh.com)
-  [![Email](https://img.shields.io/badge/Email-mohammed.bencheikh.dev@gmail.com-red?style=flat-square)](mailto:mohammed.bencheikh.dev@gmail.com)
-  [![GitHub](https://img.shields.io/badge/GitHub-@mohammed--ben--cheikh-black?style=flat-square)](https://github.com/mohammed-ben-cheikh)
-  [![LinkedIn](https://img.shields.io/badge/LinkedIn-Connect-blue?style=flat-square)](https://linkedin.com/in/mohammed-ben-cheikh)
-</div>
-
----
-
-<div align="center">
-  <p><strong>Made with ❤️ and dedication by <a href="https://mohammedbencheikh.com">Mohammed Ben Cheikh</a></strong></p>
-  
-  <p>If you find <strong>ArcanaJS</strong> useful, please consider:</p>
-  
-  ⭐ **[Starring the project](https://github.com/arcanajs/arcanajs)** on GitHub
-  
-  🐦 **[Following us](https://twitter.com/arcanajs)** on Twitter
-  
-  💖 **[Sponsoring the project](https://github.com/sponsors/arcanajs)** to support development
-  
-  ---
-  
-  <sub>© 2025 ArcanaJS. All rights reserved.</sub>
-</div>
+MIT

package/babel.config.js

@@ -0,0 +1,7 @@
+module.exports = {
+  presets: [
+    "@babel/preset-env",
+    "@babel/preset-react",
+    "@babel/preset-typescript",
+  ],
+};

package/lib/client/index.d.ts

@@ -0,0 +1,2 @@
+import React from "react";
+export declare const hydrateArcanaJS: (viewsOrContext: Record<string, React.FC<any>> | any, layout?: React.FC<any>) => void;

package/lib/client/index.js

@@ -0,0 +1,40 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hydrateArcanaJS = void 0;
+const react_1 = __importDefault(require("react"));
+const client_1 = require("react-dom/client");
+const HeadContext_1 = require("../shared/context/HeadContext");
+const ArcanaJSApp_1 = require("../shared/core/ArcanaJSApp");
+const hydrateArcanaJS = (viewsOrContext, layout) => {
+    let views = {};
+    if (viewsOrContext.keys && typeof viewsOrContext.keys === "function") {
+        viewsOrContext.keys().forEach((key) => {
+            const viewName = key.replace(/^\.\/(.*)\.tsx$/, "$1");
+            views[viewName] = viewsOrContext(key).default;
+        });
+    }
+    else {
+        views = viewsOrContext;
+    }
+    const container = document.getElementById("root");
+    const dataScript = document.getElementById("__ArcanaJS_DATA__");
+    // Client-side HeadManager (noop for push, as Head handles client updates via useEffect)
+    const headManager = {
+        tags: [],
+        push: () => { },
+    };
+    if (container && dataScript) {
+        try {
+            const { page, data, params, csrfToken } = JSON.parse(dataScript.textContent || "{}");
+            (0, client_1.hydrateRoot)(container, react_1.default.createElement(HeadContext_1.HeadContext.Provider, { value: headManager },
+                react_1.default.createElement(ArcanaJSApp_1.ArcanaJSApp, { initialPage: page, initialData: data, initialParams: params, csrfToken: csrfToken, views: views, layout: layout })));
+        }
+        catch (e) {
+            console.error("Failed to parse initial data", e);
+        }
+    }
+};
+exports.hydrateArcanaJS = hydrateArcanaJS;

package/lib/index.d.ts

@@ -0,0 +1,17 @@
+export * from "./client";
+export * from "./shared/components/Body";
+export * from "./shared/components/Head";
+export * from "./shared/components/Link";
+export * from "./shared/components/NavLink";
+export * from "./shared/components/Page";
+export * from "./shared/context/HeadContext";
+export * from "./shared/context/PageContext";
+export * from "./shared/context/RouterContext";
+export * from "./shared/core/ArcanaJSApp";
+export * from "./shared/hooks/useDynamicComponents";
+export * from "./shared/hooks/useHead";
+export * from "./shared/hooks/useLocation";
+export * from "./shared/hooks/usePage";
+export * from "./shared/hooks/useParams";
+export * from "./shared/hooks/useQuery";
+export * from "./shared/hooks/useRouter";

package/lib/index.js

@@ -0,0 +1,33 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./client"), exports);
+__exportStar(require("./shared/components/Body"), exports);
+__exportStar(require("./shared/components/Head"), exports);
+__exportStar(require("./shared/components/Link"), exports);
+__exportStar(require("./shared/components/NavLink"), exports);
+__exportStar(require("./shared/components/Page"), exports);
+__exportStar(require("./shared/context/HeadContext"), exports);
+__exportStar(require("./shared/context/PageContext"), exports);
+__exportStar(require("./shared/context/RouterContext"), exports);
+__exportStar(require("./shared/core/ArcanaJSApp"), exports);
+__exportStar(require("./shared/hooks/useDynamicComponents"), exports);
+__exportStar(require("./shared/hooks/useHead"), exports);
+__exportStar(require("./shared/hooks/useLocation"), exports);
+__exportStar(require("./shared/hooks/usePage"), exports);
+__exportStar(require("./shared/hooks/useParams"), exports);
+__exportStar(require("./shared/hooks/useQuery"), exports);
+__exportStar(require("./shared/hooks/useRouter"), exports);

package/lib/server/ArcanaJSMiddleware.d.ts

@@ -0,0 +1,16 @@
+import { NextFunction, Request, Response } from "express";
+import React from "react";
+declare global {
+    namespace Express {
+        interface Response {
+            renderPage(page: string, data?: any, params?: Record<string, string>): void;
+        }
+    }
+}
+interface ArcanaJSOptions {
+    views: Record<string, React.FC<any>>;
+    indexFile?: string;
+    layout?: React.FC<any>;
+}
+export declare const createArcanaJSMiddleware: (options: ArcanaJSOptions) => (req: Request, res: Response, next: NextFunction) => void;
+export {};

package/lib/server/ArcanaJSMiddleware.js

@@ -0,0 +1,99 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createArcanaJSMiddleware = void 0;
+const fs_1 = __importDefault(require("fs"));
+const react_1 = __importDefault(require("react"));
+const server_1 = require("react-dom/server");
+const HeadContext_1 = require("../shared/context/HeadContext");
+const ArcanaJSApp_1 = require("../shared/core/ArcanaJSApp");
+const DEFAULT_HTML_TEMPLATE = `<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <!--HEAD_CONTENT-->
+  </head>
+  <body>
+    <div id="root"><!--APP_CONTENT--></div>
+    <!--ARCANAJS_DATA_SCRIPT-->
+  </body>
+</html>`;
+// Helper to prevent XSS in initial data
+const safeStringify = (obj) => {
+    return JSON.stringify(obj).replace(/</g, "\\u003c");
+};
+const createArcanaJSMiddleware = (options) => {
+    const { views, indexFile, layout } = options;
+    let cachedIndexHtml = null;
+    const getIndexHtml = (callback) => {
+        if (process.env.NODE_ENV === "production" && cachedIndexHtml) {
+            return callback(null, cachedIndexHtml);
+        }
+        if (indexFile && fs_1.default.existsSync(indexFile)) {
+            fs_1.default.readFile(indexFile, "utf8", (err, htmlData) => {
+                if (!err && process.env.NODE_ENV === "production") {
+                    cachedIndexHtml = htmlData;
+                }
+                callback(err, htmlData);
+            });
+        }
+        else {
+            if (process.env.NODE_ENV === "production") {
+                cachedIndexHtml = DEFAULT_HTML_TEMPLATE;
+            }
+            callback(null, DEFAULT_HTML_TEMPLATE);
+        }
+    };
+    return (req, res, next) => {
+        res.renderPage = (page, data = {}, params = {}) => {
+            const csrfToken = res.locals.csrfToken;
+            if (req.headers["x-arcanajs-request"] || req.query.format === "json") {
+                return res.json({ page, data, params, csrfToken });
+            }
+            try {
+                const headTags = [];
+                const headManager = {
+                    tags: headTags,
+                    push: (nodes) => headTags.push(nodes),
+                };
+                const appHtml = (0, server_1.renderToString)(react_1.default.createElement(HeadContext_1.HeadContext.Provider, { value: headManager }, react_1.default.createElement(ArcanaJSApp_1.ArcanaJSApp, {
+                    initialPage: page,
+                    initialData: data,
+                    initialParams: params,
+                    initialUrl: req.path,
+                    csrfToken: csrfToken,
+                    views: views,
+                    layout: layout,
+                })));
+                const headHtml = (0, server_1.renderToString)(react_1.default.createElement(react_1.default.Fragment, null, ...headTags));
+                getIndexHtml((err, htmlData) => {
+                    if (err) {
+                        console.error("Error reading index.html", err);
+                        return res.status(500).send("Server Error");
+                    }
+                    const scriptContent = safeStringify({
+                        page,
+                        data,
+                        params,
+                        csrfToken,
+                    });
+                    const scriptTag = `<script id="__ArcanaJS_DATA__" type="application/json">${scriptContent}</script>`;
+                    const html = htmlData
+                        .replace("<!--HEAD_CONTENT-->", headHtml)
+                        .replace("<!--APP_CONTENT-->", appHtml)
+                        .replace("<!--ARCANAJS_DATA_SCRIPT-->", scriptTag);
+                    res.send(html);
+                });
+            }
+            catch (error) {
+                console.error("SSR Error:", error);
+                res.status(500).send("Internal Server Error");
+            }
+        };
+        next();
+    };
+};
+exports.createArcanaJSMiddleware = createArcanaJSMiddleware;

package/lib/server/ArcanaJSServer.d.ts

@@ -0,0 +1,21 @@
+import { Express, RequestHandler } from "express";
+import React from "react";
+export interface ArcanaJSConfig {
+    port?: number | string;
+    views?: Record<string, React.FC<any>>;
+    viewsDir?: string;
+    viewsContext?: any;
+    routes?: RequestHandler | RequestHandler[];
+    staticDir?: string;
+    distDir?: string;
+    indexFile?: string;
+    layout?: React.FC<any>;
+}
+export declare class ArcanaJSServer {
+    app: Express;
+    private config;
+    constructor(config: ArcanaJSConfig);
+    private initialize;
+    private discoverViews;
+    start(): void;
+}

package/lib/server/ArcanaJSServer.js

@@ -0,0 +1,140 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ArcanaJSServer = void 0;
+const compression_1 = __importDefault(require("compression"));
+const cookie_parser_1 = __importDefault(require("cookie-parser"));
+const express_1 = __importDefault(require("express"));
+const fs_1 = __importDefault(require("fs"));
+const helmet_1 = __importDefault(require("helmet"));
+const path_1 = __importDefault(require("path"));
+const ArcanaJSMiddleware_1 = require("./ArcanaJSMiddleware");
+const CsrfMiddleware_1 = require("./CsrfMiddleware");
+const DynamicRouter_1 = require("./DynamicRouter");
+const ResponseHandlerMiddleware_1 = require("./ResponseHandlerMiddleware");
+class ArcanaJSServer {
+    constructor(config) {
+        this.config = config;
+        this.app = (0, express_1.default)();
+        this.initialize();
+    }
+    initialize() {
+        let { staticDir = "public", distDir = "dist/public", indexFile = "dist/public/index.html", views, viewsContext, routes, layout, } = this.config;
+        if (!views && viewsContext) {
+            views = {};
+            viewsContext.keys().forEach((key) => {
+                const viewName = key.replace(/^\.\/(.*)\.tsx$/, "$1");
+                views[viewName] = viewsContext(key).default;
+            });
+        }
+        if (!views) {
+            // Auto-discovery using fs (Server-side only)
+            views = this.discoverViews();
+        }
+        if (!views || Object.keys(views).length === 0) {
+            console.warn("No views found. Please check your views directory.");
+            views = {};
+        }
+        // Security and Performance
+        this.app.use((0, helmet_1.default)({
+            contentSecurityPolicy: false,
+        }));
+        this.app.use((0, compression_1.default)());
+        this.app.use((0, cookie_parser_1.default)());
+        this.app.use((0, CsrfMiddleware_1.createCsrfMiddleware)());
+        this.app.use(ResponseHandlerMiddleware_1.responseHandler);
+        // Static files
+        this.app.use(express_1.default.static(path_1.default.resolve(process.cwd(), distDir), {
+            index: false,
+            maxAge: "1y",
+        }));
+        this.app.use(express_1.default.static(path_1.default.resolve(process.cwd(), staticDir), {
+            index: false,
+            maxAge: "1d",
+        }));
+        // ArcanaJS Middleware
+        this.app.use((0, ArcanaJSMiddleware_1.createArcanaJSMiddleware)({
+            views,
+            indexFile: path_1.default.resolve(process.cwd(), indexFile),
+            layout,
+        }));
+        // Custom Routes
+        if (routes) {
+            if (Array.isArray(routes)) {
+                routes.forEach((route) => this.app.use(route));
+            }
+            else {
+                this.app.use(routes);
+            }
+        }
+        // Dynamic Router
+        this.app.use((0, DynamicRouter_1.createDynamicRouter)(views));
+        // 404 Fallback
+        this.app.use((req, res) => {
+            res.status(404).renderPage("NotFoundPage");
+        });
+        // Error Handler
+        this.app.use((err, req, res, next) => {
+            console.error(err);
+            const message = process.env.NODE_ENV === "production"
+                ? "Internal Server Error"
+                : err.message;
+            res.status(500).renderPage("ErrorPage", { message });
+        });
+    }
+    discoverViews() {
+        const views = {};
+        const viewsDir = this.config.viewsDir
+            ? path_1.default.resolve(process.cwd(), this.config.viewsDir)
+            : path_1.default.resolve(process.cwd(), "src/views");
+        const traverse = (dir) => {
+            if (!fs_1.default.existsSync(dir))
+                return;
+            const files = fs_1.default.readdirSync(dir);
+            files.forEach((file) => {
+                const fullPath = path_1.default.join(dir, file);
+                const stat = fs_1.default.statSync(fullPath);
+                if (stat.isDirectory()) {
+                    traverse(fullPath);
+                }
+                else if (file.endsWith(".tsx") || file.endsWith(".jsx")) {
+                    const relativePath = path_1.default.relative(viewsDir, fullPath);
+                    const viewName = relativePath.replace(/\.(tsx|jsx)$/, "");
+                    try {
+                        // Use __non_webpack_require__ if available to avoid Webpack bundling issues
+                        // or standard require if running in Node directly
+                        const requireFunc = typeof __non_webpack_require__ !== "undefined"
+                            ? __non_webpack_require__
+                            : module.require;
+                        // We need to register ts-node if we are requiring .tsx files directly
+                        // This is a simplified approach. In a real framework, we'd handle compilation.
+                        if (file.endsWith(".tsx") || file.endsWith(".ts")) {
+                            try {
+                                requireFunc("ts-node/register");
+                            }
+                            catch (e) {
+                                // Ignore if already registered or not found (might be pre-compiled)
+                            }
+                        }
+                        const pageModule = requireFunc(fullPath);
+                        views[viewName] = pageModule.default || pageModule;
+                    }
+                    catch (error) {
+                        console.error(`Failed to load view ${viewName}:`, error);
+                    }
+                }
+            });
+        };
+        traverse(viewsDir);
+        return views;
+    }
+    start() {
+        const PORT = this.config.port || process.env.PORT || 3000;
+        this.app.listen(PORT, () => {
+            console.log(`Server is running on http://localhost:${PORT}`);
+        });
+    }
+}
+exports.ArcanaJSServer = ArcanaJSServer;

package/lib/server/ControllerBinder.d.ts

@@ -0,0 +1,4 @@
+import { NextFunction, Request, Response } from "express";
+export default class ControllerBinder {
+    static handle(controller: any, method: string): (req: Request, res: Response, next: NextFunction) => Promise<void>;
+}

package/lib/server/ControllerBinder.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+class ControllerBinder {
+    static handle(controller, method) {
+        // Instantiate the controller once (Singleton pattern) for performance
+        // This assumes controllers are stateless, which is best practice.
+        let instance;
+        try {
+            instance = new controller();
+        }
+        catch (e) {
+            // Fallback if controller is not a class or fails to instantiate
+            console.warn(`Failed to instantiate controller ${controller.name}`, e);
+            instance = controller;
+        }
+        return async (req, res, next) => {
+            try {
+                // Call the method
+                if (typeof instance[method] === "function") {
+                    await instance[method](req, res, next);
+                }
+                else {
+                    throw new Error(`Method ${method} not found on controller ${controller.name}`);
+                }
+            }
+            catch (error) {
+                next(error);
+            }
+        };
+    }
+}
+exports.default = ControllerBinder;

package/lib/server/CsrfMiddleware.d.ts

@@ -0,0 +1,2 @@
+import { NextFunction, Request, Response } from "express";
+export declare const createCsrfMiddleware: () => (req: Request, res: Response, next: NextFunction) => Response<any, Record<string, any>> | undefined;

package/lib/server/CsrfMiddleware.js

@@ -0,0 +1,34 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createCsrfMiddleware = void 0;
+const crypto_1 = __importDefault(require("crypto"));
+const CSRF_COOKIE_NAME = "_csrf";
+const createCsrfMiddleware = () => {
+    return (req, res, next) => {
+        // 1. Generate or retrieve token
+        let token = req.cookies[CSRF_COOKIE_NAME];
+        if (!token) {
+            token = crypto_1.default.randomBytes(32).toString("hex");
+            res.cookie(CSRF_COOKIE_NAME, token, {
+                httpOnly: true,
+                secure: process.env.NODE_ENV === "production",
+                sameSite: "strict",
+            });
+        }
+        // 2. Expose token to the response locals (for injection into the view)
+        res.locals.csrfToken = token;
+        // 3. Verify token on state-changing methods
+        const method = req.method.toUpperCase();
+        if (["POST", "PUT", "DELETE", "PATCH"].includes(method)) {
+            const headerToken = req.headers["x-csrf-token"];
+            if (!headerToken || headerToken !== token) {
+                return res.status(403).json({ error: "Invalid CSRF Token" });
+            }
+        }
+        next();
+    };
+};
+exports.createCsrfMiddleware = createCsrfMiddleware;

package/lib/server/DynamicRouter.d.ts

@@ -0,0 +1,2 @@
+import { NextFunction, Request, Response } from "express";
+export declare const createDynamicRouter: (views: Record<string, any>) => (req: Request, res: Response, next: NextFunction) => void;

package/lib/server/DynamicRouter.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createDynamicRouter = void 0;
+const createDynamicRouter = (views) => {
+    return (req, res, next) => {
+        // Remove leading slash
+        let path = req.path.substring(1);
+        // Handle root path mapping to "index" if not handled elsewhere
+        if (path === "") {
+            path = "index";
+        }
+        // 1. Exact match
+        if (views[path]) {
+            return res.renderPage(path, {});
+        }
+        // 2. Dynamic match
+        for (const viewName of Object.keys(views)) {
+            if (!viewName.includes("["))
+                continue;
+            // Convert view path to regex
+            // e.g., "users/[id]" -> "^users/([^/]+)$"
+            // We need to escape special regex characters first, but keep [ and ] for our logic
+            // Actually, simpler: split by '/' and match segments
+            const pageParts = viewName.split("/");
+            const pathParts = path.split("/");
+            if (pageParts.length !== pathParts.length)
+                continue;
+            let match = true;
+            const params = {};
+            for (let i = 0; i < pageParts.length; i++) {
+                const pagePart = pageParts[i];
+                const pathPart = pathParts[i];
+                if (pagePart.startsWith("[") && pagePart.endsWith("]")) {
+                    const paramName = pagePart.slice(1, -1);
+                    params[paramName] = pathPart;
+                }
+                else if (pagePart !== pathPart) {
+                    match = false;
+                    break;
+                }
+            }
+            if (match) {
+                return res.renderPage(viewName, {}, params);
+            }
+        }
+        // If not found, pass to the next middleware (usually 404 handler)
+        next();
+    };
+};
+exports.createDynamicRouter = createDynamicRouter;