arcanajs 2.5.4 → 3.0.0

package/framework/cli/webpack.config.js

@@ -1,310 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createServerConfig = exports.createClientConfig = void 0;
-const clean_webpack_plugin_1 = require("clean-webpack-plugin");
-const html_webpack_plugin_1 = __importDefault(require("html-webpack-plugin"));
-const mini_css_extract_plugin_1 = __importDefault(require("mini-css-extract-plugin"));
-const path_1 = __importDefault(require("path"));
-const webpack_node_externals_1 = __importDefault(require("webpack-node-externals"));
-const cwd = process.cwd();
-// Helper to resolve loaders from the framework's node_modules
-const resolveLoader = (loader) => require.resolve(loader);
-const fs_1 = __importDefault(require("fs"));
-// Helper to find entry file with supported extensions
-const findEntry = (searchPaths) => {
-    const extensions = [".ts", ".tsx", ".js", ".jsx"];
-    for (const basePath of searchPaths) {
-        for (const ext of extensions) {
-            const fullPath = path_1.default.resolve(cwd, basePath + ext);
-            if (fs_1.default.existsSync(fullPath)) {
-                return fullPath;
-            }
-            // Also check for index files in directories
-            const indexPath = path_1.default.resolve(cwd, basePath, "index" + ext);
-            if (fs_1.default.existsSync(indexPath)) {
-                return indexPath;
-            }
-        }
-    }
-    // Fallback to example if not found (for internal framework dev) or throw error
-    // For now, we'll try the example paths as a last resort before failing
-    const exampleClient = path_1.default.resolve(cwd, "src/example/client/index.tsx");
-    const exampleServer = path_1.default.resolve(cwd, "src/example/server/index.ts");
-    if (searchPaths.some((p) => p.includes("client")) &&
-        fs_1.default.existsSync(exampleClient))
-        return exampleClient;
-    if (searchPaths.some((p) => p.includes("server")) &&
-        fs_1.default.existsSync(exampleServer))
-        return exampleServer;
-    throw new Error(`Could not find entry point. Searched in: ${searchPaths.join(", ")}`);
-};
-const getViewsLoaderPath = () => {
-    const viewsDir = path_1.default.resolve(cwd, "src/views");
-    const hasViews = fs_1.default.existsSync(viewsDir);
-    const viewsLoaderPath = path_1.default.resolve(__dirname, "../../node_modules/.cache/arcanajs/views-loader.js");
-    // Ensure cache directory exists
-    const cacheDir = path_1.default.dirname(viewsLoaderPath);
-    if (!fs_1.default.existsSync(cacheDir)) {
-        fs_1.default.mkdirSync(cacheDir, { recursive: true });
-    }
-    // Generate the loader file
-    const loaderContent = hasViews
-        ? `module.exports = require.context('${viewsDir}', true, /\\.(tsx|jsx)$/);`
-        : `module.exports = null;`;
-    fs_1.default.writeFileSync(viewsLoaderPath, loaderContent);
-    return viewsLoaderPath;
-};
-const createClientConfig = () => {
-    const isProduction = process.env.NODE_ENV === "production";
-    const viewsLoaderPath = getViewsLoaderPath();
-    const clientEntry = findEntry([
-        "src/client",
-        "src/client/index",
-        "src/index",
-        "src/main",
-    ]);
-    return {
-        mode: isProduction ? "production" : "development",
-        target: "web",
-        entry: {
-            client: clientEntry,
-        },
-        output: {
-            path: path_1.default.resolve(cwd, "dist/public"),
-            filename: isProduction
-                ? "[name].[contenthash].bundle.js"
-                : "[name].bundle.js",
-            publicPath: "/",
-            assetModuleFilename: "assets/[hash][ext][query]",
-        },
-        resolve: {
-            extensions: [".ts", ".tsx", ".js", ".jsx"],
-            alias: {
-                "arcana-views": viewsLoaderPath,
-            },
-        },
-        resolveLoader: {
-            modules: ["node_modules", path_1.default.resolve(__dirname, "../../node_modules")],
-        },
-        module: {
-            rules: [
-                {
-                    test: /\.(ts|tsx|js|jsx)$/,
-                    exclude: /node_modules/,
-                    use: {
-                        loader: resolveLoader("babel-loader"),
-                        options: {
-                            presets: [
-                                resolveLoader("@babel/preset-env"),
-                                [
-                                    resolveLoader("@babel/preset-react"),
-                                    { runtime: "automatic" },
-                                ],
-                                resolveLoader("@babel/preset-typescript"),
-                            ],
-                        },
-                    },
-                },
-                // CSS Modules rule for .module.css files
-                {
-                    test: /\.module\.css$/,
-                    use: [
-                        isProduction
-                            ? mini_css_extract_plugin_1.default.loader
-                            : resolveLoader("style-loader"),
-                        {
-                            loader: resolveLoader("css-loader"),
-                            options: {
-                                importLoaders: 1,
-                                modules: {
-                                    localIdentName: isProduction
-                                        ? "[hash:base64:8]"
-                                        : "[path][name]__[local]--[hash:base64:5]",
-                                    exportLocalsConvention: "camelCaseOnly",
-                                },
-                            },
-                        },
-                        {
-                            loader: resolveLoader("postcss-loader"),
-                            options: {
-                                postcssOptions: {
-                                    config: path_1.default.resolve(cwd, "postcss.config.js"),
-                                },
-                            },
-                        },
-                    ],
-                },
-                // Global CSS rule for regular .css files
-                {
-                    test: /\.css$/,
-                    exclude: /\.module\.css$/,
-                    use: [
-                        isProduction
-                            ? mini_css_extract_plugin_1.default.loader
-                            : resolveLoader("style-loader"),
-                        {
-                            loader: resolveLoader("css-loader"),
-                            options: {
-                                importLoaders: 1,
-                            },
-                        },
-                        {
-                            loader: resolveLoader("postcss-loader"),
-                            options: {
-                                postcssOptions: {
-                                    config: path_1.default.resolve(cwd, "postcss.config.js"),
-                                },
-                            },
-                        },
-                    ],
-                },
-                {
-                    test: /\.(png|jpg|jpeg|gif|svg|woff|woff2|eot|ttf|otf)$/i,
-                    type: "asset/resource",
-                },
-            ],
-        },
-        plugins: [
-            new clean_webpack_plugin_1.CleanWebpackPlugin(),
-            new html_webpack_plugin_1.default({
-                template: path_1.default.resolve(__dirname, "../lib/server/default-index.html"),
-                filename: "index.html",
-                inject: "body",
-                minify: isProduction
-                    ? {
-                        removeComments: false,
-                        collapseWhitespace: true,
-                        removeRedundantAttributes: true,
-                        useShortDoctype: true,
-                        removeEmptyAttributes: true,
-                        removeStyleLinkTypeAttributes: true,
-                        keepClosingSlash: true,
-                        minifyJS: true,
-                        minifyCSS: true,
-                        minifyURLs: true,
-                    }
-                    : false,
-            }),
-            new mini_css_extract_plugin_1.default({
-                filename: isProduction ? "[name].[contenthash].css" : "[name].css",
-            }),
-        ],
-        optimization: {
-            splitChunks: {
-                chunks: "all",
-                cacheGroups: {
-                    defaultVendors: {
-                        test: /[\\/]node_modules[\\/]/,
-                        priority: -10,
-                        reuseExistingChunk: true,
-                    },
-                    default: {
-                        minChunks: 2,
-                        priority: -20,
-                        reuseExistingChunk: true,
-                    },
-                    react: {
-                        test: /[\\/]node_modules[\\/](react|react-dom|scheduler)[\\/]/,
-                        name: "react-vendor",
-                        chunks: "all",
-                        priority: 10,
-                    },
-                },
-            },
-        },
-        performance: {
-            maxEntrypointSize: 512000,
-            maxAssetSize: 512000,
-            hints: isProduction ? "warning" : false,
-        },
-        devtool: isProduction ? "source-map" : "eval-source-map",
-    };
-};
-exports.createClientConfig = createClientConfig;
-const createServerConfig = () => {
-    const isProduction = process.env.NODE_ENV === "production";
-    const serverEntry = findEntry([
-        "src/server",
-        "src/server/index",
-        "src/server/main",
-    ]);
-    const viewsLoaderPath = getViewsLoaderPath();
-    return {
-        mode: isProduction ? "production" : "development",
-        target: "node",
-        entry: serverEntry,
-        output: {
-            path: path_1.default.resolve(cwd, "dist"),
-            filename: "server.js",
-        },
-        externals: [
-            (0, webpack_node_externals_1.default)({
-                allowlist: [/^arcanajs/],
-            }),
-        ],
-        resolve: {
-            extensions: [".ts", ".tsx", ".js", ".jsx"],
-            alias: {
-                "arcana-views": viewsLoaderPath,
-            },
-        },
-        resolveLoader: {
-            modules: ["node_modules", path_1.default.resolve(__dirname, "../../node_modules")],
-        },
-        module: {
-            rules: [
-                {
-                    test: /\.(ts|tsx|js|jsx)$/,
-                    exclude: /node_modules/,
-                    use: {
-                        loader: resolveLoader("babel-loader"),
-                        options: {
-                            presets: [
-                                resolveLoader("@babel/preset-env"),
-                                [
-                                    resolveLoader("@babel/preset-react"),
-                                    { runtime: "automatic" },
-                                ],
-                                resolveLoader("@babel/preset-typescript"),
-                            ],
-                        },
-                    },
-                },
-                // CSS Modules rule for .module.css files on server (for SSR)
-                {
-                    test: /\.module\.css$/,
-                    use: {
-                        loader: resolveLoader("css-loader"),
-                        options: {
-                            modules: {
-                                localIdentName: isProduction
-                                    ? "[hash:base64:8]"
-                                    : "[path][name]__[local]--[hash:base64:5]",
-                                exportLocalsConvention: "camelCaseOnly",
-                                exportOnlyLocals: true, // Only export class names, not CSS
-                            },
-                        },
-                    },
-                },
-                // Regular CSS files - ignore on server side
-                {
-                    test: /\.css$/,
-                    exclude: /\.module\.css$/,
-                    use: resolveLoader("null-loader"),
-                },
-                {
-                    test: /\.(png|jpg|jpeg|gif|svg|woff|woff2|eot|ttf|otf)$/i,
-                    type: "asset/resource",
-                    generator: {
-                        emit: false,
-                    },
-                },
-            ],
-        },
-        devtool: isProduction ? "source-map" : "eval-source-map",
-    };
-};
-exports.createServerConfig = createServerConfig;

