arcanajs 2.5.0 → 2.5.1

package/framework/lib/shared/context/RouterContext.d.ts

@@ -0,0 +1,15 @@
+import React from "react";
+export interface RouterContextType {
+    navigateTo: (url: string) => void;
+    currentPage: string;
+    currentUrl: string;
+    params: Record<string, string>;
+    csrfToken?: string;
+    onNavigate?: (url: string) => void;
+    isNavigating: boolean;
+}
+export declare const RouterContext: React.Context<RouterContextType | null>;
+export declare const RouterProvider: React.FC<{
+    value: RouterContextType;
+    children: React.ReactNode;
+}>;

package/framework/lib/shared/context/RouterContext.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RouterProvider = exports.RouterContext = void 0;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const createSingletonContext_1 = require("../utils/createSingletonContext");
+exports.RouterContext = (0, createSingletonContext_1.createSingletonContext)("RouterContext", null);
+const RouterProvider = ({ value, children }) => {
+    return ((0, jsx_runtime_1.jsx)(exports.RouterContext.Provider, { value: value, children: children }));
+};
+exports.RouterProvider = RouterProvider;

package/framework/lib/shared/core/ArcanaJSApp.d.ts

@@ -0,0 +1,14 @@
+import React from "react";
+export interface ArcanaJSAppProps {
+    initialPage: string;
+    initialData: any;
+    initialParams?: Record<string, string>;
+    initialUrl?: string;
+    csrfToken?: string;
+    views: Record<string, React.FC<any>>;
+    layout?: React.FC<{
+        children: React.ReactNode;
+    }>;
+    onNavigate?: (url: string) => void;
+}
+export declare const ArcanaJSApp: React.FC<ArcanaJSAppProps>;

package/framework/lib/shared/core/ArcanaJSApp.js

