mastercontroller 1.2.13 → 1.2.14

package/.claude/settings.local.json

@@ -0,0 +1,12 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(rm:*)",
+      "Bash(mv:*)",
+      "Bash(node -e:*)",
+      "Bash(find:*)"
+    ],
+    "deny": [],
+    "ask": []
+  }
+}

package/MasterAction.js

@@ -1,5 +1,5 @@
 
-// version 0.0.22
+// version 0.0.23
 
 var master = require('./MasterControl');
 var fileserver = require('fs');
@@ -16,14 +16,14 @@ var path = require('path');
 const compileWebComponentsHTML = require('./ssr/runtime-ssr.cjs');
 
 // Enhanced error handling
-const { handleTemplateError, sendErrorResponse } = require('./MasterBackendErrorHandler');
-const { safeReadFile } = require('./MasterErrorMiddleware');
-const { logger } = require('./MasterErrorLogger');
+const { handleTemplateError, sendErrorResponse } = require('./error/MasterBackendErrorHandler');
+const { safeReadFile } = require('./error/MasterErrorMiddleware');
+const { logger } = require('./error/MasterErrorLogger');
 
 // Security - CSRF, validation, sanitization
-const { generateCSRFToken, validateCSRFToken } = require('./SecurityMiddleware');
-const { validator, validateRequestBody, sanitizeObject } = require('./MasterValidator');
-const { sanitizeUserHTML, escapeHTML } = require('./MasterSanitizer');
+const { generateCSRFToken, validateCSRFToken } = require('./security/SecurityMiddleware');
+const { validator, validateRequestBody, sanitizeObject } = require('./security/MasterValidator');
+const { sanitizeUserHTML, escapeHTML } = require('./security/MasterSanitizer');
 
 class MasterAction{
 	

package/MasterControl.js

@@ -1,5 +1,5 @@
 // MasterControl - by Alexander rich
-// version 1.0.248
+// version 1.0.251
 
 var url = require('url');
 var fileserver = require('fs');
@@ -12,13 +12,13 @@ var path = require('path');
 var globSearch = require("glob");
 
 // Enhanced error handling - setup global handlers
-const { setupGlobalErrorHandlers } = require('./MasterErrorMiddleware');
-const { logger } = require('./MasterErrorLogger');
+const { setupGlobalErrorHandlers } = require('./error/MasterErrorMiddleware');
+const { logger } = require('./error/MasterErrorLogger');
 
 // Security - Initialize security features
-const { security, securityHeaders } = require('./SecurityMiddleware');
-const { csp } = require('./CSPConfig');
-const { session } = require('./SessionSecurity');
+const { security, securityHeaders } = require('./security/SecurityMiddleware');
+const { csp } = require('./security/CSPConfig');
+const { session } = require('./security/SessionSecurity');
 
 // Initialize global error handling
 setupGlobalErrorHandlers();
@@ -193,23 +193,26 @@ class MasterControl {
     component(folderLocation, innerFolder){
 
         var rootFolderLocation = path.join(this.root, folderLocation, innerFolder);
-        var files = globSearch.sync("**/*config.js", { cwd: rootFolderLocation, absolute: true });
-        if(files && files.length > 0){
-            require(files[0]);
+
+        // Structure is always: {rootFolderLocation}/config/initializers/config.js
+        var configPath = path.join(rootFolderLocation, 'config', 'initializers', 'config.js');
+        if(fs.existsSync(configPath)){
+            require(configPath);
         }else{
-            this.error.log(`Cannot find config file under ${rootFolderLocation}`, "error");
+            this.error.log(`Cannot find config file at ${configPath}`, "error");
         }
-        var routeFiles = globSearch.sync("**/*routes.js", { cwd: rootFolderLocation, absolute: true });
-        var route = routeFiles && routeFiles.length > 0 ? routeFiles[0] : null;
+
+        // Structure is always: {rootFolderLocation}/config/routes.js
+        var routePath = path.join(rootFolderLocation, 'config', 'routes.js');
         var routeObject = {
-            isComponent : true, 
+            isComponent : true,
             root : rootFolderLocation
         }
         this.router.setup(routeObject);
-        if(route){
-            require(route);
+        if(fs.existsSync(routePath)){
+            require(routePath);
         }else{
-            this.error.log(`Cannot find routes file under ${rootFolderLocation}`, "error");
+            this.error.log(`Cannot find routes file at ${routePath}`, "error");
         }
     }
 
@@ -541,16 +544,18 @@ class MasterControl {
 
     startMVC(foldername){
         var rootFolderLocation = path.join(this.root, foldername);
-        var files = globSearch.sync("**/*routes.js", { cwd: rootFolderLocation, absolute: true });
+
+        // Structure is always: {rootFolderLocation}/routes.js
+        var routePath = path.join(rootFolderLocation, 'routes.js');
         var route = {
-            isComponent : false, 
+            isComponent : false,
             root : `${this.root}`
         }
         this.router.setup(route);
-        if(files && files.length > 0){
-            require(files[0]);
+        if(fs.existsSync(routePath)){
+            require(routePath);
         }else{
-            this.error.log(`Cannot find routes file under ${rootFolderLocation}`, "error");
+            this.error.log(`Cannot find routes file at ${routePath}`, "error");
         }
     }
     
@@ -558,8 +563,26 @@ class MasterControl {
     // builds and calls all the required tools to have master running completely
     addInternalTools(requiredList){
         if(requiredList.constructor === Array){
+            // Map module names to their new organized paths
+            const modulePathMap = {
+                'MasterError': './error/MasterError',
+                'MasterAction': './MasterAction',
+                'MasterActionFilters': './MasterActionFilters',
+                'MasterRouter': './MasterRouter',
+                'MasterRequest': './MasterRequest',
+                'MasterCors': './MasterCors',
+                'MasterSession': './MasterSession',
+                'MasterSocket': './MasterSocket',
+                'MasterHtml': './MasterHtml',
+                'MasterTemplate': './MasterTemplate',
+                'MasterTools': './MasterTools',
+                'TemplateOverwrite': './TemplateOverwrite'
+            };
+
             for(var i = 0; i < requiredList.length; i++){
-                require('./' + requiredList[i]);
+                const moduleName = requiredList[i];
+                const modulePath = modulePathMap[moduleName] || './' + moduleName;
+                require(modulePath);
             }
         }
     }

package/MasterHtml.js

@@ -1,4 +1,4 @@
-// version 0.0.24
+// version 0.0.25
 
 var master = require('./MasterControl');
 var fs = require('fs');
@@ -8,12 +8,12 @@ var temp = new tempClass();
 var tools = new toolClass();
 
 // Enhanced error handling
-const { handleTemplateError } = require('./MasterBackendErrorHandler');
-const { safeReadFile, safeFileExists } = require('./MasterErrorMiddleware');
-const { logger } = require('./MasterErrorLogger');
+const { handleTemplateError } = require('./error/MasterBackendErrorHandler');
+const { safeReadFile, safeFileExists } = require('./error/MasterErrorMiddleware');
+const { logger } = require('./error/MasterErrorLogger');
 
 // Security - Sanitization
-const { sanitizeTemplateHTML, sanitizeUserHTML, escapeHTML } = require('./MasterSanitizer');
+const { sanitizeTemplateHTML, sanitizeUserHTML, escapeHTML } = require('./security/MasterSanitizer');
 
 class html {
 

package/MasterRouter.js

@@ -1,4 +1,4 @@
-// version 0.0.249
+// version 0.0.250
 
 var master = require('./MasterControl');
 var toolClass =  require('./MasterTools');
@@ -8,13 +8,13 @@ var currentRoute = {};
 var tools = new toolClass();
 
 // Enhanced error handling
-const { handleRoutingError, handleControllerError, sendErrorResponse } = require('./MasterBackendErrorHandler');
-const { logger } = require('./MasterErrorLogger');
-const { performanceTracker, errorHandlerMiddleware } = require('./MasterErrorMiddleware');
+const { handleRoutingError, handleControllerError, sendErrorResponse } = require('./error/MasterBackendErrorHandler');
+const { logger } = require('./error/MasterErrorLogger');
+const { performanceTracker, errorHandlerMiddleware } = require('./error/MasterErrorMiddleware');
 
 // Security - Input validation and sanitization
-const { validator, detectPathTraversal, detectSQLInjection, detectCommandInjection } = require('./MasterValidator');
-const { escapeHTML } = require('./MasterSanitizer');
+const { validator, detectPathTraversal, detectSQLInjection, detectCommandInjection } = require('./security/MasterValidator');
+const { escapeHTML } = require('./security/MasterSanitizer');
 
 const isDevelopment = process.env.NODE_ENV !== 'production' && process.env.master === 'development';
 
@@ -135,10 +135,16 @@ const isDevelopment = process.env.NODE_ENV !== 'production' && process.env.maste
                     try {
                         requestObject.toController = routeList[item].toController;
                         requestObject.toAction = routeList[item].toAction;
-                        var pathObj = normalizePaths(requestObject.pathName, routeList[item].path, requestObject.params);
+
+                        // FIX: Create a clean copy of params for each route test to prevent parameter pollution
+                        // This prevents parameters from non-matching routes from accumulating in requestObject.params
+                        var testParams = Object.assign({}, requestObject.params);
+                        var pathObj = normalizePaths(requestObject.pathName, routeList[item].path, testParams);
 
                         // if we find the route that matches the request
                         if(pathObj.requestPath === pathObj.routePath && routeList[item].type === requestObject.type){
+                            // Only commit the extracted params if this route actually matches
+                            requestObject.params = testParams;
 
                             // call Constraint
                             if(typeof routeList[item].constraint === "function"){
@@ -197,6 +203,8 @@ const isDevelopment = process.env.NODE_ENV !== 'production' && process.env.maste
 
                         if(pathObj.requestPath === pathObj.routePath && "options" ===requestObject.type.toLowerCase()){
                             // this means that the request is correct but its an options request means its the browser checking to see if the request is allowed
+                            // Commit the params for OPTIONS requests too
+                            requestObject.params = testParams;
                             requestObject.response.writeHead(200, {'Content-Type': 'application/json'});
                             requestObject.response.end(JSON.stringify({"done": "true"}));
                             return true;

package/MasterTemplate.js

@@ -1,10 +1,10 @@
-// version 0.0.4
+// version 0.0.5
 // https://github.com/WebReflection/backtick-template
 // https://stackoverflow.com/questions/29182244/convert-a-string-to-a-template-string
 
 // Security - Template injection prevention
-const { escapeHTML } = require('./MasterSanitizer');
-const { logger } = require('./MasterErrorLogger');
+const { escapeHTML } = require('./security/MasterSanitizer');
+const { logger } = require('./error/MasterErrorLogger');
 
 var replace = ''.replace;
 

package/{MasterError.js → error/MasterError.js}

@@ -1,6 +1,6 @@
 
-// version 1.0.20 - improved console/error logging with syntax error code frames
-var master = require('./MasterControl');
+// version 1.0.21 - improved console/error logging with syntax error code frames
+var master = require('../MasterControl');
 var winston = require('winston');
 var fileserver = require('fs');
 const { request } = require('http');

package/{MasterErrorLogger.js → error/MasterErrorLogger.js}

@@ -1,7 +1,7 @@
 /**
  * MasterErrorLogger - Error logging infrastructure
  * Supports multiple logging backends and monitoring service integration
- * Version: 1.0.0
+ * Version: 1.0.1
  */
 
 const fs = require('fs');

package/{MasterErrorMiddleware.js → error/MasterErrorMiddleware.js}

@@ -1,6 +1,6 @@
 /**
  * MasterErrorMiddleware - Request/Response error handling middleware
- * Version: 1.0.0
+ * Version: 1.0.1
  */
 
 const { handleControllerError, handleRoutingError, sendErrorResponse } = require('./MasterBackendErrorHandler');
@@ -23,7 +23,7 @@ function errorHandlerMiddleware(handler, controllerName, actionName) {
       // Log successful request in development
       if (isDevelopment) {
         const duration = Date.now() - startTime;
-        logger.debug({
+        logger.info({
           code: 'MC_INFO_REQUEST_SUCCESS',
           message: `${controllerName}#${actionName} completed`,
           context: {

package/{ssr → error}/SSRErrorHandler.js

@@ -1,10 +1,10 @@
 /**
  * SSRErrorHandler - Server-side rendering error handling
  * Handles component render failures with graceful fallbacks
- * Version: 1.0.0
+ * Version: 1.0.1
  */
 
-const { MasterControllerError } = require('../MasterErrorHandler');
+const { MasterControllerError } = require('./MasterErrorHandler');
 
 const isDevelopment = process.env.NODE_ENV !== 'production' && process.env.master === 'development';
 

package/{MasterCache.js → monitoring/MasterCache.js}

@@ -1,4 +1,4 @@
-// version 1.0.0
+// version 1.0.1
 // MasterController Cache System - Runtime Performance Optimization
 
 /**
@@ -10,7 +10,7 @@
  * - TTL support
  */
 
-const { logger } = require('./MasterErrorLogger');
+const { logger } = require('../error/MasterErrorLogger');
 
 /**
  * LRU Cache with TTL support

package/{MasterMemoryMonitor.js → monitoring/MasterMemoryMonitor.js}

@@ -1,4 +1,4 @@
-// version 1.0.0
+// version 1.0.1
 // MasterController Memory Monitor - Memory Leak Detection
 
 /**
@@ -9,7 +9,7 @@
  * - Memory alerts
  */
 
-const { logger } = require('./MasterErrorLogger');
+const { logger } = require('../error/MasterErrorLogger');
 
 class MasterMemoryMonitor {
   constructor(options = {}) {

package/{MasterProfiler.js → monitoring/MasterProfiler.js}

@@ -1,4 +1,4 @@
-// version 1.0.0
+// version 1.0.1
 // MasterController Performance Profiler - Component and Request Profiling
 
 /**
@@ -10,7 +10,7 @@
  * - Detailed performance reports
  */
 
-const { logger } = require('./MasterErrorLogger');
+const { logger } = require('../error/MasterErrorLogger');
 
 class MasterProfiler {
   constructor(options = {}) {

package/{ssr → monitoring}/PerformanceMonitor.js

@@ -1,9 +1,9 @@
 /**
  * PerformanceMonitor - Track and report SSR performance metrics
- * Version: 1.0.0
+ * Version: 1.0.1
  */
 
-const { MasterControllerError } = require('../MasterErrorHandler');
+const { MasterControllerError } = require('../error/MasterErrorHandler');
 
 const isDevelopment = process.env.NODE_ENV !== 'production' && process.env.master === 'development';
 

package/package.json

@@ -18,5 +18,5 @@
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1"
   },
-  "version": "1.2.13"
+  "version": "1.2.14"
 }

package/{EventHandlerValidator.js → security/EventHandlerValidator.js}

@@ -1,4 +1,4 @@
-// version 1.0.0
+// version 1.0.1
 // MasterController Event Handler Validator - Prevent code injection in @event attributes
 
 /**
@@ -8,8 +8,8 @@
  * - Malicious function calls
  */
 
-const { logger } = require('./MasterErrorLogger');
-const { MasterControllerError } = require('./MasterErrorHandler');
+const { logger } = require('../error/MasterErrorLogger');
+const { MasterControllerError } = require('../error/MasterErrorHandler');
 
 // Valid patterns for event handler expressions
 const VALID_PATTERNS = [

package/{MasterSanitizer.js → security/MasterSanitizer.js}

@@ -1,4 +1,4 @@
-// version 1.0.0
+// version 1.0.1
 // MasterController HTML Sanitizer - XSS Protection
 
 /**
@@ -7,7 +7,7 @@
  * CSS injection, iframe attacks, form hijacking, meta tag injection
  */
 
-const { logger } = require('./MasterErrorLogger');
+const { logger } = require('../error/MasterErrorLogger');
 
 // Dangerous HTML tags that should be removed
 const DANGEROUS_TAGS = [

package/{MasterValidator.js → security/MasterValidator.js}

@@ -1,4 +1,4 @@
-// version 1.0.0
+// version 1.0.1
 // MasterController Input Validator - SQL Injection, Path Traversal, Command Injection Protection
 
 /**
@@ -12,7 +12,7 @@
  * - Header Injection
  */
 
-const { logger } = require('./MasterErrorLogger');
+const { logger } = require('../error/MasterErrorLogger');
 const { escapeHTML } = require('./MasterSanitizer');
 const path = require('path');
 

package/{SecurityMiddleware.js → security/SecurityMiddleware.js}

@@ -1,4 +1,4 @@
-// version 1.0.0
+// version 1.0.1
 // MasterController Security Middleware - CSRF, Headers, Rate Limiting, CORS
 
 /**
@@ -7,7 +7,7 @@
  */
 
 const crypto = require('crypto');
-const { logger } = require('./MasterErrorLogger');
+const { logger } = require('../error/MasterErrorLogger');
 
 // Rate limiting store
 const rateLimitStore = new Map();

package/{SessionSecurity.js → security/SessionSecurity.js}

@@ -1,4 +1,4 @@
-// version 1.0.0
+// version 1.0.1
 // MasterController Session Security - Secure cookie handling, session fixation prevention
 
 /**
@@ -7,7 +7,7 @@
  */
 
 const crypto = require('crypto');
-const { logger } = require('./MasterErrorLogger');
+const { logger } = require('../error/MasterErrorLogger');
 
 // Session store (use Redis in production)
 const sessionStore = new Map();

package/ssr/hydration-client.js

@@ -1,11 +1,11 @@
 /**
  * MasterController Client-Side Hydration Runtime
  * Handles error boundaries and hydration mismatch detection
- * Version: 2.0.0
+ * Version: 2.0.1
  */
 
 // Import error boundary
-import { ErrorBoundary } from './ErrorBoundary.js';
+import { ErrorBoundary } from '../error/ErrorBoundary.js';
 
 // Import hydration mismatch detection
 const isDevelopment = window.location.hostname === 'localhost' ||
@@ -13,7 +13,7 @@ const isDevelopment = window.location.hostname === 'localhost' ||
 
 if (isDevelopment && typeof require !== 'undefined') {
   try {
-    const { enableHydrationMismatchDetection } = require('./HydrationMismatch.js');
+    const { enableHydrationMismatchDetection } = require('../error/HydrationMismatch.js');
     enableHydrationMismatchDetection({
       verbose: localStorage.getItem('mc-hydration-debug') === 'true',
       delay: 1000

package/ssr/runtime-ssr.cjs

@@ -13,18 +13,18 @@ const vm = require('vm');
 const moduleCache = new Map();
 
 // Error handling and monitoring
-const { MasterControllerError, findSimilarStrings } = require('../MasterErrorHandler');
-const { safeRenderComponent, validateSSRComponent, wrapConnectedCallback } = require('./SSRErrorHandler');
-const { monitor } = require('./PerformanceMonitor');
-const { logger } = require('../MasterErrorLogger');
+const { MasterControllerError, findSimilarStrings } = require('../error/MasterErrorHandler');
+const { safeRenderComponent, validateSSRComponent, wrapConnectedCallback } = require('../error/SSRErrorHandler');
+const { monitor } = require('../monitoring/PerformanceMonitor');
+const { logger } = require('../error/MasterErrorLogger');
 
 // Security - Sanitization and validation
-const { sanitizer, sanitizeTemplateHTML, sanitizeProps } = require('../MasterSanitizer');
-const { validateEventAttribute } = require('../EventHandlerValidator');
+const { sanitizer, sanitizeTemplateHTML, sanitizeProps } = require('../security/MasterSanitizer');
+const { validateEventAttribute } = require('../security/EventHandlerValidator');
 
 // Performance - Caching and profiling
-const { cache } = require('../MasterCache');
-const { profiler } = require('../MasterProfiler');
+const { cache } = require('../monitoring/MasterCache');
+const { profiler } = require('../monitoring/MasterProfiler');
 
 // Track registered custom elements to detect duplicates
 const registeredElements = new Map();
@@ -462,7 +462,7 @@ module.exports = async function compileWebComponentsHTML(inputHTML, preloadModul
           if (isDevelopment) {
             el.innerHTML = error.toHTML();
           } else {
-            const { renderFallback } = require('./SSRErrorHandler');
+            const { renderFallback } = require('../error/SSRErrorHandler');
             el.innerHTML = renderFallback(componentName);
           }
         }

package/MasterBenchmark.js

@@ -1,89 +0,0 @@
-// version 1.0.0
-// MasterController Benchmark - Performance Benchmarking
-
-const { profiler } = require('./MasterProfiler');
-const { logger } = require('./MasterErrorLogger');
-
-class MasterBenchmark {
-  constructor() {
-    this.results = [];
-  }
-
-  /**
-   * Benchmark SSR render time
-   */
-  async benchmarkSSR(component, iterations = 100) {
-    const times = [];
-
-    for (let i = 0; i < iterations; i++) {
-      const start = Date.now();
-
-      // Render component (would call actual SSR here)
-      await new Promise(resolve => setImmediate(resolve));
-
-      const duration = Date.now() - start;
-      times.push(duration);
-    }
-
-    return this.calculateStats(times, 'SSR Render');
-  }
-
-  /**
-   * Benchmark hydration time
-   */
-  async benchmarkHydration(iterations = 100) {
-    const times = [];
-
-    for (let i = 0; i < iterations; i++) {
-      const start = Date.now();
-
-      // Simulate hydration
-      await new Promise(resolve => setImmediate(resolve));
-
-      const duration = Date.now() - start;
-      times.push(duration);
-    }
-
-    return this.calculateStats(times, 'Hydration');
-  }
-
-  /**
-   * Calculate statistics
-   */
-  calculateStats(times, name) {
-    const sorted = times.sort((a, b) => a - b);
-    const sum = times.reduce((a, b) => a + b, 0);
-
-    return {
-      name,
-      iterations: times.length,
-      min: sorted[0],
-      max: sorted[sorted.length - 1],
-      mean: sum / times.length,
-      median: sorted[Math.floor(times.length / 2)],
-      p95: sorted[Math.floor(times.length * 0.95)],
-      p99: sorted[Math.floor(times.length * 0.99)]
-    };
-  }
-
-  /**
-   * Print benchmark results
-   */
-  printResults(stats) {
-    console.log('\n═══════════════════════════════════════════════════');
-    console.log('⚡ MasterController Benchmark Results');
-    console.log('═══════════════════════════════════════════════════');
-
-    console.log(`\n${stats.name} (${stats.iterations} iterations):`);
-    console.log(`  Mean: ${stats.mean.toFixed(2)}ms`);
-    console.log(`  Median: ${stats.median.toFixed(2)}ms`);
-    console.log(`  Min: ${stats.min.toFixed(2)}ms`);
-    console.log(`  Max: ${stats.max.toFixed(2)}ms`);
-    console.log(`  P95: ${stats.p95.toFixed(2)}ms`);
-    console.log(`  P99: ${stats.p99.toFixed(2)}ms`);
-
-    console.log('═══════════════════════════════════════════════════\n');
-  }
-}
-
-module.exports = { MasterBenchmark };

package/MasterBuildOptimizer.js

@@ -1,376 +0,0 @@
-// version 1.0.0
-// MasterController Build Optimizer - Minification, Tree Shaking, Dead Code Elimination
-
-/**
- * Build-time optimizations for MasterController
- * - Minifies event manifests
- * - Eliminates dead code
- * - Tree shaking for unused components
- * - Optimizes bundle size
- */
-
-const fs = require('fs');
-const path = require('path');
-const { logger } = require('./MasterErrorLogger');
-
-class MasterBuildOptimizer {
-  constructor(options = {}) {
-    this.rootDir = options.rootDir || process.cwd();
-    this.outputDir = options.outputDir || path.join(this.rootDir, 'public', '__compiled__');
-    this.minify = options.minify !== false;
-    this.treeShake = options.treeShake !== false;
-    this.deadCodeElimination = options.deadCodeElimination !== false;
-    this.sourceMaps = options.sourceMaps || false;
-
-    // Statistics
-    this.stats = {
-      filesProcessed: 0,
-      bytesOriginal: 0,
-      bytesOptimized: 0,
-      timeTaken: 0,
-      componentsFound: 0,
-      componentsUsed: 0,
-      componentsRemoved: 0
-    };
-  }
-
-  /**
-   * Optimize entire build
-   */
-  async optimize() {
-    const startTime = Date.now();
-
-    logger.info({
-      code: 'MC_PERF_BUILD_START',
-      message: 'Build optimization started'
-    });
-
-    try {
-      // 1. Analyze component usage
-      const usageMap = await this.analyzeComponentUsage();
-
-      // 2. Tree shake unused components
-      if (this.treeShake) {
-        await this.treeShakeComponents(usageMap);
-      }
-
-      // 3. Minify event manifests
-      if (this.minify) {
-        await this.minifyEventManifests();
-      }
-
-      // 4. Eliminate dead code
-      if (this.deadCodeElimination) {
-        await this.eliminateDeadCode();
-      }
-
-      // 5. Optimize bundle
-      await this.optimizeBundle();
-
-      this.stats.timeTaken = Date.now() - startTime;
-
-      // Log results
-      this.logOptimizationResults();
-
-      return this.stats;
-    } catch (error) {
-      logger.error({
-        code: 'MC_PERF_BUILD_ERROR',
-        message: 'Build optimization failed',
-        error: error.message
-      });
-      throw error;
-    }
-  }
-
-  /**
-   * Analyze which components are actually used in the application
-   */
-  async analyzeComponentUsage() {
-    const usageMap = new Map();
-
-    // Scan all view files
-    const viewsDir = path.join(this.rootDir, 'app', 'views');
-    const viewFiles = this.findFiles(viewsDir, ['.html', '.js']);
-
-    for (const file of viewFiles) {
-      const content = fs.readFileSync(file, 'utf8');
-
-      // Find custom element usages (<ui-button>, <ui-calendar>, etc.)
-      const customElements = content.match(/<([a-z]+-[a-z-]+)/g) || [];
-
-      for (const match of customElements) {
-        const tagName = match.substring(1); // Remove <
-        usageMap.set(tagName, (usageMap.get(tagName) || 0) + 1);
-      }
-    }
-
-    this.stats.componentsFound = usageMap.size;
-
-    logger.info({
-      code: 'MC_PERF_USAGE_ANALYSIS',
-      message: 'Component usage analysis complete',
-      componentsFound: usageMap.size
-    });
-
-    return usageMap;
-  }
-
-  /**
-   * Tree shake unused components from the bundle
-   */
-  async treeShakeComponents(usageMap) {
-    const componentsDir = path.join(this.rootDir, 'app', 'assets', 'javascripts', 'shad-web-components', 'components');
-
-    if (!fs.existsSync(componentsDir)) {
-      return;
-    }
-
-    const componentFiles = this.findFiles(componentsDir, ['.js']);
-    let removedCount = 0;
-
-    for (const file of componentFiles) {
-      const content = fs.readFileSync(file, 'utf8');
-
-      // Extract component tag name from customElements.define call
-      const defineMatch = content.match(/customElements\.define\(['"]([^'"]+)['"]/);
-
-      if (defineMatch) {
-        const tagName = defineMatch[1];
-
-        // If component is not used, mark for removal
-        if (!usageMap.has(tagName)) {
-          removedCount++;
-          logger.info({
-            code: 'MC_PERF_TREE_SHAKE',
-            message: `Unused component detected: ${tagName}`,
-            file: path.basename(file)
-          });
-
-          // In production, we'd actually remove or exclude this from the bundle
-          // For now, just log it
-        }
-      }
-    }
-
-    this.stats.componentsUsed = usageMap.size;
-    this.stats.componentsRemoved = removedCount;
-  }
-
-  /**
-   * Minify event manifest JSON files
-   */
-  async minifyEventManifests() {
-    const manifestsDir = path.join(this.outputDir, 'event-manifests');
-
-    if (!fs.existsSync(manifestsDir)) {
-      return;
-    }
-
-    const manifestFiles = fs.readdirSync(manifestsDir).filter(f => f.endsWith('.json'));
-
-    for (const file of manifestFiles) {
-      const filePath = path.join(manifestsDir, file);
-      const content = fs.readFileSync(filePath, 'utf8');
-      const originalSize = Buffer.byteLength(content, 'utf8');
-
-      // Parse and re-stringify without whitespace
-      const parsed = JSON.parse(content);
-      const minified = JSON.stringify(parsed);
-
-      const minifiedSize = Buffer.byteLength(minified, 'utf8');
-
-      // Write minified version
-      fs.writeFileSync(filePath, minified, 'utf8');
-
-      this.stats.filesProcessed++;
-      this.stats.bytesOriginal += originalSize;
-      this.stats.bytesOptimized += minifiedSize;
-
-      logger.info({
-        code: 'MC_PERF_MINIFY',
-        message: `Minified ${file}`,
-        originalSize: originalSize,
-        minifiedSize: minifiedSize,
-        savings: `${((1 - minifiedSize / originalSize) * 100).toFixed(1)}%`
-      });
-    }
-  }
-
-  /**
-   * Eliminate dead code from JavaScript bundles
-   */
-  async eliminateDeadCode() {
-    const jsDir = path.join(this.outputDir);
-
-    if (!fs.existsSync(jsDir)) {
-      return;
-    }
-
-    const jsFiles = fs.readdirSync(jsDir).filter(f => f.endsWith('.js'));
-
-    for (const file of jsFiles) {
-      const filePath = path.join(jsDir, file);
-      let content = fs.readFileSync(filePath, 'utf8');
-      const originalSize = Buffer.byteLength(content, 'utf8');
-
-      // Remove console.log statements in production
-      if (process.env.NODE_ENV === 'production') {
-        content = content.replace(/console\.log\([^)]*\);?/g, '');
-        content = content.replace(/console\.debug\([^)]*\);?/g, '');
-      }
-
-      // Remove comments
-      content = content.replace(/\/\*[\s\S]*?\*\//g, ''); // Block comments
-      content = content.replace(/\/\/.*/g, ''); // Line comments
-
-      // Remove empty lines
-      content = content.replace(/^\s*[\r\n]/gm, '');
-
-      const optimizedSize = Buffer.byteLength(content, 'utf8');
-
-      // Write optimized version
-      fs.writeFileSync(filePath, content, 'utf8');
-
-      this.stats.bytesOriginal += originalSize;
-      this.stats.bytesOptimized += optimizedSize;
-    }
-  }
-
-  /**
-   * Optimize bundle size
-   */
-  async optimizeBundle() {
-    // Analyze and report bundle sizes
-    const compiledDir = this.outputDir;
-
-    if (!fs.existsSync(compiledDir)) {
-      return;
-    }
-
-    const files = fs.readdirSync(compiledDir);
-    const bundles = [];
-
-    for (const file of files) {
-      const filePath = path.join(compiledDir, file);
-      const stats = fs.statSync(filePath);
-
-      if (stats.isFile() && file.endsWith('.js')) {
-        bundles.push({
-          name: file,
-          size: stats.size,
-          gzipSize: this.estimateGzipSize(stats.size)
-        });
-      }
-    }
-
-    // Sort by size
-    bundles.sort((a, b) => b.size - a.size);
-
-    // Log largest bundles
-    const topBundles = bundles.slice(0, 5);
-    for (const bundle of topBundles) {
-      logger.info({
-        code: 'MC_PERF_BUNDLE_SIZE',
-        message: `Bundle: ${bundle.name}`,
-        size: `${(bundle.size / 1024).toFixed(2)} KB`,
-        gzipSize: `${(bundle.gzipSize / 1024).toFixed(2)} KB`
-      });
-    }
-
-    return bundles;
-  }
-
-  /**
-   * Estimate gzip size (approximation: ~30% of original)
-   */
-  estimateGzipSize(size) {
-    return Math.round(size * 0.3);
-  }
-
-  /**
-   * Find files recursively
-   */
-  findFiles(dir, extensions) {
-    const files = [];
-
-    if (!fs.existsSync(dir)) {
-      return files;
-    }
-
-    const items = fs.readdirSync(dir);
-
-    for (const item of items) {
-      const fullPath = path.join(dir, item);
-      const stat = fs.statSync(fullPath);
-
-      if (stat.isDirectory()) {
-        files.push(...this.findFiles(fullPath, extensions));
-      } else if (extensions.some(ext => item.endsWith(ext))) {
-        files.push(fullPath);
-      }
-    }
-
-    return files;
-  }
-
-  /**
-   * Log optimization results
-   */
-  logOptimizationResults() {
-    const savingsPercent = this.stats.bytesOriginal > 0
-      ? ((1 - this.stats.bytesOptimized / this.stats.bytesOriginal) * 100).toFixed(1)
-      : 0;
-
-    logger.info({
-      code: 'MC_PERF_BUILD_COMPLETE',
-      message: 'Build optimization complete',
-      context: {
-        filesProcessed: this.stats.filesProcessed,
-        originalSize: `${(this.stats.bytesOriginal / 1024).toFixed(2)} KB`,
-        optimizedSize: `${(this.stats.bytesOptimized / 1024).toFixed(2)} KB`,
-        savings: `${savingsPercent}%`,
-        timeTaken: `${this.stats.timeTaken}ms`,
-        componentsFound: this.stats.componentsFound,
-        componentsUsed: this.stats.componentsUsed,
-        componentsRemoved: this.stats.componentsRemoved
-      }
-    });
-
-    // Print summary
-    console.log('\n═══════════════════════════════════════════════════');
-    console.log('🚀 MasterController Build Optimization Complete');
-    console.log('═══════════════════════════════════════════════════');
-    console.log(`Files Processed: ${this.stats.filesProcessed}`);
-    console.log(`Original Size: ${(this.stats.bytesOriginal / 1024).toFixed(2)} KB`);
-    console.log(`Optimized Size: ${(this.stats.bytesOptimized / 1024).toFixed(2)} KB`);
-    console.log(`Savings: ${savingsPercent}%`);
-    console.log(`Time Taken: ${this.stats.timeTaken}ms`);
-    console.log(`Components Found: ${this.stats.componentsFound}`);
-    console.log(`Components Used: ${this.stats.componentsUsed}`);
-    console.log(`Unused Components: ${this.stats.componentsRemoved}`);
-    console.log('═══════════════════════════════════════════════════\n');
-  }
-}
-
-// CLI usage
-if (require.main === module) {
-  const optimizer = new MasterBuildOptimizer({
-    rootDir: process.cwd(),
-    minify: true,
-    treeShake: true,
-    deadCodeElimination: true
-  });
-
-  optimizer.optimize()
-    .then(stats => {
-      console.log('✅ Build optimization successful');
-      process.exit(0);
-    })
-    .catch(error => {
-      console.error('❌ Build optimization failed:', error.message);
-      process.exit(1);
-    });
-}
-
-module.exports = { MasterBuildOptimizer };

package/MasterBundleAnalyzer.js

@@ -1,108 +0,0 @@
-// version 1.0.0
-// MasterController Bundle Analyzer - Bundle Size Analysis
-
-const fs = require('fs');
-const path = require('path');
-const { logger } = require('./MasterErrorLogger');
-
-class MasterBundleAnalyzer {
-  constructor(options = {}) {
-    this.rootDir = options.rootDir || process.cwd();
-    this.outputDir = options.outputDir || path.join(this.rootDir, 'public', '__compiled__');
-  }
-
-  /**
-   * Analyze bundles
-   */
-  analyze() {
-    const bundles = this.getBundles();
-    const report = this.generateReport(bundles);
-
-    this.printReport(report);
-
-    return report;
-  }
-
-  /**
-   * Get all bundles
-   */
-  getBundles() {
-    const bundles = [];
-
-    if (!fs.existsSync(this.outputDir)) {
-      return bundles;
-    }
-
-    const files = fs.readdirSync(this.outputDir);
-
-    for (const file of files) {
-      const filePath = path.join(this.outputDir, file);
-      const stats = fs.statSync(filePath);
-
-      if (stats.isFile() && file.endsWith('.js')) {
-        bundles.push({
-          name: file,
-          size: stats.size,
-          gzipSize: Math.round(stats.size * 0.3) // Estimate
-        });
-      }
-    }
-
-    return bundles.sort((a, b) => b.size - a.size);
-  }
-
-  /**
-   * Generate report
-   */
-  generateReport(bundles) {
-    const totalSize = bundles.reduce((sum, b) => sum + b.size, 0);
-    const totalGzip = bundles.reduce((sum, b) => sum + b.gzipSize, 0);
-
-    return {
-      bundles,
-      totalSize,
-      totalGzip,
-      bundleCount: bundles.length,
-      averageSize: bundles.length > 0 ? totalSize / bundles.length : 0
-    };
-  }
-
-  /**
-   * Print report
-   */
-  printReport(report) {
-    console.log('\n═══════════════════════════════════════════════════');
-    console.log('📦 MasterController Bundle Analysis');
-    console.log('═══════════════════════════════════════════════════');
-
-    console.log(`\nTotal Bundles: ${report.bundleCount}`);
-    console.log(`Total Size: ${(report.totalSize / 1024).toFixed(2)} KB`);
-    console.log(`Total Size (Gzip): ${(report.totalGzip / 1024).toFixed(2)} KB`);
-    console.log(`Average Bundle Size: ${(report.averageSize / 1024).toFixed(2)} KB`);
-
-    console.log('\nLargest Bundles:');
-    report.bundles.slice(0, 10).forEach((bundle, i) => {
-      console.log(`  ${i + 1}. ${bundle.name}`);
-      console.log(`     Size: ${(bundle.size / 1024).toFixed(2)} KB | Gzip: ${(bundle.gzipSize / 1024).toFixed(2)} KB`);
-    });
-
-    console.log('\n💡 Recommendations:');
-    if (report.totalSize > 500000) {
-      console.log('  ⚠️  Large total bundle size (>500KB)');
-      console.log('     - Enable code splitting');
-      console.log('     - Use dynamic imports');
-      console.log('     - Tree shake unused code');
-    }
-
-    const largeBundles = report.bundles.filter(b => b.size > 100000);
-    if (largeBundles.length > 0) {
-      console.log(`  ⚠️  ${largeBundles.length} bundles exceed 100KB`);
-      console.log('     - Break into smaller chunks');
-      console.log('     - Lazy load large components');
-    }
-
-    console.log('═══════════════════════════════════════════════════\n');
-  }
-}
-
-module.exports = { MasterBundleAnalyzer };

package/ssr/HTMLUtils.js

@@ -1,15 +0,0 @@
-/**
- * Deprecated: HTMLUtils.js
- * Enhance SSR now compiles native web components directly to HTML.
- * This file remains as a no-op compatibility stub so any legacy references do not break.
- */
-class HTMLUtils {
-  static escapeAttr(v) { return String(v ?? ''); }
-  static unescapeAttr(v) { return v; }
-  static encodeData(v) { return this.escapeAttr(v); }
-  static decodeData(v) { return this.unescapeAttr(v); }
-  static dataAttr(name, value) { return `${name}="${this.escapeAttr(value)}"`; }
-}
-if (typeof module !== 'undefined' && module.exports) module.exports = HTMLUtils;
-if (typeof window !== 'undefined') window.HTMLUtils = HTMLUtils;
-if (typeof exports !== 'undefined') exports.HTMLUtils = HTMLUtils;