arcanajs 5.1.0 → 6.0.0

package/dist/cli/ArcanaJSBuild.d.ts

@@ -0,0 +1,88 @@
+export interface BuildOptions {
+    /** Enable verbose output */
+    verbose?: boolean;
+    /** Clean output before build */
+    clean?: boolean;
+    /** Analyze bundle (production only) */
+    analyze?: boolean;
+}
+/**
+ * ArcanaJS Build System
+ * Professional build system inspired by Next.js
+ */
+export declare class ArcanaJSBuild {
+    private cwd;
+    private serverProcess;
+    private wss;
+    private hmrPort;
+    private isServerBuilding;
+    private isClientBuilding;
+    private pendingReload;
+    private pendingCSSUpdate;
+    private buildStartTime;
+    private lastReloadTime;
+    private reloadDebounceMs;
+    private heartbeatInterval;
+    constructor(cwd?: string);
+    /**
+     * Production build - optimized and minified
+     */
+    build(options?: BuildOptions): Promise<void>;
+    /**
+     * Development mode with HMR and watch
+     */
+    dev(options?: BuildOptions): Promise<void>;
+    /**
+     * Start production server
+     */
+    start(): Promise<void>;
+    /**
+     * Clean build directory
+     */
+    private cleanBuildDir;
+    /**
+     * Watch compiler with callbacks
+     */
+    private watchCompiler;
+    /**
+     * Check if build only has CSS changes (no JS/TS changes)
+     */
+    private isCSSOnlyChange;
+    /**
+     * Setup HMR WebSocket server
+     */
+    private setupHMR;
+    /**
+     * Create WebSocket server with heartbeat
+     */
+    private createWSS;
+    /**
+     * Start heartbeat interval to detect dead connections
+     */
+    private startHeartbeat;
+    /**
+     * Broadcast build status to all connected clients
+     */
+    private broadcastBuildStatus;
+    /**
+     * Broadcast reload to all connected clients (debounced)
+     */
+    private broadcastReload;
+    /**
+     * Broadcast CSS update to all connected clients (no full reload)
+     */
+    private broadcastCSSUpdate;
+    /**
+     * Start development server
+     */
+    private startDevServer;
+    /**
+     * Start a new dev server process
+     */
+    private startNewDevServer;
+    /**
+     * Setup graceful shutdown handlers
+     */
+    private setupShutdownHandlers;
+}
+export default ArcanaJSBuild;

package/dist/cli/webpack-utils/entries.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Find entry file with supported extensions
+ */
+export declare function findEntry(searchPaths: string[]): string;
+/**
+ * Generate views loader for webpack context
+ */
+export declare function generateViewsLoader(): string;
+/**
+ * Get HMR client path if available
+ */
+export declare function getHmrClientPath(): string | null;
+/**
+ * Get client entry points
+ */
+export declare function getClientEntries(isProduction: boolean): Record<string, string>;
+/**
+ * Get server entry point
+ */
+export declare function getServerEntry(): string;
+/**
+ * Get common aliases for webpack resolve
+ */
+export declare function getCommonAliases(viewsLoaderPath: string): Record<string, string>;

package/dist/cli/webpack-utils/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./entries";
+export * from "./loaders";
+export * from "./optimization";
+export * from "./plugins";

package/dist/cli/webpack-utils/loaders.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Helper to resolve loaders from the framework's node_modules
+ */
+export declare const resolveLoader: (loader: string) => string;
+/**
+ * Creates babel loader options optimized for performance
+ */
+export declare function createBabelLoaderOptions(isProduction: boolean): {
+    presets: (string | (string | {
+        useBuiltIns: boolean;
+        modules: boolean;
+    })[] | (string | {
+        runtime: string;
+    })[])[];
+    plugins: (string | (string | {
+        legacy: boolean;
+    })[] | (string | {
+        loose: boolean;
+    })[])[];
+    cacheDirectory: boolean;
+    cacheCompression: boolean;
+    compact: boolean;
+};
+/**
+ * Creates the TypeScript/JavaScript rule
+ */
+export declare function createTsRule(isProduction: boolean): {
+    test: RegExp;
+    include: string[];
+    exclude: RegExp[];
+    use: {
+        loader: string;
+        options: {
+            presets: (string | (string | {
+                useBuiltIns: boolean;
+                modules: boolean;
+            })[] | (string | {
+                runtime: string;
+            })[])[];
+            plugins: (string | (string | {
+                legacy: boolean;
+            })[] | (string | {
+                loose: boolean;
+            })[])[];
+            cacheDirectory: boolean;
+            cacheCompression: boolean;
+            compact: boolean;
+        };
+    };
+};
+/**
+ * Creates CSS module rule for client with HMR support
+ */
+export declare function createCssModuleRule(isProduction: boolean): {
+    test: RegExp;
+    use: any[];
+};
+/**
+ * Creates global CSS rule for client with HMR support
+ */
+export declare function createGlobalCssRule(isProduction: boolean): {
+    test: RegExp;
+    exclude: RegExp;
+    use: any[];
+};
+/**
+ * Creates CSS rules for server-side rendering
+ */
+export declare function createServerCssRules(isProduction: boolean): ({
+    test: RegExp;
+    use: {
+        loader: string;
+        options: {
+            modules: {
+                localIdentName: string;
+                exportLocalsConvention: string;
+                exportOnlyLocals: boolean;
+            };
+        };
+    };
+    exclude?: undefined;
+} | {
+    test: RegExp;
+    exclude: RegExp;
+    use: string;
+})[];
+/**
+ * Creates asset rules
+ */
+export declare function createAssetRule(emitFiles?: boolean): {
+    test: RegExp;
+    type: "asset/resource";
+    generator: {
+        emit: boolean;
+    };
+};
+/**
+ * Creates rule to ignore source map files
+ */
+export declare function createMapIgnoreRule(): {
+    test: RegExp;
+    use: string;
+};