@@ -0,0 +1,153 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ArcanaJSApp = void 0;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = __importStar(require("react"));
+const Page_1 = require("../components/Page");
+const RouterContext_1 = require("../context/RouterContext");
+const ArcanaJSApp = ({ initialPage, initialData, initialParams = {}, initialUrl, csrfToken, views, layout: Layout, onNavigate, }) => {
+    const [page, setPage] = (0, react_1.useState)(initialPage);
+    const [data, setData] = (0, react_1.useState)(initialData);
+    const [params, setParams] = (0, react_1.useState)(initialParams);
+    const [url, setUrl] = (0, react_1.useState)(initialUrl ||
+        (typeof window !== "undefined" ? window.location.pathname : "/"));
+    const [isNavigating, setIsNavigating] = (0, react_1.useState)(false);
+    // Navigation cache to store previously visited pages
+    const navigationCache = react_1.default.useRef(new Map());
+    (0, react_1.useEffect)(() => {
+        if (typeof window !== "undefined" && !window.history.state) {
+            window.history.replaceState({ page: initialPage, data: initialData, params: initialParams }, "", window.location.href);
+        }
+        const handlePopState = (event) => {
+            if (event.state) {
+                setPage(event.state.page);
+                setData(event.state.data);
+                setParams(event.state.params || {});
+                setUrl(window.location.pathname);
+            }
+            else {
+                window.location.reload();
+            }
+        };
+        window.addEventListener("popstate", handlePopState);
+        return () => window.removeEventListener("popstate", handlePopState);
+    }, []);
+    const navigateTo = async (newUrl) => {
+        // Check cache first for instant navigation
+        if (navigationCache.current.has(newUrl)) {
+            const cached = navigationCache.current.get(newUrl);
+            setPage(cached.page);
+            setData(cached.data);
+            setParams(cached.params || {});
+            setUrl(newUrl);
+            window.history.pushState(cached, "", newUrl);
+            // Scroll to top
+            if (typeof window !== "undefined") {
+                window.scrollTo({ top: 0, behavior: "smooth" });
+            }
+            if (onNavigate) {
+                onNavigate(newUrl);
+            }
+            return;
+        }
+        setIsNavigating(true);
+        try {
+            const response = await fetch(newUrl, {
+                headers: { "X-ArcanaJS-Request": "true" },
+                // prevent caching in dev navigation
+                cache: "no-store",
+            });
+            if (!response.ok) {
+                if (response.status === 404) {
+                    setPage("NotFoundPage");
+                    setUrl(newUrl);
+                    window.history.pushState({ page: "NotFoundPage", data: {} }, "", newUrl);
+                    return;
+                }
+                throw new Error(`Navigation failed: ${response.status} ${response.statusText}`);
+            }
+            // Ensure server returned JSON. If not, fallback to full navigation reload
+            const contentType = response.headers.get("content-type") || "";
+            if (!contentType.includes("application/json")) {
+                // The server returned HTML (or something else) instead of JSON.
+                // Do a full reload so the browser displays the correct page instead
+                // of trying to parse HTML as JSON (which causes the SyntaxError).
+                window.location.href = newUrl;
+                return;
+            }
+            const json = await response.json();
+            // Cache the navigation result
+            navigationCache.current.set(newUrl, {
+                page: json.page,
+                data: json.data,
+                params: json.params,
+            });
+            window.history.pushState({ page: json.page, data: json.data, params: json.params }, "", newUrl);
+            setPage(json.page);
+            setData(json.data);
+            setParams(json.params || {});
+            setUrl(newUrl);
+            // Scroll to top after navigation
+            if (typeof window !== "undefined") {
+                window.scrollTo({ top: 0, behavior: "smooth" });
+            }
+            if (onNavigate) {
+                onNavigate(newUrl);
+            }
+        }
+        catch (error) {
+            console.error("Navigation failed", error);
+        }
+        finally {
+            setIsNavigating(false);
+        }
+    };
+    const renderPage = () => {
+        const Component = views[page] || views["NotFoundPage"] || (() => (0, jsx_runtime_1.jsx)("div", { children: "404 Not Found" }));
+        return ((0, jsx_runtime_1.jsx)(Page_1.Page, { data: data, children: (0, jsx_runtime_1.jsx)(Component, { data: data, navigateTo: navigateTo, params: params }) }));
+    };
+    const content = renderPage();
+    return ((0, jsx_runtime_1.jsx)(RouterContext_1.RouterProvider, { value: {
+            navigateTo,
+            currentPage: page,
+            currentUrl: url,
+            params,
+            csrfToken,
+            onNavigate,
+            isNavigating,
+        }, children: Layout ? (0, jsx_runtime_1.jsx)(Layout, { children: content }) : (0, jsx_runtime_1.jsx)(jsx_runtime_1.Fragment, { children: content }) }));
+};
+exports.ArcanaJSApp = ArcanaJSApp;

package/framework/lib/shared/hooks/useHead.d.ts

@@ -0,0 +1 @@
+export declare const useHead: () => import("../context/HeadContext").HeadManager | null;

package/framework/lib/shared/hooks/useHead.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useHead = void 0;
+const react_1 = require("react");
+const HeadContext_1 = require("../context/HeadContext");
+const useHead = () => (0, react_1.useContext)(HeadContext_1.HeadContext);
+exports.useHead = useHead;

package/framework/lib/shared/hooks/useLocation.d.ts

@@ -0,0 +1,5 @@
+export declare const useLocation: () => {
+    pathname: string;
+    search: string;
+    hash: string;
+};

package/framework/lib/shared/hooks/useLocation.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useLocation = void 0;
+const useRouter_1 = require("./useRouter");
+const useLocation = () => {
+    const { currentUrl } = (0, useRouter_1.useRouter)();
+    return {
+        pathname: currentUrl,
+        search: typeof window !== "undefined" ? window.location.search : "",
+        hash: typeof window !== "undefined" ? window.location.hash : "",
+    };
+};
+exports.useLocation = useLocation;

package/framework/lib/shared/hooks/usePage.d.ts

@@ -0,0 +1 @@
+export declare const usePage: <T = any>() => T;

package/framework/lib/shared/hooks/usePage.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.usePage = void 0;
+const react_1 = require("react");
+const PageContext_1 = require("../context/PageContext");
+const usePage = () => (0, react_1.useContext)(PageContext_1.PageContext);
+exports.usePage = usePage;

package/framework/lib/shared/hooks/useParams.d.ts