package/framework/lib/client/index.js

@@ -1,97 +0,0 @@
-"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 jsx_runtime_1 = require("react/jsx-runtime");
-const client_1 = require("react-dom/client");
-const HeadContext_1 = require("../shared/context/HeadContext");
-const ArcanaJSApp_1 = require("../shared/core/ArcanaJSApp");
-const ErrorPage_1 = __importDefault(require("../shared/views/ErrorPage"));
-const NotFoundPage_1 = __importDefault(require("../shared/views/NotFoundPage"));
-// ============================================================================
-// Client Hydration Function
-// ============================================================================
-/**
- * Hydrate the ArcanaJS application on the client side
- *
- * This function initializes the React application on the client,
- * hydrating the server-rendered HTML with client-side interactivity.
- *
- * @param viewsOrContext - Either a views registry object or a webpack require.context
- * @param layout - Optional layout component to wrap all pages
- * @param options - Optional navigation configuration options
- *
- * @example
- * ```typescript
- * // Using webpack require.context (recommended)
- * import { hydrateArcanaJS } from 'arcanajs/client';
- *
- * const views = require.context('./views', false, /\.tsx$/);
- * hydrateArcanaJS(views);
- * ```
- *
- * @example
- * ```typescript
- * // Using manual views registry
- * import { hydrateArcanaJS } from 'arcanajs/client';
- * import HomePage from './views/HomePage';
- * import AboutPage from './views/AboutPage';
- *
- * hydrateArcanaJS({
- *   HomePage,
- *   AboutPage,
- * });
- * ```
- *
- * @example
- * ```typescript
- * // With navigation options
- * import { hydrateArcanaJS } from 'arcanajs/client';
- *
- * const views = require.context('./views', false, /\.tsx$/);
- * hydrateArcanaJS(views, undefined, {
- *   onNavigate: (url) => {
- *     // Track page views
- *     gtag('event', 'page_view', { page_path: url });
- *   }
- * });
- * ```
- */
-const hydrateArcanaJS = (viewsOrContext, layout, options) => {
-    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;
-    }
-    // Add default error views if not present
-    if (!views["NotFoundPage"]) {
-        views["NotFoundPage"] = NotFoundPage_1.default;
-    }
-    if (!views["ErrorPage"]) {
-        views["ErrorPage"] = ErrorPage_1.default;
-    }
-    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, (0, jsx_runtime_1.jsx)(HeadContext_1.HeadContext.Provider, { value: headManager, children: (0, jsx_runtime_1.jsx)(ArcanaJSApp_1.ArcanaJSApp, { initialPage: page, initialData: data, initialParams: params, csrfToken: csrfToken, views: views, layout: layout, onNavigate: options?.onNavigate || (() => { }) }) }));
-        }
-        catch (e) {
-            console.error("Failed to parse initial data", e);
-        }
-    }
-};
-exports.hydrateArcanaJS = hydrateArcanaJS;

