arcanajs 2.2.1 → 2.3.0

package/framework/cli/templates.js

@@ -3,6 +3,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.requiredDirs = exports.errorPages = exports.configFiles = void 0;
 exports.configFiles = [
     { src: "package.json", dest: "package.json" },
+    { src: "tsconfig.json", dest: "tsconfig.json" },
+    { src: "arcanajs.d.ts", dest: "src/arcanajs.d.ts" },
     { src: "postcss.config.js", dest: "postcss.config.js" },
     { src: "globals.css", dest: "src/client/globals.css" },
     { src: "client-index.tsx", dest: "src/client/index.tsx" },

package/framework/cli/webpack.config.js

@@ -108,8 +108,39 @@ const createClientConfig = () => {
                         },
                     },
                 },
+                // 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
@@ -242,9 +273,27 @@ const createServerConfig = () => {
                         },
                     },
                 },
+                // 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$/,
-                    use: resolveLoader("null-loader"), // Ignore CSS on server side
+                    exclude: /\.module\.css$/,
+                    use: resolveLoader("null-loader"),
                 },
                 {
                     test: /\.(png|jpg|jpeg|gif|svg|woff|woff2|eot|ttf|otf)$/i,
@@ -255,7 +304,7 @@ const createServerConfig = () => {
                 },
             ],
         },
-        // devtool: isProduction ? "source-map" : "eval-source-map",
+        devtool: isProduction ? "source-map" : "eval-source-map",
     };
 };
 exports.createServerConfig = createServerConfig;

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

@@ -1,2 +1,34 @@
 import React from "react";
+export type { LayoutComponent, ViewsRegistry } from "../types";
+/**
+ * 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
+ *
+ * @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,
+ * });
+ * ```
+ */
 export declare const hydrateArcanaJS: (viewsOrContext: Record<string, React.FC<any>> | any, layout?: React.FC<any>) => void;

package/framework/lib/client/index.js