@@ -0,0 +1 @@
+export declare const useParams: () => Record<string, string>;

package/framework/lib/shared/hooks/useParams.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useParams = void 0;
+const react_1 = require("react");
+const RouterContext_1 = require("../context/RouterContext");
+const useParams = () => {
+    const context = (0, react_1.useContext)(RouterContext_1.RouterContext);
+    if (!context) {
+        throw new Error("useParams must be used within an ArcanaJSApp");
+    }
+    return context.params;
+};
+exports.useParams = useParams;

package/framework/lib/shared/hooks/useQuery.d.ts

@@ -0,0 +1 @@
+export declare const useQuery: () => URLSearchParams;

package/framework/lib/shared/hooks/useQuery.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useQuery = void 0;
+const useLocation_1 = require("./useLocation");
+const useQuery = () => {
+    const { search } = (0, useLocation_1.useLocation)();
+    return new URLSearchParams(search);
+};
+exports.useQuery = useQuery;

package/framework/lib/shared/hooks/useRouter.d.ts

@@ -0,0 +1 @@
+export declare const useRouter: () => import("../context/RouterContext").RouterContextType;

package/framework/lib/shared/hooks/useRouter.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useRouter = void 0;
+const react_1 = require("react");
+const RouterContext_1 = require("../context/RouterContext");
+const useRouter = () => {
+    const context = (0, react_1.useContext)(RouterContext_1.RouterContext);
+    if (!context) {
+        throw new Error("useRouter must be used within an ArcanaJSApp");
+    }
+    return context;
+};
+exports.useRouter = useRouter;

package/framework/lib/shared/utils/createSingletonContext.d.ts

@@ -0,0 +1,11 @@
+import React from "react";
+/**
+ * Creates a React Context that persists across multiple module loads (Webpack bundles vs Node require).
+ * This is essential for SSR applications where the server bundle and dynamically loaded views
+ * might reference different instances of the "same" context module.
+ *
+ * @param key A unique string key to identify this context globally
+ * @param defaultValue The default value for the context
+ * @returns A React Context instance (singleton)
+ */
+export declare function createSingletonContext<T>(key: string, defaultValue: T): React.Context<T>;

package/framework/lib/shared/utils/createSingletonContext.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSingletonContext = createSingletonContext;
+const react_1 = require("react");
+/**
+ * Creates a React Context that persists across multiple module loads (Webpack bundles vs Node require).
+ * This is essential for SSR applications where the server bundle and dynamically loaded views
+ * might reference different instances of the "same" context module.
+ *
+ * @param key A unique string key to identify this context globally
+ * @param defaultValue The default value for the context
+ * @returns A React Context instance (singleton)
+ */
+function createSingletonContext(key, defaultValue) {
+    const globalAny = global;
+    const symbolKey = Symbol.for(`ARCANAJS_CONTEXT_${key}`);
+    if (!globalAny[symbolKey]) {
+        globalAny[symbolKey] = (0, react_1.createContext)(defaultValue);
+    }
+    return globalAny[symbolKey];
+}

package/framework/lib/shared/views/ErrorPage.d.ts