package/framework/lib/config/index.d.ts

@@ -1,46 +0,0 @@
-/**
- * ArcanaJS Configuration System
- *
- * Provides utilities for loading and validating ArcanaJS configuration files.
- */
-import type { ArcanaJSUserConfig, ResolvedArcanaJSConfig } from "../types";
-/**
- * Define a configuration object with type safety
- *
- * @example
- * ```typescript
- * export default defineConfig({
- *   server: {
- *     port: 3000,
- *   },
- * });
- * ```
- */
-export declare function defineConfig(config: ArcanaJSUserConfig): ArcanaJSUserConfig;
-/**
- * Load ArcanaJS configuration from project root
- *
- * Searches for:
- * - arcanajs.config.js
- * - arcanajs.config.ts
- * - arcanajs.config.mjs
- *
- * @param root - Project root directory (defaults to process.cwd())
- * @returns User configuration object or empty object if not found
- */
-export declare function loadConfig(root?: string): Promise<ArcanaJSUserConfig>;
-/**
- * Resolve user configuration with defaults
- *
- * @param userConfig - User-provided configuration
- * @param root - Project root directory
- * @returns Fully resolved configuration with all defaults applied
- */
-export declare function resolveConfig(userConfig: ArcanaJSUserConfig, root?: string): ResolvedArcanaJSConfig;
-/**
- * Load and resolve configuration in one step
- *
- * @param root - Project root directory
- * @returns Fully resolved configuration
- */
-export declare function loadAndResolveConfig(root?: string): Promise<ResolvedArcanaJSConfig>;