@@ -10,6 +10,40 @@ 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
+ *
+ * @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,
+ * });
+ * ```
+ */
 const hydrateArcanaJS = (viewsOrContext, layout) => {
     let views = {};
     if (viewsOrContext.keys && typeof viewsOrContext.keys === "function") {

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

@@ -0,0 +1,46 @@
+/**
+ * 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

@@ -0,0 +1,115 @@
+"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/global.d.ts

@@ -1,3 +1,63 @@
+// ============================================================================
+// Webpack Global Variables
+// ============================================================================
+
 declare var __non_webpack_require__: NodeRequire;
 
+// ============================================================================
+// CSS Module Declarations
+// ============================================================================
+
+// Global CSS files
 declare module "*.css";
+
+// CSS Modules
+declare module "*.module.css" {
+  const classes: { readonly [key: string]: string };
+  export default classes;
+}
+
+// ============================================================================
+// Express Augmentation
+// ============================================================================
+
+declare global {
+  namespace Express {
+    interface Response {
+      /**
+       * Render a page component with data
+       * @param page - Name of the page component to render
+       * @param data - Data to pass to the page component
+       */
+      renderPage(page: string, data?: any): void;
+
+      /**
+       * Send a success JSON response
+       * @param data - Data to send in the response
+       * @param message - Optional success message
+       * @param status - HTTP status code (default: 200)
+       */
+      success(
+        data?: string | object | null,
+        message?: string,
+        status?: number
+      ): Response;
+
+      /**
+       * Send an error JSON response
+       * @param message - Error message
+       * @param status - HTTP status code (default: 500)
+       * @param error - Error details
+       * @param data - Additional error data
+       */
+      error(
+        message?: string,
+        status?: number,
+        error?: string | object | null,
+        data?: string | object | null
+      ): Response;
+    }
+  }
+}
+
+export {};

package/framework/lib/index.d.ts

@@ -15,3 +15,4 @@ 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,4 +1,7 @@
 "use strict";
+// ============================================================================
+// Component Exports
+// ============================================================================
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     var desc = Object.getOwnPropertyDescriptor(m, k);
@@ -23,18 +26,33 @@ __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
+// ============================================================================
+// 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);

package/framework/lib/server/ArcanaJSServer.js

@@ -131,9 +131,9 @@ class ArcanaJSServer {
                     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;
+                        const requireFunc = typeof globalThis.__non_webpack_require__ !== "undefined"
+                            ? globalThis.__non_webpack_require__
+                            : require;
                         // Register ts-node if needed
                         if (file.endsWith(".tsx") || file.endsWith(".ts")) {
                             try {

package/framework/lib/server.d.ts

@@ -4,13 +4,29 @@ export * from "./server/ArcanaJSMiddleware";
 export * from "./server/ArcanaJSServer";
 export { default as ControllerBinder } from "./server/ControllerBinder";
 export * from "./server/DynamicRouter";
-export * from "./server/ResponseHandlerMiddleware";
 export * from "./server/Router";
 export { default as Route } from "./server/Router";
+export * from "./server/CsrfMiddleware";
+export * from "./server/ResponseHandlerMiddleware";
 /**
  * Create an ArcanaJS server with the given Express app
- * @param app Express application instance
- * @param config Optional ArcanaJS configuration
+ *
+ * @param app - Express application instance
+ * @param config - Optional ArcanaJS configuration
  * @returns ArcanaJSServer instance
+ *
+ * @example
+ * ```typescript
+ * import express from 'express';
+ * import { createArcanaServer } from 'arcanajs/server';
+ *
+ * const app = express();
+ * const server = createArcanaServer(app, {
+ *   port: 3000,
+ *   viewsDir: 'src/views',
+ * });
+ *
+ * server.start();
+ * ```
  */
 export declare function createArcanaServer(app: Express, config?: Partial<ArcanaJSConfig>): ArcanaJSServer;

package/framework/lib/server.js

@@ -20,20 +20,48 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Route = exports.ControllerBinder = void 0;
 exports.createArcanaServer = createArcanaServer;
 const ArcanaJSServer_1 = require("./server/ArcanaJSServer");
+// ============================================================================
+// Server Core Exports
+// ============================================================================
 __exportStar(require("./server/ArcanaJSMiddleware"), exports);
 __exportStar(require("./server/ArcanaJSServer"), exports);
 var ControllerBinder_1 = require("./server/ControllerBinder");
 Object.defineProperty(exports, "ControllerBinder", { enumerable: true, get: function () { return __importDefault(ControllerBinder_1).default; } });
+// ============================================================================
+// Routing Exports
+// ============================================================================
 __exportStar(require("./server/DynamicRouter"), exports);
-__exportStar(require("./server/ResponseHandlerMiddleware"), exports);
 __exportStar(require("./server/Router"), exports);
 var Router_1 = require("./server/Router");
 Object.defineProperty(exports, "Route", { enumerable: true, get: function () { return __importDefault(Router_1).default; } });
+// ============================================================================
+// Middleware Exports
+// ============================================================================
+__exportStar(require("./server/CsrfMiddleware"), exports);
+__exportStar(require("./server/ResponseHandlerMiddleware"), exports);
+// ============================================================================
+// Server Factory Function
+// ============================================================================
 /**
  * Create an ArcanaJS server with the given Express app
- * @param app Express application instance
- * @param config Optional ArcanaJS configuration
+ *
+ * @param app - Express application instance
+ * @param config - Optional ArcanaJS configuration
  * @returns ArcanaJSServer instance
+ *
+ * @example
+ * ```typescript
+ * import express from 'express';
+ * import { createArcanaServer } from 'arcanajs/server';
+ *
+ * const app = express();
+ * const server = createArcanaServer(app, {
+ *   port: 3000,
+ *   viewsDir: 'src/views',
+ * });
+ *
+ * server.start();
+ * ```
  */
 function createArcanaServer(app, config) {
     const server = new ArcanaJSServer_1.ArcanaJSServer({ ...config });

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/HomePage.tsx

@@ -298,13 +298,13 @@ export default function HomePage() {
                       </div>
                       <div className="text-white">npm run dev</div>
                     </div>
-                    <div>
+                    <div className="mb-4">
                       <div className="text-gray-500 mb-1">
                         # Build for production
                       </div>
                       <div className="text-white">npm run build</div>
                     </div>
-                    <div>
+                    <div className="mb-4">  
                       <div className="text-gray-500 mb-1">
                         # Start production server
                       </div>

package/framework/templates/arcanajs.config.js

@@ -0,0 +1,41 @@
+/**
+ * ArcanaJS Configuration Template
+ *
+ * This file defines the configuration for your ArcanaJS application.
+ *
+ * @type {import('arcanajs').ArcanaJSUserConfig}
+ */
+export default {
+  // 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,
+  },
+};

package/framework/templates/arcanajs.d.ts

@@ -0,0 +1,10 @@
+declare var __non_webpack_require__: NodeRequire;
+
+// Global CSS files
+declare module "*.css";
+
+// CSS Modules
+declare module "*.module.css" {
+  const classes: { readonly [key: string]: string };
+  export default classes;
+}

package/framework/templates/package.json

@@ -8,7 +8,7 @@
     "start": "arcanajs start"
   },
   "dependencies": {
-    "arcanajs": "^2.2.1",
+    "arcanajs": "^2.3.0",
     "react": "^19.2.0",
     "react-dom": "^19.2.0"
   }

package/framework/templates/server-index.ts

@@ -1,10 +1,11 @@
 import { ArcanaJSServer } from "arcanajs/server";
 import webRoutes from "./routes/web";
 
+const PORT = process.env.PORT || 3000;
+
 const server = new ArcanaJSServer({
+  port: PORT,
   routes: webRoutes,
 });
 
-const PORT = process.env.PORT || 3000;
-
 server.start();

package/framework/templates/tsconfig.json

@@ -0,0 +1,27 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "useDefineForClassFields": true,
+    "lib": ["ES2020", "DOM", "DOM.Iterable"],
+    "module": "ESNext",
+    "skipLibCheck": true,
+    "esModuleInterop": true,
+    "allowSyntheticDefaultImports": true,
+
+    /* Bundler mode */
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "noEmit": true,
+    "jsx": "react-jsx",
+
+    /* Linting */
+    "strict": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noFallthroughCasesInSwitch": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arcanajs",
-  "version": "2.2.1",
+  "version": "2.3.0",
   "description": "ArcanaJS Framework",
   "main": "framework/lib/index.js",
   "types": "framework/lib/index.d.ts",
@@ -16,7 +16,16 @@
     "./client": {
       "types": "./framework/lib/client/index.d.ts",
       "default": "./framework/lib/client/index.js"
-    }
+    },
+    "./types": {
+      "types": "./framework/lib/types.d.ts",
+      "default": "./framework/lib/types.js"
+    },
+    "./config": {
+      "types": "./framework/lib/config/index.d.ts",
+      "default": "./framework/lib/config/index.js"
+    },
+    "./package.json": "./package.json"
   },
   "bin": {
     "arcanajs": "./bin/arcanajs.js"
@@ -26,7 +35,7 @@
     "bin"
   ],
   "scripts": {
-    "build": "tsc -p tsconfig.json && cp src/lib/server/default-index.html framework/lib/server/ && cp src/lib/global.d.ts framework/lib/ && cp -r src/templates framework/"
+    "build": "tsc -p tsconfig.json && cp src/lib/server/default-index.html framework/lib/server/ && cp src/lib/global.d.ts framework/lib/ && cp -r src/templates framework/ && cp src/templates/arcanajs.config.js framework/templates/"
   },
   "dependencies": {
     "@babel/core": "^7.23.0",