@@ -0,0 +1,7 @@
+interface ErrorPageProps {
+    message?: string;
+    statusCode?: number;
+    stack?: string;
+}
+export default function ErrorPage({ message, statusCode, stack, }: ErrorPageProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/framework/lib/shared/views/ErrorPage.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = ErrorPage;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const Body_1 = require("../components/Body");
+const Head_1 = require("../components/Head");
+const Link_1 = require("../components/Link");
+const Page_1 = require("../components/Page");
+function ErrorPage({ message = "Something went wrong", statusCode = 500, stack, }) {
+    const isDevelopment = process.env.NODE_ENV === "development";
+    return ((0, jsx_runtime_1.jsxs)(Page_1.Page, { children: [(0, jsx_runtime_1.jsxs)(Head_1.Head, { children: [(0, jsx_runtime_1.jsxs)("title", { children: [statusCode, " - Server Error"] }), (0, jsx_runtime_1.jsx)("meta", { name: "description", content: "An error occurred on the server" })] }), (0, jsx_runtime_1.jsx)(Body_1.Body, { children: (0, jsx_runtime_1.jsxs)("div", { className: "relative min-h-screen overflow-hidden bg-black text-white flex flex-col justify-center items-center px-4 font-sans", children: [(0, jsx_runtime_1.jsxs)("div", { className: "fixed inset-0 z-0 overflow-hidden pointer-events-none", children: [(0, jsx_runtime_1.jsx)("div", { className: "absolute inset-0 grid-pattern opacity-30" }), (0, jsx_runtime_1.jsx)("div", { className: "absolute top-1/4 right-1/4 w-96 h-96 bg-red-600 rounded-full opacity-20 blur-3xl animate-glow" }), (0, jsx_runtime_1.jsx)("div", { className: "absolute bottom-1/4 left-1/4 w-96 h-96 bg-orange-600 rounded-full opacity-10 blur-3xl animate-glow", style: { animationDelay: "2s" } }), (0, jsx_runtime_1.jsx)("div", { className: "absolute inset-0 hero-gradient" })] }), (0, jsx_runtime_1.jsxs)("div", { className: "relative z-10 max-w-2xl w-full text-center animate-scale-in", children: [(0, jsx_runtime_1.jsxs)("div", { className: "glass-card rounded-3xl p-12 border border-white/10 shadow-2xl", children: [(0, jsx_runtime_1.jsxs)("div", { className: "mb-8", children: [(0, jsx_runtime_1.jsx)("div", { className: "text-6xl mb-6 animate-float", children: (0, jsx_runtime_1.jsx)("span", { className: "text-red-500 drop-shadow-lg filter", children: "\u26A0\uFE0F" }) }), (0, jsx_runtime_1.jsx)("h1", { className: "text-8xl font-bold text-transparent bg-clip-text bg-gradient-to-br from-red-500 to-orange-500 mb-4", children: statusCode }), (0, jsx_runtime_1.jsx)("h2", { className: "text-3xl font-bold text-white mb-4", children: "Server Error" }), (0, jsx_runtime_1.jsx)("p", { className: "text-gray-400 text-lg leading-relaxed", children: message })] }), (0, jsx_runtime_1.jsxs)("div", { className: "flex flex-col sm:flex-row gap-4 justify-center mb-8", children: [(0, jsx_runtime_1.jsxs)(Link_1.Link, { href: "/", className: "btn-primary px-8 py-3.5 text-white font-semibold rounded-xl inline-flex items-center justify-center gap-2 w-full sm:w-auto bg-gradient-to-r from-red-600 to-orange-600 hover:from-red-500 hover:to-orange-500 border-none shadow-red-900/20", children: [(0, jsx_runtime_1.jsx)("svg", { className: "w-5 h-5", fill: "none", stroke: "currentColor", viewBox: "0 0 24 24", children: (0, jsx_runtime_1.jsx)("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: "M3 12l2-2m0 0l7-7 7 7M5 10v10a1 1 0 001 1h3m10-11l2 2m-2-2v10a1 1 0 01-1 1h-3m-6 0a1 1 0 001-1v-4a1 1 0 011-1h2a1 1 0 011 1v4a1 1 0 001 1m-6 0h6" }) }), "Go Home"] }), (0, jsx_runtime_1.jsxs)("button", { onClick: () => window.location.reload(), className: "btn-secondary px-8 py-3.5 text-white font-semibold rounded-xl inline-flex items-center justify-center gap-2 w-full sm:w-auto", children: [(0, jsx_runtime_1.jsx)("svg", { className: "w-5 h-5", fill: "none", stroke: "currentColor", viewBox: "0 0 24 24", children: (0, jsx_runtime_1.jsx)("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: "M4 4v5h.582m15.356 2A8.001 8.001 0 004.582 9m0 0H9m11 11v-5h-.581m0 0a8.003 8.003 0 01-15.357-2m15.357 2H15" }) }), "Try Again"] })] }), isDevelopment && stack && ((0, jsx_runtime_1.jsx)("div", { className: "mt-8 text-left animate-slide-up", children: (0, jsx_runtime_1.jsxs)("details", { className: "bg-black/40 border border-white/10 rounded-xl overflow-hidden group", children: [(0, jsx_runtime_1.jsxs)("summary", { className: "cursor-pointer font-medium text-gray-300 p-4 hover:bg-white/5 transition-colors flex items-center justify-between select-none", children: [(0, jsx_runtime_1.jsx)("span", { children: "Stack Trace (Development Only)" }), (0, jsx_runtime_1.jsx)("svg", { className: "w-5 h-5 text-gray-500 group-open:rotate-180 transition-transform", fill: "none", stroke: "currentColor", viewBox: "0 0 24 24", children: (0, jsx_runtime_1.jsx)("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: "M19 9l-7 7-7-7" }) })] }), (0, jsx_runtime_1.jsx)("pre", { className: "text-xs text-red-300/80 p-4 overflow-x-auto whitespace-pre-wrap font-mono border-t border-white/5 bg-black/20", children: stack })] }) }))] }), (0, jsx_runtime_1.jsxs)("div", { className: "mt-8 text-gray-500 text-sm", children: ["If this problem persists, please", " ", (0, jsx_runtime_1.jsx)(Link_1.Link, { href: "/contact", className: "text-red-400 hover:text-red-300 underline transition-colors", children: "contact support" }), "."] })] })] }) })] }));
+}

package/framework/lib/shared/views/NotFoundPage.d.ts

@@ -0,0 +1,5 @@
+interface NotFoundPageProps {
+    url?: string;
+}
+export default function NotFoundPage({ url }: NotFoundPageProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/framework/lib/shared/views/NotFoundPage.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = NotFoundPage;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const Body_1 = require("../components/Body");
+const Head_1 = require("../components/Head");
+const Link_1 = require("../components/Link");
+const Page_1 = require("../components/Page");
+function NotFoundPage({ url }) {
+    return ((0, jsx_runtime_1.jsxs)(Page_1.Page, { children: [(0, jsx_runtime_1.jsxs)(Head_1.Head, { children: [(0, jsx_runtime_1.jsx)("title", { children: "404 - Page Not Found" }), (0, jsx_runtime_1.jsx)("meta", { name: "description", content: "The page you're looking for doesn't exist" })] }), (0, jsx_runtime_1.jsx)(Body_1.Body, { children: (0, jsx_runtime_1.jsxs)("div", { className: "relative min-h-screen overflow-hidden bg-black text-white flex flex-col justify-center items-center px-4 font-sans", children: [(0, jsx_runtime_1.jsxs)("div", { className: "fixed inset-0 z-0 overflow-hidden pointer-events-none", children: [(0, jsx_runtime_1.jsx)("div", { className: "absolute inset-0 grid-pattern opacity-30" }), (0, jsx_runtime_1.jsx)("div", { className: "absolute top-1/4 left-1/4 w-96 h-96 bg-orange-500 rounded-full opacity-20 blur-3xl animate-glow" }), (0, jsx_runtime_1.jsx)("div", { className: "absolute bottom-1/4 right-1/4 w-96 h-96 bg-purple-500 rounded-full opacity-10 blur-3xl animate-glow", style: { animationDelay: "2s" } }), (0, jsx_runtime_1.jsx)("div", { className: "absolute inset-0 hero-gradient" })] }), (0, jsx_runtime_1.jsxs)("div", { className: "relative z-10 max-w-lg w-full text-center animate-scale-in", children: [(0, jsx_runtime_1.jsxs)("div", { className: "glass-card rounded-3xl p-12 border border-white/10 shadow-2xl", children: [(0, jsx_runtime_1.jsxs)("div", { className: "mb-8", children: [(0, jsx_runtime_1.jsx)("h1", { className: "text-9xl font-bold text-transparent bg-clip-text bg-gradient-to-br from-white to-gray-500 mb-4 animate-float", children: "404" }), (0, jsx_runtime_1.jsx)("h2", { className: "text-3xl font-bold text-white mb-4", children: "Page Not Found" }), (0, jsx_runtime_1.jsx)("p", { className: "text-gray-400 text-lg leading-relaxed", children: url ? ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: ["The page ", (0, jsx_runtime_1.jsxs)("span", { className: "text-orange-400", children: ["\"", url, "\""] }), " ", "you're looking for doesn't exist."] })) : ("The page you're looking for doesn't exist.") })] }), (0, jsx_runtime_1.jsxs)("div", { className: "flex flex-col sm:flex-row gap-4 justify-center", children: [(0, jsx_runtime_1.jsxs)(Link_1.Link, { href: "/", className: "btn-primary px-8 py-3.5 text-white font-semibold rounded-xl inline-flex items-center justify-center gap-2 w-full sm:w-auto", children: [(0, jsx_runtime_1.jsx)("svg", { className: "w-5 h-5", fill: "none", stroke: "currentColor", viewBox: "0 0 24 24", children: (0, jsx_runtime_1.jsx)("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: "M3 12l2-2m0 0l7-7 7 7M5 10v10a1 1 0 001 1h3m10-11l2 2m-2-2v10a1 1 0 01-1 1h-3m-6 0a1 1 0 001-1v-4a1 1 0 011-1h2a1 1 0 011 1v4a1 1 0 001 1m-6 0h6" }) }), "Go Home"] }), (0, jsx_runtime_1.jsxs)("button", { onClick: () => window.history.back(), className: "btn-secondary px-8 py-3.5 text-white font-semibold rounded-xl inline-flex items-center justify-center gap-2 w-full sm:w-auto", children: [(0, jsx_runtime_1.jsx)("svg", { className: "w-5 h-5", fill: "none", stroke: "currentColor", viewBox: "0 0 24 24", children: (0, jsx_runtime_1.jsx)("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: "M10 19l-7-7m0 0l7-7m-7 7h18" }) }), "Go Back"] })] })] }), (0, jsx_runtime_1.jsxs)("div", { className: "mt-8 text-gray-500 text-sm", children: ["If you believe this is an error, please", " ", (0, jsx_runtime_1.jsx)(Link_1.Link, { href: "/contact", className: "text-orange-400 hover:text-orange-300 underline transition-colors", children: "contact support" }), "."] })] })] }) })] }));
+}

package/framework/lib/types.d.ts

@@ -0,0 +1,174 @@
+/**
+ * ArcanaJS Framework - Centralized Type Definitions
+ *
+ * This file exports all public TypeScript types and interfaces
+ * for the ArcanaJS framework.
+ */
+export type { ArcanaJSConfig } from "./server/ArcanaJSServer";
+export type { ArcanaJSAppProps } from "./shared/core/ArcanaJSApp";
+export type { HeadManager } from "./shared/context/HeadContext";
+export type { RouterContextType } from "./shared/context/RouterContext";
+import type React from "react";
+/**
+ * Props for the Page component
+ */
+export interface PageProps {
+    data?: any;
+    children?: React.ReactNode;
+}
+/**
+ * Props for the Head component
+ */
+export interface HeadProps {
+    children?: React.ReactNode;
+}
+/**
+ * Props for the Body component
+ */
+export interface BodyProps {
+    children?: React.ReactNode;
+}
+/**
+ * Props for the Link component
+ */
+export interface LinkProps {
+    to: string;
+    children?: React.ReactNode;
+    className?: string;
+    [key: string]: any;
+}
+/**
+ * Props for the NavLink component
+ */
+export interface NavLinkProps extends LinkProps {
+    activeClassName?: string;
+}
+/**
+ * Return type for useRouter hook
+ */
+export interface UseRouterReturn {
+    navigateTo: (url: string) => void;
+    currentPage: string;
+    currentUrl: string;
+    params: Record<string, string>;
+    csrfToken?: string;
+}
+/**
+ * Return type for useParams hook
+ */
+export type UseParamsReturn = Record<string, string>;
+/**
+ * Return type for useLocation hook
+ */
+export interface UseLocationReturn {
+    pathname: string;
+    search: string;
+    hash: string;
+}
+/**
+ * Return type for useQuery hook
+ */
+export type UseQueryReturn = URLSearchParams;
+/**
+ * Return type for usePage hook
+ */
+export type UsePageReturn = any;
+/**
+ * Return type for useHead hook
+ */
+export interface UseHeadReturn {
+    push: (tags: React.ReactNode) => void;
+}
+/**
+ * View component type - a React functional component that can receive data and params
+ */
+export type ViewComponent<T = any> = React.FC<{
+    data?: T;
+    params?: Record<string, string>;
+    navigateTo?: (url: string) => void;
+}>;
+/**
+ * Views registry - maps view names to view components
+ */
+export type ViewsRegistry = Record<string, React.FC<any>>;
+/**
+ * Layout component type
+ */
+export type LayoutComponent = React.FC<{
+    children: React.ReactNode;
+}>;
+import type { RequestHandler } from "express";
+/**
+ * Controller class type
+ */
+export type ControllerClass = new (...args: any[]) => any;
+/**
+ * Route action - can be a handler function or a controller/method pair
+ */
+export type RouteAction = RequestHandler | [ControllerClass, string];
+/**
+ * User-facing configuration for ArcanaJS
+ */
+export interface ArcanaJSUserConfig {
+    /**
+     * Server configuration
+     */
+    server?: {
+        /**
+         * Port to run the server on
+         * @default 3000
+         */
+        port?: number | string;
+        /**
+         * Static files directory
+         * @default "public"
+         */
+        staticDir?: string;
+        /**
+         * Distribution directory for built assets
+         * @default "dist/public"
+         */
+        distDir?: string;
+    };
+    /**
+     * Build configuration
+     */
+    build?: {
+        /**
+         * Output directory for build
+         * @default "dist"
+         */
+        outDir?: string;
+        /**
+         * Enable source maps
+         * @default true in development, false in production
+         */
+        sourcemap?: boolean;
+        /**
+         * Enable minification
+         * @default true in production, false in development
+         */
+        minify?: boolean;
+    };
+    /**
+     * Views configuration
+     */
+    views?: {
+        /**
+         * Directory containing view files
+         * @default "src/views"
+         */
+        dir?: string;
+        /**
+         * Custom layout component
+         */
+        layout?: LayoutComponent;
+    };
+}
+/**
+ * Resolved internal configuration
+ */
+export interface ResolvedArcanaJSConfig extends Required<ArcanaJSUserConfig> {
+    root: string;
+    mode: "development" | "production";
+}

package/framework/lib/types.js

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * ArcanaJS Framework - Centralized Type Definitions
+ *
+ * This file exports all public TypeScript types and interfaces
+ * for the ArcanaJS framework.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/framework/templates/arcanajs.config.ts

@@ -0,0 +1,44 @@
+import { defineConfig } from "arcanajs/config";
+import type { ArcanaJSUserConfig } from "arcanajs/types";
+
+/**
+ * ArcanaJS Configuration
+ *
+ * This file defines the configuration for your ArcanaJS application.
+ *
+ * @see https://github.com/arcanajs/arcanajs for documentation
+ */
+export default defineConfig({
+  // Server configuration
+  server: {
+    // Port to run the server on
+    port: 3000,
+
+    // Static files directory
+    staticDir: "public",
+
+    // Distribution directory for built assets
+    distDir: "dist/public",
+  },
+
+  // Build configuration
+  build: {
+    // Output directory for build
+    outDir: "dist",
+
+    // Enable source maps (automatically set based on NODE_ENV)
+    // sourcemap: true,
+
+    // Enable minification (automatically set based on NODE_ENV)
+    // minify: true,
+  },
+
+  // Views configuration
+  views: {
+    // Directory containing view files
+    dir: "src/views",
+
+    // Custom layout component (optional)
+    // layout: undefined,
+  },
+} satisfies ArcanaJSUserConfig);

package/framework/templates/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "arcanajs-app",
+  "version": "1.0.0",
+  "private": true,
+  "scripts": {
+    "dev": "arcanajs dev",
+    "build": "arcanajs build",
+    "start": "arcanajs start"
+  },
+  "dependencies": {
+    "arcanajs": "^2.5.1",
+    "react": "^19.2.0",
+    "react-dom": "^19.2.0"
+  }
+}

package/framework/templates/postcss.config.js

@@ -0,0 +1,6 @@
+module.exports = {
+  plugins: {
+    "@tailwindcss/postcss": {},
+    autoprefixer: {},
+  },
+};