package/framework/lib/config/index.js

@@ -1,115 +0,0 @@
-"use strict";
-/**
- * ArcanaJS Configuration System
- *
- * Provides utilities for loading and validating ArcanaJS configuration files.
- */
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.defineConfig = defineConfig;
-exports.loadConfig = loadConfig;
-exports.resolveConfig = resolveConfig;
-exports.loadAndResolveConfig = loadAndResolveConfig;
-const fs_1 = __importDefault(require("fs"));
-const path_1 = __importDefault(require("path"));
-/**
- * Define a configuration object with type safety
- *
- * @example
- * ```typescript
- * export default defineConfig({
- *   server: {
- *     port: 3000,
- *   },
- * });
- * ```
- */
-function defineConfig(config) {
-    return config;
-}
-/**
- * Load ArcanaJS configuration from project root
- *
- * Searches for:
- * - arcanajs.config.js
- * - arcanajs.config.ts
- * - arcanajs.config.mjs
- *
- * @param root - Project root directory (defaults to process.cwd())
- * @returns User configuration object or empty object if not found
- */
-async function loadConfig(root = process.cwd()) {
-    const configFiles = [
-        "arcanajs.config.js",
-        "arcanajs.config.ts",
-        "arcanajs.config.mjs",
-    ];
-    for (const configFile of configFiles) {
-        const configPath = path_1.default.resolve(root, configFile);
-        if (fs_1.default.existsSync(configPath)) {
-            try {
-                // For TypeScript files, we need ts-node or tsx
-                if (configFile.endsWith(".ts")) {
-                    try {
-                        require("tsx/cjs");
-                    }
-                    catch {
-                        try {
-                            require("ts-node/register");
-                        }
-                        catch {
-                            console.warn(`Found ${configFile} but ts-node/tsx is not available. Skipping.`);
-                            continue;
-                        }
-                    }
-                }
-                const config = require(configPath);
-                return config.default || config;
-            }
-            catch (error) {
-                console.error(`Error loading config from ${configPath}:`, error);
-            }
-        }
-    }
-    return {};
-}
-/**
- * Resolve user configuration with defaults
- *
- * @param userConfig - User-provided configuration
- * @param root - Project root directory
- * @returns Fully resolved configuration with all defaults applied
- */
-function resolveConfig(userConfig, root = process.cwd()) {
-    const mode = process.env.NODE_ENV || "development";
-    return {
-        root,
-        mode,
-        server: {
-            port: userConfig.server?.port || process.env.PORT || 3000,
-            staticDir: userConfig.server?.staticDir || "public",
-            distDir: userConfig.server?.distDir || "dist/public",
-        },
-        build: {
-            outDir: userConfig.build?.outDir || "dist",
-            sourcemap: userConfig.build?.sourcemap ?? mode === "development",
-            minify: userConfig.build?.minify ?? mode === "production",
-        },
-        views: {
-            dir: userConfig.views?.dir || "src/views",
-            layout: userConfig.views?.layout,
-        },
-    };
-}
-/**
- * Load and resolve configuration in one step
- *
- * @param root - Project root directory
- * @returns Fully resolved configuration
- */
-async function loadAndResolveConfig(root = process.cwd()) {
-    const userConfig = await loadConfig(root);
-    return resolveConfig(userConfig, root);
-}

