@viji-dev/core 0.3.22 → 0.3.23

package/dist/assets/cv-tasks.worker.js

@@ -0,0 +1,878 @@
+/**
+ * MediaPipe Tasks Vision Classic Worker
+ * 
+ * Classic worker for MediaPipe Tasks Vision processing.
+ * Uses importScripts() to load MediaPipe Tasks Vision UMD bundle.
+ */
+
+// Debug logging — controlled by CVSystem via 'debug' message
+let DEBUG = false;
+function log(...args) {
+  if (DEBUG) {
+    console.log('🔧 [CV Tasks Worker]', ...args);
+  }
+}
+
+// Define CommonJS environment for MediaPipe bundle
+self.exports = {};
+self.module = { exports: {} };
+
+// Import MediaPipe Tasks Vision UMD bundle
+log('Starting to load vision_bundle.js...');
+try {
+  importScripts('/dist/assets/vision_bundle.js');
+  log('vision_bundle.js loaded successfully');
+} catch (error) {
+  console.error('❌ [CV Tasks Worker] Failed to load vision_bundle.js:', error);
+}
+
+// MediaPipe model instances
+let faceDetector = null;
+let faceLandmarker = null;
+let handLandmarker = null;
+let poseLandmarker = null;
+let imageSegmenter = null;
+
+// Vision runtime
+let vision = null;
+let isInitialized = false;
+
+// Active features tracking
+const activeFeatures = new Set();
+
+// Configuration queue to prevent race conditions
+const configQueue = [];
+let processingConfig = false;
+
+// Worker health tracking
+let workerHealthy = true;
+let memoryPressureDetected = false;
+
+// Safe zero-defaults for face data when features are inactive
+const EMPTY_EXPRESSIONS = Object.freeze({
+  neutral: 0, happy: 0, sad: 0, angry: 0, surprised: 0, disgusted: 0, fearful: 0
+});
+
+const EMPTY_HEAD_POSE = Object.freeze({ pitch: 0, yaw: 0, roll: 0 });
+
+const EMPTY_BLENDSHAPES = Object.freeze({
+  browDownLeft: 0, browDownRight: 0, browInnerUp: 0, browOuterUpLeft: 0, browOuterUpRight: 0,
+  cheekPuff: 0, cheekSquintLeft: 0, cheekSquintRight: 0,
+  eyeBlinkLeft: 0, eyeBlinkRight: 0,
+  eyeLookDownLeft: 0, eyeLookDownRight: 0, eyeLookInLeft: 0, eyeLookInRight: 0,
+  eyeLookOutLeft: 0, eyeLookOutRight: 0, eyeLookUpLeft: 0, eyeLookUpRight: 0,
+  eyeSquintLeft: 0, eyeSquintRight: 0, eyeWideLeft: 0, eyeWideRight: 0,
+  jawForward: 0, jawLeft: 0, jawOpen: 0, jawRight: 0,
+  mouthClose: 0, mouthDimpleLeft: 0, mouthDimpleRight: 0,
+  mouthFrownLeft: 0, mouthFrownRight: 0, mouthFunnel: 0, mouthLeft: 0,
+  mouthLowerDownLeft: 0, mouthLowerDownRight: 0, mouthPressLeft: 0, mouthPressRight: 0,
+  mouthPucker: 0, mouthRight: 0, mouthRollLower: 0, mouthRollUpper: 0,
+  mouthShrugLower: 0, mouthShrugUpper: 0, mouthSmileLeft: 0, mouthSmileRight: 0,
+  mouthStretchLeft: 0, mouthStretchRight: 0, mouthUpperUpLeft: 0, mouthUpperUpRight: 0,
+  noseSneerLeft: 0, noseSneerRight: 0, tongueOut: 0
+});
+
+/**
+ * Convert MediaPipe faceBlendshapes categories array to a flat record
+ */
+function buildBlendshapesRecord(categories) {
+  const record = {};
+  for (const cat of categories) {
+    record[cat.categoryName] = cat.score;
+  }
+  return record;
+}
+
+/**
+ * EMFACS-based emotion prototype vectors (Ekman FACS → ARKit blendshapes).
+ * Weights reflect each blendshape's reliability in MediaPipe's 2D web model.
+ * Known near-zero blendshapes (cheekSquint*, noseSneer*, eyeWide*) are
+ * down-weighted and supplemented by correlated signals that do activate.
+ *
+ * Reference: Aldenhoven et al. (2026) "Real-Time Emotion Recognition
+ * Performance of Mobile Devices" — EMFACS cosine similarity approach,
+ * 68.3% accuracy on 7 emotions, exceeding human raters (58.9%).
+ */
+const EMOTION_PROTOTYPES = {
+  // mouthSmile is unique to happiness — no other emotion uses it.
+  // eyeSquint is a secondary "Duchenne smile" indicator.
+  happy: {
+    mouthSmileLeft: 1.0, mouthSmileRight: 1.0,
+    eyeSquintLeft: 0.3, eyeSquintRight: 0.3
+  },
+  // Pouty/trembling lip: mouthShrugLower (chin raiser) is the primary signal,
+  // mouthPucker (compressed lips) secondary. Compact prototype so it wins
+  // over angry when the differentiating upper-face signals are absent.
+  sad: {
+    mouthShrugLower: 1.0,
+    mouthPucker: 0.8
+  },
+  // Shares sad's mouth signals at lower weight, differentiated by upper-face
+  // tension: eyeSquint + browDown. These extra dimensions shift the cosine
+  // direction away from sad only when genuinely activated.
+  angry: {
+    mouthShrugLower: 0.6, mouthPucker: 0.5,
+    eyeSquintLeft: 1.0, eyeSquintRight: 1.0,
+    browDownLeft: 1.0, browDownRight: 1.0
+  },
+  // Brow raise only — the simplest, most distinctive prototype.
+  // jawOpen removed to avoid overlap with fearful.
+  surprised: {
+    browInnerUp: 1.0,
+    browOuterUpLeft: 1.0, browOuterUpRight: 1.0
+  },
+  // mouthUpperUp (upper lip raise) is the unique primary signal.
+  // mouthFrown supports, browDown at low weight for wrinkled-brow disgust.
+  disgusted: {
+    mouthUpperUpLeft: 1.0, mouthUpperUpRight: 1.0,
+    mouthFrownLeft: 0.8, mouthFrownRight: 0.8,
+    browDownLeft: 0.3, browDownRight: 0.3
+  },
+  // Shares surprised's brow raise, differentiated by jawOpen (rare in other
+  // emotions at even 10-20%). jawOpen is the primary differentiator.
+  fearful: {
+    browInnerUp: 0.8, browOuterUpLeft: 0.8, browOuterUpRight: 0.8,
+    jawOpen: 1.0
+  }
+};
+
+const PROTOTYPE_KEYS = Object.keys(EMPTY_BLENDSHAPES);
+
+// Pre-compute prototype magnitudes for cosine similarity
+const PROTOTYPE_MAGNITUDES = {};
+for (const [emotion, proto] of Object.entries(EMOTION_PROTOTYPES)) {
+  let sumSq = 0;
+  for (const key of PROTOTYPE_KEYS) {
+    const v = proto[key] || 0;
+    sumSq += v * v;
+  }
+  PROTOTYPE_MAGNITUDES[emotion] = Math.sqrt(sumSq);
+}
+
+// Noise floor: blendshape values below this are treated as zero to
+// prevent resting-state activations from matching emotion prototypes
+const BLENDSHAPE_NOISE_FLOOR = 0.10;
+
+/**
+ * Cosine similarity between observed blendshape vector and a prototype.
+ * cos(v, p) = (v · p) / (|v| * |p|)
+ * Applies a noise floor to observed values to suppress resting-state noise.
+ */
+function emotionCosineSimilarity(observed, prototype, protoMag) {
+  let dot = 0;
+  let magO = 0;
+  for (const key of PROTOTYPE_KEYS) {
+    const raw = observed[key] || 0;
+    const o = raw > BLENDSHAPE_NOISE_FLOOR ? raw : 0;
+    const p = prototype[key] || 0;
+    dot += o * p;
+    magO += o * o;
+  }
+  magO = Math.sqrt(magO);
+  if (magO < 1e-8 || protoMag < 1e-8) return 0;
+  return dot / (magO * protoMag);
+}
+
+// Cross-suppression: when one emotion is confident, competing emotions are
+// reduced. Uses raw (pre-suppression) scores so order doesn't matter.
+// [suppressor] → { [target]: strength 0-1 }
+const EMOTION_INHIBITIONS = {
+  happy:     { angry: 0.7, sad: 0.5, disgusted: 0.4, fearful: 0.3 },
+  sad:       { happy: 0.3, angry: 0.2 },
+  angry:     { happy: 0.3, sad: 0.2 },
+  surprised: { angry: 0.3, sad: 0.3 },
+  disgusted: { happy: 0.4, surprised: 0.2 },
+  fearful:   { happy: 0.3, angry: 0.2 }
+};
+
+/**
+ * Classify observed blendshapes into emotions using a 3-stage pipeline:
+ *   1. Cosine similarity against EMFACS prototypes (base scores)
+ *   2. Key-signal boosters for defining blendshapes (mouthPress → angry)
+ *   3. Cross-emotion inhibition matrix (happy suppresses angry, etc.)
+ *
+ * Returns { neutral, happy, sad, angry, surprised, disgusted, fearful }
+ */
+function mapBlendshapesToEmotions(bs) {
+  const NF = BLENDSHAPE_NOISE_FLOOR;
+
+  // --- Stage 1: Cosine similarity base scores ---
+  const scores = {};
+  for (const [emotion, proto] of Object.entries(EMOTION_PROTOTYPES)) {
+    scores[emotion] = Math.max(0, emotionCosineSimilarity(bs, proto, PROTOTYPE_MAGNITUDES[emotion]));
+  }
+
+  // --- Stage 2: Key-signal boosters ---
+  // mouthPress is a defining angry signal not in the prototype (to avoid
+  // resting-state contamination) but boosts angry when clearly present
+  const mouthPress = Math.max(0,
+    ((bs.mouthPressLeft || 0) + (bs.mouthPressRight || 0)) / 2 - NF);
+  if (mouthPress > 0) {
+    scores.angry = Math.min(1, scores.angry + mouthPress * 0.3);
+  }
+
+  // --- Stage 3: Cross-emotion inhibition ---
+  // Snapshot raw scores so suppression is non-circular
+  const raw = {};
+  for (const key in scores) raw[key] = scores[key];
+
+  for (const [suppressor, targets] of Object.entries(EMOTION_INHIBITIONS)) {
+    const suppressorScore = raw[suppressor] || 0;
+    if (suppressorScore > 0.1) {
+      for (const [target, strength] of Object.entries(targets)) {
+        scores[target] *= (1 - suppressorScore * strength);
+      }
+    }
+  }
+
+  // --- Neutral: dominant when no emotion is confident ---
+  let maxScore = 0;
+  for (const emotion of Object.keys(EMOTION_PROTOTYPES)) {
+    if (scores[emotion] > maxScore) maxScore = scores[emotion];
+  }
+  const neutralThreshold = 0.35;
+  scores.neutral = maxScore < neutralThreshold ? 1.0 : Math.max(0, 1.0 - maxScore * 1.5);
+
+  return {
+    neutral: scores.neutral,
+    happy: scores.happy || 0,
+    sad: scores.sad || 0,
+    angry: scores.angry || 0,
+    surprised: scores.surprised || 0,
+    disgusted: scores.disgusted || 0,
+    fearful: scores.fearful || 0
+  };
+}
+
+/**
+ * Compute head pose (pitch, yaw, roll in degrees) from 468 face landmarks.
+ * Uses nose tip, chin, eye corners, and forehead to derive 3D orientation.
+ */
+function computeHeadPoseFromLandmarks(landmarks) {
+  // Key landmark indices (MediaPipe FaceMesh)
+  const noseTip = landmarks[1];
+  const chin = landmarks[152];
+  const leftEye = landmarks[33];
+  const rightEye = landmarks[263];
+  const forehead = landmarks[10];
+
+  if (!noseTip || !chin || !leftEye || !rightEye || !forehead) {
+    return { pitch: 0, yaw: 0, roll: 0 };
+  }
+
+  // Yaw: horizontal angle from eye midpoint to nose tip
+  const eyeMidX = (leftEye.x + rightEye.x) / 2;
+  const eyeMidY = (leftEye.y + rightEye.y) / 2;
+  const yaw = Math.atan2(noseTip.x - eyeMidX, Math.abs(noseTip.z - ((leftEye.z + rightEye.z) / 2 || 0)) + 0.001) * (180 / Math.PI);
+
+  // Pitch: vertical angle from forehead to chin through nose
+  const faceVerticalLen = Math.sqrt((chin.x - forehead.x) ** 2 + (chin.y - forehead.y) ** 2) || 0.001;
+  const noseRelY = (noseTip.y - forehead.y) / faceVerticalLen;
+  const pitch = (noseRelY - 0.5) * 180;
+
+  // Roll: tilt from horizontal eye line
+  const roll = Math.atan2(rightEye.y - leftEye.y, rightEye.x - leftEye.x) * (180 / Math.PI);
+
+  return {
+    pitch: isNaN(pitch) ? 0 : Math.max(-90, Math.min(90, pitch)),
+    yaw: isNaN(yaw) ? 0 : Math.max(-90, Math.min(90, yaw)),
+    roll: isNaN(roll) ? 0 : Math.max(-180, Math.min(180, roll))
+  };
+}
+
+/**
+ * Initialize MediaPipe Tasks Vision runtime
+ */
+async function initializeVision() {
+  if (isInitialized) {
+    log('Vision already initialized, skipping');
+    return;
+  }
+  
+  try {
+    log('Starting MediaPipe Tasks Vision initialization...');
+    
+    const wasmBasePath = '/dist/assets/wasm';
+    log('WASM base path:', wasmBasePath);
+    
+    const FilesetResolver = self.FilesetResolver || self.module.exports.FilesetResolver || self.exports.FilesetResolver;
+    log('FilesetResolver found:', !!FilesetResolver);
+    
+    if (!FilesetResolver) {
+      throw new Error('FilesetResolver not found in any expected location');
+    }
+    
+    vision = await FilesetResolver.forVisionTasks(wasmBasePath);
+    
+    isInitialized = true;
+    log('✅ MediaPipe Tasks Vision initialized successfully');
+  } catch (error) {
+    log('❌ Failed to initialize MediaPipe Tasks Vision:', error);
+    throw error;
+  }
+}
+
+/**
+ * Load and initialize Face Detection
+ */
+async function initializeFaceDetection() {
+  if (faceDetector) return;
+  
+  // Ensure vision runtime is initialized first
+  await initializeVision();
+  
+  try {
+    log('Loading Face Detector...');
+    
+    const options = {
+      baseOptions: {
+        modelAssetPath: 'https://storage.googleapis.com/mediapipe-models/face_detector/blaze_face_short_range/float16/1/blaze_face_short_range.tflite',
+        delegate: 'GPU'
+      },
+      runningMode: 'VIDEO',
+      minDetectionConfidence: 0.5,
+      minSuppressionThreshold: 0.3
+    };
+    
+    const FaceDetector = self.FaceDetector || self.module.exports.FaceDetector || self.exports.FaceDetector;
+    faceDetector = await FaceDetector.createFromOptions(vision, options);
+    log('✅ Face Detector loaded');
+  } catch (error) {
+    log('❌ Failed to load Face Detector:', error);
+    throw error;
+  }
+}
+
+/**
+ * Load and initialize Face Landmarks
+ */
+async function initializeFaceLandmarks() {
+  if (faceLandmarker) return;
+  
+  // Ensure vision runtime is initialized first
+  await initializeVision();
+  
+  try {
+    log('Loading Face Landmarker...');
+    
+    const options = {
+      baseOptions: {
+        modelAssetPath: 'https://storage.googleapis.com/mediapipe-models/face_landmarker/face_landmarker/float16/1/face_landmarker.task',
+        delegate: 'GPU'
+      },
+      runningMode: 'VIDEO',
+      numFaces: 1,
+      outputFaceBlendshapes: true
+    };
+    
+    const FaceLandmarker = self.FaceLandmarker || self.module.exports.FaceLandmarker || self.exports.FaceLandmarker;
+    faceLandmarker = await FaceLandmarker.createFromOptions(vision, options);
+    log('✅ Face Landmarker loaded (blendshapes enabled)');
+  } catch (error) {
+    log('❌ Failed to load Face Landmarker:', error);
+    throw error;
+  }
+}
+
+/**
+ * Load and initialize Hand Tracking
+ */
+async function initializeHandTracking() {
+  if (handLandmarker) return;
+  
+  // Ensure vision runtime is initialized first
+  await initializeVision();
+  
+  try {
+    log('Loading Hand Landmarker...');
+    
+    const options = {
+      baseOptions: {
+        modelAssetPath: 'https://storage.googleapis.com/mediapipe-models/hand_landmarker/hand_landmarker/float16/1/hand_landmarker.task',
+        delegate: 'GPU'
+      },
+      runningMode: 'VIDEO',
+      numHands: 2
+    };
+    
+    const HandLandmarker = self.HandLandmarker || self.module.exports.HandLandmarker || self.exports.HandLandmarker;
+    handLandmarker = await HandLandmarker.createFromOptions(vision, options);
+    log('✅ Hand Landmarker loaded');
+  } catch (error) {
+    log('❌ Failed to load Hand Landmarker:', error);
+    throw error;
+  }
+}
+
+/**
+ * Load and initialize Pose Detection
+ */
+async function initializePoseDetection() {
+  if (poseLandmarker) return;
+  
+  // Ensure vision runtime is initialized first
+  await initializeVision();
+  
+  try {
+    log('Loading Pose Landmarker...');
+    
+    const options = {
+      baseOptions: {
+        modelAssetPath: 'https://storage.googleapis.com/mediapipe-models/pose_landmarker/pose_landmarker_lite/float16/1/pose_landmarker_lite.task',
+        delegate: 'GPU'
+      },
+      runningMode: 'VIDEO',
+      numPoses: 1
+    };
+    
+    const PoseLandmarker = self.PoseLandmarker || self.module.exports.PoseLandmarker || self.exports.PoseLandmarker;
+    poseLandmarker = await PoseLandmarker.createFromOptions(vision, options);
+    log('✅ Pose Landmarker loaded');
+  } catch (error) {
+    log('❌ Failed to load Pose Landmarker:', error);
+    throw error;
+  }
+}
+
+/**
+ * Load and initialize Body Segmentation
+ */
+async function initializeBodySegmentation() {
+  if (imageSegmenter) return;
+  
+  // Ensure vision runtime is initialized first
+  await initializeVision();
+  
+  try {
+    log('Loading Image Segmenter...');
+    
+      const options = {
+        baseOptions: {
+          modelAssetPath: 'https://storage.googleapis.com/mediapipe-models/image_segmenter/selfie_segmenter/float16/1/selfie_segmenter.tflite',
+          delegate: 'GPU'
+        },
+        runningMode: 'IMAGE',
+        outputCategoryMask: true,
+        outputConfidenceMasks: false
+      };
+    
+    const ImageSegmenter = self.ImageSegmenter || self.module.exports.ImageSegmenter || self.exports.ImageSegmenter;
+    imageSegmenter = await ImageSegmenter.createFromOptions(vision, options);
+    log('✅ Image Segmenter loaded');
+  } catch (error) {
+    log('❌ Failed to load Image Segmenter:', error);
+    throw error;
+  }
+}
+
+/**
+ * Process video frame with active CV features
+ * @param {ImageData|ImageBitmap} imageInput - Image input (ImageData or ImageBitmap)
+ * @param {number} timestamp - Frame timestamp  
+ * @param {string[]} features - Active CV features
+ */
+async function processFrame(imageInput, timestamp, features) {
+  const results = {};
+  
+  try {
+    // Process face detection
+    if (features.includes('faceDetection') && faceDetector) {
+      const detectionResult = faceDetector.detectForVideo(imageInput, timestamp);
+      results.faces = detectionResult.detections.map((detection) => ({
+        bounds: {
+          x: detection.boundingBox.originX / imageInput.width,
+          y: detection.boundingBox.originY / imageInput.height,
+          width: detection.boundingBox.width / imageInput.width,
+          height: detection.boundingBox.height / imageInput.height
+        },
+        center: {
+          x: (detection.boundingBox.originX + detection.boundingBox.width / 2) / imageInput.width,
+          y: (detection.boundingBox.originY + detection.boundingBox.height / 2) / imageInput.height
+        },
+        landmarks: [],
+        expressions: EMPTY_EXPRESSIONS,
+        headPose: EMPTY_HEAD_POSE,
+        blendshapes: EMPTY_BLENDSHAPES,
+        confidence: detection.categories[0]?.score || 0
+      }));
+    }
+    
+    // Process face landmarks (used by faceMesh and emotionDetection)
+    if ((features.includes('faceMesh') || features.includes('emotionDetection')) && faceLandmarker) {
+      const landmarkResult = faceLandmarker.detectForVideo(imageInput, timestamp);
+      if (landmarkResult.faceLandmarks.length > 0) {
+        const landmarks = landmarkResult.faceLandmarks[0];
+        
+        if (!results.faces) {
+          results.faces = [{
+            bounds: null,
+            center: null,
+            landmarks: [],
+            expressions: EMPTY_EXPRESSIONS,
+            headPose: EMPTY_HEAD_POSE,
+            blendshapes: EMPTY_BLENDSHAPES,
+            confidence: 0.8
+          }];
+        }
+        
+        const mappedLandmarks = landmarks.map((landmark) => ({
+          x: landmark.x,
+          y: landmark.y,
+          z: landmark.z || 0
+        }));
+
+        if (results.faces[0]) {
+          results.faces[0].landmarks = mappedLandmarks;
+          results.faces[0].headPose = computeHeadPoseFromLandmarks(landmarks);
+
+          // Populate emotion data when emotionDetection is active
+          if (features.includes('emotionDetection') &&
+              landmarkResult.faceBlendshapes &&
+              landmarkResult.faceBlendshapes.length > 0) {
+            const bs = buildBlendshapesRecord(landmarkResult.faceBlendshapes[0].categories);
+            results.faces[0].blendshapes = bs;
+            results.faces[0].expressions = mapBlendshapesToEmotions(bs);
+          }
+        }
+      }
+    }
+    
+    // Process hand tracking
+    if (features.includes('handTracking') && handLandmarker) {
+      const handResult = handLandmarker.detectForVideo(imageInput, timestamp);
+      results.hands = handResult.landmarks.map((landmarks, index) => ({
+        landmarks: landmarks.map((landmark) => ({
+          x: landmark.x,
+          y: landmark.y,
+          z: landmark.z || 0
+        })),
+        handedness: handResult.handednesses[index]?.[0]?.categoryName || 'Unknown',
+        confidence: handResult.handednesses[index]?.[0]?.score || 0
+      }));
+    }
+    
+    // Process pose detection
+    if (features.includes('poseDetection') && poseLandmarker) {
+      const poseResult = poseLandmarker.detectForVideo(imageInput, timestamp);
+      if (poseResult.landmarks.length > 0) {
+        results.pose = {
+          landmarks: poseResult.landmarks[0].map((landmark) => ({
+            x: landmark.x,
+            y: landmark.y,
+            z: landmark.z || 0,
+            visibility: landmark.visibility || 1
+          })),
+          worldLandmarks: poseResult.worldLandmarks?.[0]?.map((landmark) => ({
+            x: landmark.x,
+            y: landmark.y,
+            z: landmark.z || 0,
+            visibility: landmark.visibility || 1
+          })) || []
+        };
+      }
+    }
+    
+    // Process body segmentation
+    if (features.includes('bodySegmentation') && imageSegmenter) {
+      const segmentResult = imageSegmenter.segment(imageInput);
+      if (segmentResult.categoryMask) {
+        try {
+          // Extract data before closing the mask
+          results.segmentation = {
+            mask: segmentResult.categoryMask.getAsUint8Array(),
+            width: segmentResult.categoryMask.width,
+            height: segmentResult.categoryMask.height
+          };
+          
+          log('Segmentation mask:', results.segmentation.width, 'x', results.segmentation.height);
+        } finally {
+          // CRITICAL: Close MPMask instance to prevent resource leaks
+          segmentResult.categoryMask.close();
+        }
+      }
+    }
+    
+    return results;
+  } catch (error) {
+    log('❌ Error processing frame:', error);
+    return {};
+  }
+}
+
+// Note: Removed reusable canvas functions - no longer needed with direct ImageBitmap processing!
+
+/**
+ * Clean up WASM instance with proper memory management
+ */
+function cleanupWasmInstance(instance, featureName) {
+  if (instance) {
+    try {
+      log(`🧹 Cleaning up ${featureName} WASM instance...`);
+      instance.close();
+      
+      // Force garbage collection if available (Chrome DevTools)
+      if (typeof gc === 'function') {
+        gc();
+      }
+      
+      // Give time for WASM cleanup
+      return new Promise(resolve => {
+        setTimeout(resolve, 100);
+      });
+    } catch (error) {
+      log(`⚠️ Error cleaning up ${featureName}:`, error);
+    }
+  }
+  return Promise.resolve();
+}
+
+/**
+ * Process configuration queue sequentially
+ */
+async function processConfigQueue() {
+  if (processingConfig || configQueue.length === 0) return;
+  
+  processingConfig = true;
+  
+  try {
+    while (configQueue.length > 0) {
+      const { features, resolve, reject } = configQueue.shift();
+      
+      try {
+        await handleConfigUpdateInternal(features);
+        resolve({ configured: true, activeFeatures: Array.from(activeFeatures) });
+      } catch (error) {
+        reject(error);
+      }
+    }
+  } finally {
+    processingConfig = false;
+  }
+}
+
+/**
+ * Queue configuration update to prevent race conditions
+ */
+function queueConfigUpdate(features) {
+  return new Promise((resolve, reject) => {
+    configQueue.push({ features, resolve, reject });
+    processConfigQueue();
+  });
+}
+
+/**
+ * Handle feature configuration updates (internal)
+ */
+async function handleConfigUpdateInternal(features) {
+  if (!workerHealthy) {
+    throw new Error('Worker is in unhealthy state, restart required');
+  }
+  
+  const newFeatures = new Set(features);
+  const toEnable = features.filter(f => !activeFeatures.has(f));
+  const toDisable = Array.from(activeFeatures).filter(f => !newFeatures.has(f));
+  
+  log(`🔄 Config update: enable [${toEnable.join(', ')}], disable [${toDisable.join(', ')}]`);
+  
+  // Disable unused features first (cleanup instances)
+  const cleanupPromises = [];
+  for (const feature of toDisable) {
+    switch (feature) {
+      case 'faceDetection':
+        cleanupPromises.push(cleanupWasmInstance(faceDetector, 'FaceDetector'));
+        faceDetector = null;
+        break;
+      case 'faceMesh':
+        // Only teardown FaceLandmarker if emotionDetection also not active
+        if (!newFeatures.has('emotionDetection')) {
+          cleanupPromises.push(cleanupWasmInstance(faceLandmarker, 'FaceLandmarker'));
+          faceLandmarker = null;
+        }
+        break;
+      case 'emotionDetection':
+        // Only teardown FaceLandmarker if faceMesh also not active
+        if (!newFeatures.has('faceMesh')) {
+          cleanupPromises.push(cleanupWasmInstance(faceLandmarker, 'FaceLandmarker'));
+          faceLandmarker = null;
+        }
+        break;
+      case 'handTracking':
+        cleanupPromises.push(cleanupWasmInstance(handLandmarker, 'HandLandmarker'));
+        handLandmarker = null;
+        break;
+      case 'poseDetection':
+        cleanupPromises.push(cleanupWasmInstance(poseLandmarker, 'PoseLandmarker'));
+        poseLandmarker = null;
+        break;
+      case 'bodySegmentation':
+        cleanupPromises.push(cleanupWasmInstance(imageSegmenter, 'ImageSegmenter'));
+        imageSegmenter = null;
+        break;
+    }
+    activeFeatures.delete(feature);
+    log(`🗑️ Disabled feature: ${feature}`);
+  }
+  
+  // Wait for all cleanup to complete
+  if (cleanupPromises.length > 0) {
+    await Promise.all(cleanupPromises);
+    log('✅ All cleanup completed');
+  }
+  
+  // Note: No canvas cleanup needed - using direct ImageBitmap processing!
+  
+  // Enable new features
+  for (const feature of toEnable) {
+    try {
+      switch (feature) {
+        case 'faceDetection':
+          await initializeFaceDetection();
+          break;
+        case 'faceMesh':
+        case 'emotionDetection':
+          // Both share the FaceLandmarker (with blendshapes enabled)
+          await initializeFaceLandmarks();
+          break;
+        case 'handTracking':
+          await initializeHandTracking();
+          break;
+        case 'poseDetection':
+          await initializePoseDetection();
+          break;
+        case 'bodySegmentation':
+          await initializeBodySegmentation();
+          break;
+      }
+      activeFeatures.add(feature);
+      log(`✅ Enabled feature: ${feature}`);
+    } catch (error) {
+      log(`❌ Failed to enable feature ${feature}:`, error);
+      
+      // Check if this is a memory error
+      if (error.message && error.message.includes('Out of memory')) {
+        memoryPressureDetected = true;
+        workerHealthy = false;
+        throw new Error(`Memory exhausted while enabling ${feature}. Worker restart required.`);
+      }
+      
+      throw error;
+    }
+  }
+}
+
+/**
+ * Legacy function for backward compatibility
+ */
+async function handleConfigUpdate(features) {
+  return await queueConfigUpdate(features);
+}
+
+// Message handler
+self.onmessage = async (event) => {
+  const message = event.data;
+  
+  // Only log non-process messages to avoid per-frame spam
+  if (message.type !== 'process') {
+    log('Received message:', message.type);
+  }
+  
+  try {
+    switch (message.type) {
+      case 'debug': {
+        DEBUG = !!message.enabled;
+        log('Debug mode', DEBUG ? 'enabled' : 'disabled');
+        break;
+      }
+      
+      case 'init': {
+        log('Received init message');
+        
+        try {
+          await initializeVision();
+          log('Vision runtime ready for feature loading');
+        } catch (error) {
+          log('❌ Vision runtime initialization failed:', error);
+          throw error;
+        }
+        
+        const response = {
+          type: 'result',
+          success: true,
+          data: { initialized: true }
+        };
+        self.postMessage(response);
+        break;
+      }
+      
+      case 'config': {
+        log('Received config message:', message.features);
+        
+        try {
+          const result = await handleConfigUpdate(message.features);
+          
+          const response = {
+            type: 'result',
+            success: true,
+            data: result
+          };
+          self.postMessage(response);
+        } catch (error) {
+          log('❌ Config update failed:', error);
+          
+          // Check if worker needs restart
+          if (!workerHealthy || memoryPressureDetected) {
+            const errorResponse = {
+              type: 'result',
+              success: false,
+              error: error.message,
+              restartRequired: true
+            };
+            self.postMessage(errorResponse);
+          } else {
+            throw error; // Re-throw for normal error handling
+          }
+        }
+        break;
+      }
+      
+      case 'process': {
+        try {
+          // 🚀 OPTIMIZED: Pass ImageBitmap directly to MediaPipe (no conversion!)
+          const results = await processFrame(message.bitmap, message.timestamp, message.features);
+          
+          const response = {
+            type: 'result',
+            success: true,
+            data: results
+          };
+          self.postMessage(response);
+        } finally {
+          // Clean up ImageBitmap after processing
+          if (message.bitmap && typeof message.bitmap.close === 'function') {
+            message.bitmap.close();
+          }
+        }
+        break;
+      }
+      
+      default:
+        log('❌ Unknown message type:', message.type);
+        const errorResponse = {
+          type: 'result',
+          success: false,
+          error: `Unknown message type: ${message.type}`
+        };
+        self.postMessage(errorResponse);
+    }
+  } catch (error) {
+    log('❌ Error handling message:', error);
+    const errorResponse = {
+      type: 'result',
+      success: false,
+      error: error instanceof Error ? error.message : String(error)
+    };
+    self.postMessage(errorResponse);
+  }
+};
+
+log('CV Tasks Worker initialized and ready');