Function FastLED_SetupAndLoop

src/platforms/wasm/compiler/index.ts:538–707

* Main setup and loop execution function for FastLED programs (Pure JavaScript Architecture) * @async * @param {Object} moduleInstance - The WASM module instance * @param {number} frame_rate - Target frame rate for the animation loop * @returns {Promise } Promise that resolves when setup is

(moduleInstance, frame_rate)

 * @returns {Promise<void>} Promise that resolves when setup is complete and loop is started
 */
async function FastLED_SetupAndLoop(moduleInstance, frame_rate) {
  FASTLED_DEBUG_TRACE('INDEX_JS', 'FastLED_SetupAndLoop', 'ENTER', { frame_rate });

  try {
    FASTLED_DEBUG_LOG('INDEX_JS', 'Initializing FastLED with Pure JavaScript Architecture...');
    console.log('Initializing FastLED with Pure JavaScript Architecture...');

    // Check if moduleInstance is valid
    FASTLED_DEBUG_LOG('INDEX_JS', 'Checking moduleInstance', {
      hasModule: !!moduleInstance,
      hasExternSetup: !!(moduleInstance && moduleInstance._extern_setup),
      hasExternLoop: !!(moduleInstance && moduleInstance._extern_loop),
      hasCwrap: !!(moduleInstance && moduleInstance.cwrap),
    });

    if (!moduleInstance) {
      throw new Error('moduleInstance is null or undefined');
    }

    // Create the pure JavaScript async controller
    FASTLED_DEBUG_LOG('INDEX_JS', 'Creating FastLEDAsyncController...');
    fastLEDController = new FastLEDAsyncController(moduleInstance, frame_rate);
    FASTLED_DEBUG_LOG('INDEX_JS', 'FastLEDAsyncController created successfully');

    // Expose controller globally for debugging and external control
    window.fastLEDController = fastLEDController;

    // Expose event system globally
    window.fastLEDEvents = fastLEDEvents;
    window.fastLEDPerformanceMonitor = fastLEDPerformanceMonitor;

    FASTLED_DEBUG_LOG('INDEX_JS', 'Globals exposed, calling controller.setup()...');

    // Setup FastLED with proper error handling
    console.log('🔧 About to call fastLEDController.setup()');
    try {
      fastLEDController.setup();
      console.log('🔧 fastLEDController.setup() completed successfully');
    } catch (error) {
      console.error('🔧 setup() threw error:', error);
      console.error('🔧 Error stack:', error.stack);
      throw error; // Re-throw to prevent silent failure
    }

    FASTLED_DEBUG_LOG('INDEX_JS', 'Controller setup completed, initializing worker mode...');

    // Initialize Web Worker mode for background thread rendering (always enabled)
    const canvas = /** @type {HTMLCanvasElement | null} */ (document.getElementById('myCanvas'));
    if (!canvas) {
      throw new Error('Canvas element not found');
    }

    FASTLED_DEBUG_LOG('INDEX_JS', 'Initializing Web Worker mode with OffscreenCanvas...');
    await fastLEDController.initializeWorkerMode(canvas, {
      maxRetries: 3
    });
    FASTLED_DEBUG_LOG('INDEX_JS', 'Web Worker mode initialized successfully');