package/framework/lib/index.d.ts

@@ -1,19 +0,0 @@
-/// <reference path="./global.d.ts" />
-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/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";
-export { default as ErrorPage } from "./shared/views/ErrorPage";
-export { default as NotFoundPage } from "./shared/views/NotFoundPage";
-export * from "./types";

package/framework/lib/index.js

@@ -1,59 +0,0 @@
-"use strict";
-/// <reference path="./global.d.ts" />
-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);
-};
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.NotFoundPage = exports.ErrorPage = void 0;
-// ============================================================================
-// Component 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);
-// ============================================================================
-// Context Exports
-// ============================================================================
-__exportStar(require("./shared/context/HeadContext"), exports);
-__exportStar(require("./shared/context/PageContext"), exports);
-__exportStar(require("./shared/context/RouterContext"), exports);
-// ============================================================================
-// Core Exports
-// ============================================================================
-__exportStar(require("./shared/core/ArcanaJSApp"), exports);
-// ============================================================================
-// Hook 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);
-// ============================================================================
-// Default Error Views
-// ============================================================================
-var ErrorPage_1 = require("./shared/views/ErrorPage");
-Object.defineProperty(exports, "ErrorPage", { enumerable: true, get: function () { return __importDefault(ErrorPage_1).default; } });
-var NotFoundPage_1 = require("./shared/views/NotFoundPage");
-Object.defineProperty(exports, "NotFoundPage", { enumerable: true, get: function () { return __importDefault(NotFoundPage_1).default; } });
-// ============================================================================
-// Type Exports
-// ============================================================================
-__exportStar(require("./types"), exports);