package/dist/cli/webpack-utils/optimization.d.ts

@@ -0,0 +1,45 @@
+import webpack from "webpack";
+export interface CacheConfig {
+    type: "filesystem" | "memory";
+    name: string;
+    cacheDirectory: string;
+    buildDependencies: {
+        config: string[];
+    };
+    compression?: false | "gzip" | "brotli";
+}
+/**
+ * Creates optimized cache configuration for webpack
+ * Inspired by Next.js build performance
+ */
+export declare function createCacheConfig(target: "client" | "server", isProduction: boolean): CacheConfig;
+/**
+ * Creates optimized resolve configuration
+ */
+export declare function createResolveConfig(aliases: Record<string, string>): {
+    extensions: string[];
+    alias: Record<string, string>;
+    symlinks: boolean;
+    cacheWithContext: boolean;
+};
+/**
+ * Creates optimized optimization configuration for development
+ */
+export declare function createDevOptimization(target?: "client" | "server"): webpack.Configuration["optimization"];
+/**
+ * Creates optimized optimization configuration for production
+ */
+export declare function createProdOptimization(target: "client" | "server"): webpack.Configuration["optimization"];
+/**
+ * Creates output configuration optimized for path info
+ */
+export declare function createOutputConfig(outputPath: string, isProduction: boolean, target: "client" | "server"): webpack.Configuration["output"];
+/**
+ * Creates watch options optimized for performance
+ */
+export declare function createWatchOptions(): webpack.Configuration["watchOptions"];
+/**
+ * Get devtool configuration based on environment
+ * eval-cheap-module-source-map is fastest for dev with good quality
+ */
+export declare function getDevtool(isProduction: boolean, target: "client" | "server"): webpack.Configuration["devtool"];

package/dist/cli/webpack-utils/plugins.d.ts

@@ -0,0 +1,36 @@
+import { CleanWebpackPlugin } from "clean-webpack-plugin";
+import HtmlWebpackPlugin from "html-webpack-plugin";
+import MiniCssExtractPlugin from "mini-css-extract-plugin";
+import webpack from "webpack";
+/**
+ * Creates HTML plugin for client build
+ */
+export declare function createHtmlPlugin(isProduction: boolean): HtmlWebpackPlugin;
+/**
+ * Creates CSS extraction plugin
+ */
+export declare function createCssPlugin(isProduction: boolean): MiniCssExtractPlugin;
+/**
+ * Creates clean plugin (only for production)
+ */
+export declare function createCleanPlugin(): CleanWebpackPlugin;
+/**
+ * Creates define plugin for environment variables
+ */
+export declare function createDefinePlugin(isProduction: boolean, target: "client" | "server"): webpack.DefinePlugin;
+/**
+ * Creates progress plugin (dev only, minimal output)
+ */
+export declare function createProgressPlugin(): webpack.ProgressPlugin;
+/**
+ * Creates ignore plugin for optional dependencies
+ */
+export declare function createIgnorePlugin(): webpack.IgnorePlugin;
+/**
+ * Get all client plugins
+ */
+export declare function getClientPlugins(isProduction: boolean): webpack.WebpackPluginInstance[];
+/**
+ * Get all server plugins
+ */
+export declare function getServerPlugins(isProduction: boolean): webpack.WebpackPluginInstance[];

package/dist/cli/webpack.config.d.ts

@@ -1,3 +1,16 @@
 import webpack from "webpack";
-export declare const createClientConfig: () => webpack.Configuration;
-export declare const createServerConfig: () => webpack.Configuration;
+/**
+ * Creates optimized client webpack configuration
+ * Inspired by Next.js build performance
+ */
+export declare function createClientConfig(): webpack.Configuration;
+/**
+ * Creates optimized server webpack configuration
+ */
+export declare function createServerConfig(): webpack.Configuration;
+/**
+ * Creates multi-compiler configuration for parallel builds
+ * This builds both client and server simultaneously
+ */
+export declare function createMultiConfig(): webpack.Configuration[];
+export { createClientConfig as getClientConfig, createServerConfig as getServerConfig, };