node-mac-recorder 1.4.0 → 1.6.0

package/WINDOW_SELECTOR_README.md

@@ -14,6 +14,9 @@ Bu modül, macOS'ta sistem imleci ile pencere seçimi yapabilmenizi sağlayan g
 - **Event-driven API**: Pencere hover, seçim ve hata durumları için event'ler
 - **Window Focus Control**: Detect edilen pencereyi otomatik olarak en öne getirir
 - **Auto Bring-to-Front**: Cursor hangi pencereye gelirse otomatik focus yapar
+- **Recording Preview Overlay**: Kayıt alanını görselleştiren tam ekran overlay sistemi
+- **Screen Selection**: Tam ekran overlay ile ekran seçimi (menu bar dahil)
+- **Screen Recording Preview**: Seçilen ekran için kayıt önizleme sistemi
 - **Permission Management**: macOS izin kontrolü ve yönetimi
 
 ## 🚀 Kurulum
@@ -175,6 +178,84 @@ selector.setBringToFrontEnabled(true);  // Auto mode ON
 selector.setBringToFrontEnabled(false); // Auto mode OFF
 ```
 
+##### `async showRecordingPreview(windowInfo)`
+Seçilen pencere için kayıt önizleme overlay'ini gösterir. Tüm ekranı siyah yapar, sadece pencere alanını şeffaf bırakır.
+
+**Parameters:**
+- `windowInfo` (WindowInfo) - Pencere bilgileri
+
+**Returns:** `Promise<boolean>` - Başarı/başarısızlık
+
+```javascript
+const success = await selector.showRecordingPreview(selectedWindow);
+```
+
+##### `async hideRecordingPreview()`
+Kayıt önizleme overlay'ini gizler.
+
+**Returns:** `Promise<boolean>` - Başarı/başarısızlık
+
+```javascript
+const success = await selector.hideRecordingPreview();
+```
+
+##### `async startScreenSelection()`
+Ekran seçim modunu başlatır. Tüm ekranları overlay ile gösterir.
+
+**Returns:** `Promise<boolean>` - Başarı/başarısızlık
+
+```javascript
+const success = await selector.startScreenSelection();
+```
+
+##### `async stopScreenSelection()`
+Ekran seçim modunu durdurur.
+
+**Returns:** `Promise<boolean>` - Başarı/başarısızlık
+
+```javascript
+const success = await selector.stopScreenSelection();
+```
+
+##### `getSelectedScreen()`
+Son seçilen ekran bilgisini döndürür.
+
+**Returns:** `ScreenInfo | null`
+
+```javascript
+const screenInfo = selector.getSelectedScreen();
+```
+
+##### `async selectScreen()`
+Promise tabanlı ekran seçimi. Kullanıcı bir ekran seçene kadar bekler.
+
+**Returns:** `Promise<ScreenInfo>`
+
+```javascript
+const selectedScreen = await selector.selectScreen();
+```
+
+##### `async showScreenRecordingPreview(screenInfo)`
+Seçilen ekran için kayıt önizleme overlay'ini gösterir. Diğer ekranları siyah yapar, sadece seçili ekranı şeffaf bırakır.
+
+**Parameters:**
+- `screenInfo` (ScreenInfo) - Ekran bilgileri
+
+**Returns:** `Promise<boolean>` - Başarı/başarısızlık
+
+```javascript
+const success = await selector.showScreenRecordingPreview(selectedScreen);
+```
+
+##### `async hideScreenRecordingPreview()`
+Ekran kayıt önizleme overlay'ini gizler.
+
+**Returns:** `Promise<boolean>` - Başarı/başarısızlık
+
+```javascript
+const success = await selector.hideScreenRecordingPreview();
+```
+
 ##### `async cleanup()`
 Tüm kaynakları temizler ve seçimi durdurur.
 
@@ -267,6 +348,20 @@ selector.on('error', (error) => {
 }
 ```
 
+### ScreenInfo
+```javascript
+{
+    id: number,          // Ekran ID'si (0, 1, 2, ...)
+    name: string,        // Ekran adı ("Display 1", "Display 2", ...)
+    x: number,          // Global X pozisyonu
+    y: number,          // Global Y pozisyonu
+    width: number,      // Ekran genişliği
+    height: number,     // Ekran yüksekliği
+    resolution: string, // Çözünürlük string'i ("1920x1080")
+    isPrimary: boolean  // Ana ekran mı?
+}
+```
+
 ## 🎮 Test Etme
 
 ### Test Dosyasını Çalıştır
@@ -298,6 +393,7 @@ node examples/window-selector-example.js --help
 
 ## ⚡ Nasıl Çalışır?
 
+### Pencere Seçim Süreci
 1. **Window Detection**: macOS `CGWindowListCopyWindowInfo` API'si ile açık pencereleri tespit eder
 2. **Cursor Tracking**: Real-time olarak imleç pozisyonunu takip eder
 3. **Overlay Rendering**: NSWindow ile transparant overlay penceresi oluşturur
@@ -306,6 +402,29 @@ node examples/window-selector-example.js --help
 6. **User Interaction**: Merkeze yerleştirilen button ile seçim yapar
 7. **Data Collection**: Seçilen pencerenin tüm bilgilerini toplar
 
+### Kayıt Önizleme Sistemi (Pencere)
+1. **Full Screen Overlay**: Tüm ekranı kaplayan siyah transparan katman oluşturur
+2. **Window Cutout**: Seçilen pencere alanını şeffaf hale getirir (cut-out effect)
+3. **Coordinate Conversion**: CGWindow koordinatlarını NSView koordinatlarına dönüştürür  
+4. **Multi-Display Support**: Çoklu ekran kurulumlarında doğru pozisyonlama yapar
+5. **Non-Interactive**: Mouse events'leri geçirir, kullanıcı etkileşimini engellemeZ
+6. **Clean Management**: Programatik açma/kapama kontrolü sağlar
+
+### Ekran Seçim Sistemi
+1. **Multi-Screen Detection**: NSScreen.screens ile tüm ekranları tespit eder
+2. **Full Screen Coverage**: Her ekran için tam kaplama overlay oluşturur (menu bar dahil)
+3. **Interactive Overlays**: Her ekranda merkezi "Select Screen" butonu
+4. **Screen Information Display**: Ekran adı ve çözünürlük bilgilerini gösterir
+5. **Automatic Assignment**: Her overlay'i kendi ekranına otomatik atar
+6. **Selection Feedback**: Seçim yapıldığında anında geri bildirim
+
+### Ekran Kayıt Önizleme Sistemi
+1. **Multi-Screen Management**: Birden fazla ekranı aynı anda yönetir
+2. **Selective Darkening**: Sadece seçilmeyen ekranları siyah overlay ile kaplar
+3. **Recording Area Highlight**: Seçilen ekran tamamen şeffaf kalır
+4. **Screen-Specific Overlays**: Her ekran için ayrı overlay penceresi
+5. **Coordinate Independence**: Her ekranın kendi koordinat sistemini kullanır
+
 ## 🔧 Troubleshooting
 
 ### Build Hataları
@@ -334,15 +453,15 @@ if (!permissions.screenRecording) {
 
 ## 🌟 Gelişmiş Örnekler
 
-### Auto Bring-to-Front (Otomatik Focus)
+### Auto Bring-to-Front (DEFAULT - Otomatik Focus)
 ```javascript
 const WindowSelector = require('./window-selector');
 
 async function autoBringToFront() {
     const selector = new WindowSelector();
     
-    // Otomatik focus modunu aktif et
-    selector.setBringToFrontEnabled(true);
+    // Auto bring-to-front varsayılan olarak AÇIK
+    // (Kapatmak için: selector.setBringToFrontEnabled(false))
     
     selector.on('windowEntered', (window) => {
         console.log(`🔝 Auto-focused: ${window.appName} - "${window.title}"`);
@@ -350,6 +469,7 @@ async function autoBringToFront() {
     
     await selector.startSelection();
     console.log('🖱️ Move cursor over windows - they will come to front automatically!');
+    console.log('💡 Only the specific window focuses, not all windows of the app');
 }
 ```
 
@@ -374,7 +494,157 @@ async function manualFocus() {
 }
 ```
 
-### Otomatik Pencere Kaydı
+### Ekran Seçimi ile Kayıt
+```javascript
+const WindowSelector = require('./window-selector');
+const MacRecorder = require('./index');
+
+async function recordScreenWithPreview() {
+    const selector = new WindowSelector();
+    const recorder = new MacRecorder();
+    
+    try {
+        // Ekran seç
+        const screen = await selector.selectScreen();
+        console.log(`Selected: ${screen.name} (${screen.resolution})`);
+        
+        // Kayıt önizlemesi göster (diğer ekranlar siyah, seçili ekran şeffaf)
+        await selector.showScreenRecordingPreview(screen);
+        console.log('🎬 Screen recording preview shown');
+        
+        // 3 saniye bekle
+        await new Promise(resolve => setTimeout(resolve, 3000));
+        
+        // Ekran kaydını başlat
+        const outputPath = `./recordings/screen-${screen.id}-${Date.now()}.mov`;
+        await recorder.startRecording(outputPath, {
+            displayId: screen.id,
+            captureCursor: true,
+            includeMicrophone: true
+        });
+        
+        console.log('🔴 Screen recording started...');
+        
+        // 10 saniye kaydet
+        setTimeout(async () => {
+            await recorder.stopRecording();
+            
+            // Önizleme overlay'ini gizle
+            await selector.hideScreenRecordingPreview();
+            console.log(`✅ Recording saved: ${outputPath}`);
+        }, 10000);
+        
+    } finally {
+        await selector.cleanup();
+    }
+}
+```
+
+### Kayıt Önizleme ile Pencere Kaydı
+```javascript
+const WindowSelector = require('./window-selector');
+const MacRecorder = require('./index');
+
+async function recordWithPreview() {
+    const selector = new WindowSelector();
+    const recorder = new MacRecorder();
+    
+    try {
+        // Pencere seç
+        const window = await selector.selectWindow();
+        console.log(`Selected: ${window.title}`);
+        
+        // Kayıt önizlemesi göster (siyah overlay + şeffaf pencere alanı)
+        await selector.showRecordingPreview(window);
+        console.log('🎬 Recording preview shown - you can see exact recording area');
+        
+        // 3 saniye bekle (kullanıcı görebilsin)
+        await new Promise(resolve => setTimeout(resolve, 3000));
+        
+        // Kaydı başlat
+        const outputPath = `./recordings/${window.appName}-${Date.now()}.mov`;
+        await recorder.startRecording(outputPath, {
+            windowId: window.id,
+            captureCursor: true,
+            includeMicrophone: true
+        });
+        
+        console.log('🔴 Recording started...');
+        
+        // 10 saniye kaydet
+        setTimeout(async () => {
+            await recorder.stopRecording();
+            
+            // Önizleme overlay'ini gizle
+            await selector.hideRecordingPreview();
+            console.log(`✅ Recording saved: ${outputPath}`);
+        }, 10000);
+        
+    } finally {
+        await selector.cleanup();
+    }
+}
+```
+
+### Basit Ekran Seçimi
+```javascript
+const WindowSelector = require('./window-selector');
+
+async function selectScreen() {
+    const selector = new WindowSelector();
+    
+    try {
+        console.log('Bir ekran seçin...');
+        const selectedScreen = await selector.selectScreen();
+        
+        console.log('Seçilen ekran:', {
+            name: selectedScreen.name,
+            resolution: selectedScreen.resolution,
+            position: `(${selectedScreen.x}, ${selectedScreen.y})`,
+            isPrimary: selectedScreen.isPrimary
+        });
+        
+        return selectedScreen;
+        
+    } catch (error) {
+        console.error('Hata:', error.message);
+    } finally {
+        await selector.cleanup();
+    }
+}
+```
+
+### Manuel Ekran Kontrolü
+```javascript
+const WindowSelector = require('./window-selector');
+
+async function manualScreenSelection() {
+    const selector = new WindowSelector();
+    
+    try {
+        // Ekran seçimini başlat
+        await selector.startScreenSelection();
+        console.log('🖥️ Screen overlays shown - click Select Screen button');
+        
+        // Polling ile seçim bekle
+        const checkSelection = () => {
+            const selected = selector.getSelectedScreen();
+            if (selected) {
+                console.log(`✅ Screen selected: ${selected.name}`);
+                return selected;
+            }
+            setTimeout(checkSelection, 100);
+        };
+        
+        checkSelection();
+        
+    } catch (error) {
+        console.error('Hata:', error.message);
+    }
+}
+```
+
+### Otomatik Pencere Kaydı (Basit)
 ```javascript
 const WindowSelector = require('./window-selector');
 const MacRecorder = require('./index');
@@ -449,6 +719,7 @@ Bu modül ana projenin lisansı altındadır.
 
 ## ⭐ Özellik İstekleri
 
+### Pencere Seçimi
 - [ ] Pencere gruplandırma
 - [ ] Hotkey desteği  
 - [ ] Pencere filtreleme
@@ -456,6 +727,14 @@ Bu modül ana projenin lisansı altındadır.
 - [ ] Screenshot alma
 - [ ] Window history
 
+### Ekran Seçimi
+- [x] Tam ekran overlay (menu bar dahil) ✅
+- [x] Multi-display desteği ✅
+- [x] Kayıt önizleme sistemi ✅
+- [ ] Hotkey desteği
+- [ ] Çoklu ekran seçimi
+- [ ] Ekran thumbnail'ları
+
 ---
 
 **Not**: Bu modül sadece macOS'ta çalışır ve sistem izinleri gerektirir.

package/debug-test.js

@@ -0,0 +1,95 @@
+#!/usr/bin/env node
+
+const WindowSelector = require('./window-selector');
+
+async function debugTest() {
+    console.log('🔍 Debug Window Selector Test');
+    console.log('==============================\n');
+
+    const selector = new WindowSelector();
+
+    try {
+        // İzinleri kontrol et
+        console.log('📋 Checking permissions...');
+        const permissions = await selector.checkPermissions();
+        console.log('Permissions:', JSON.stringify(permissions, null, 2));
+        
+        if (!permissions.screenRecording || !permissions.accessibility) {
+            console.log('\n❌ MISSING PERMISSIONS!');
+            console.log('Please enable in System Preferences > Security & Privacy:');
+            console.log('   ✓ Screen Recording - Add Terminal/your IDE');
+            console.log('   ✓ Accessibility - Add Terminal/your IDE');
+            console.log('\nAfter enabling permissions, restart this test.');
+            return;
+        }
+
+        console.log('✅ Permissions OK\n');
+
+        // Debug mode ile başlat
+        console.log('🚀 Starting selection with debug info...');
+        await selector.startSelection();
+        
+        let windowCount = 0;
+
+        selector.on('windowEntered', (window) => {
+            windowCount++;
+            console.log(`\n[${windowCount}] 🎯 WINDOW DETECTED:`);
+            console.log(`    App: ${window.appName}`);
+            console.log(`    Title: "${window.title}"`);
+            console.log(`    ID: ${window.id}`);
+            console.log(`    Position: (${window.x}, ${window.y})`);
+            console.log(`    Size: ${window.width} × ${window.height}`);
+            console.log(`    🔝 Should auto-focus now...`);
+        });
+
+        selector.on('windowLeft', (window) => {
+            console.log(`\n🚪 LEFT WINDOW: ${window.appName} - "${window.title}"`);
+        });
+
+        selector.on('error', (error) => {
+            console.error('\n❌ ERROR:', error.message);
+        });
+
+        console.log('📋 Test Instructions:');
+        console.log('   1. Move cursor over different application windows');
+        console.log('   2. You should see:');
+        console.log('      - Blue overlay rectangle around windows');
+        console.log('      - "Select Window" button in center');
+        console.log('      - Windows automatically coming to front');
+        console.log('   3. If overlay not visible, check permissions');
+        console.log('   4. Press Ctrl+C to exit\n');
+        console.log('🖱️  START MOVING CURSOR NOW...\n');
+
+        // Status monitoring
+        let statusCount = 0;
+        setInterval(() => {
+            statusCount++;
+            const status = selector.getStatus();
+            
+            if (statusCount % 50 === 0) { // Every 5 seconds
+                console.log(`⏱️  Status Check #${statusCount/50}:`);
+                console.log(`   - Selecting: ${status.isSelecting}`);
+                console.log(`   - Windows found: ${status.nativeStatus?.windowCount || 0}`);
+                console.log(`   - Overlay active: ${status.nativeStatus?.hasOverlay || false}`);
+                if (status.nativeStatus?.currentWindow) {
+                    console.log(`   - Current: ${status.nativeStatus.currentWindow.appName}`);
+                }
+                console.log('');
+            }
+        }, 100);
+
+    } catch (error) {
+        console.error('❌ Fatal Error:', error.message);
+        console.error(error.stack);
+    }
+}
+
+// Handle Ctrl+C gracefully
+process.on('SIGINT', async () => {
+    console.log('\n\n🛑 Stopping debug test...');
+    process.exit(0);
+});
+
+if (require.main === module) {
+    debugTest();
+}

package/default-auto-front-test.js

@@ -0,0 +1,86 @@
+#!/usr/bin/env node
+
+const WindowSelector = require('./window-selector');
+
+async function testDefaultAutoBringToFront() {
+    console.log('🔝 Default Auto Bring-To-Front Test');
+    console.log('====================================\n');
+
+    const selector = new WindowSelector();
+
+    try {
+        console.log('🚀 Starting window selector with DEFAULT auto bring-to-front...');
+        console.log('(Auto bring-to-front is now enabled by default)\n');
+        
+        console.log('📋 Instructions:');
+        console.log('   • Move cursor over different windows');
+        console.log('   • Each window should automatically come to front');
+        console.log('   • Only the specific window should focus (not whole app)');
+        console.log('   • Press D to disable auto mode');
+        console.log('   • Press E to re-enable auto mode');
+        console.log('   • Press Ctrl+C to exit\n');
+
+        let windowCount = 0;
+        let lastWindowId = null;
+
+        selector.on('windowEntered', (window) => {
+            if (window.id !== lastWindowId) {
+                windowCount++;
+                console.log(`[${windowCount}] 🎯 WINDOW: ${window.appName} - "${window.title}"`);
+                console.log(`    📍 Position: (${window.x}, ${window.y})`);
+                console.log(`    📏 Size: ${window.width} × ${window.height}`);
+                console.log(`    🔝 Should auto-focus THIS specific window only!`);
+                lastWindowId = window.id;
+            }
+        });
+
+        selector.on('windowLeft', (window) => {
+            console.log(`🚪 Left: ${window.appName} - "${window.title}"\n`);
+        });
+
+        // Keyboard controls
+        const readline = require('readline');
+        readline.emitKeypressEvents(process.stdin);
+        if (process.stdin.isTTY) {
+            process.stdin.setRawMode(true);
+        }
+
+        process.stdin.on('keypress', async (str, key) => {
+            if (key.name === 'd') {
+                console.log('\n🔄 Disabling auto bring-to-front...');
+                selector.setBringToFrontEnabled(false);
+                console.log('   ✅ Auto mode OFF - Windows will not auto-focus');
+            } else if (key.name === 'e') {
+                console.log('\n🔄 Enabling auto bring-to-front...');
+                selector.setBringToFrontEnabled(true);
+                console.log('   ✅ Auto mode ON - Windows will auto-focus again');
+            } else if (key.ctrl && key.name === 'c') {
+                console.log('\n\n🛑 Stopping...');
+                console.log(`📊 Total windows encountered: ${windowCount}`);
+                await selector.cleanup();
+                process.exit(0);
+            }
+        });
+
+        await selector.startSelection();
+
+        // Status update every 10 seconds
+        setInterval(() => {
+            console.log(`\n⏱️  Status: ${windowCount} windows encountered so far`);
+            console.log('   (Continue moving cursor over windows to test auto-focus)');
+        }, 10000);
+
+        // Keep running
+        setInterval(() => {}, 1000);
+
+    } catch (error) {
+        console.error('❌ Error:', error.message);
+        console.error(error.stack);
+    } finally {
+        await selector.cleanup();
+    }
+}
+
+if (require.main === module) {
+    testDefaultAutoBringToFront();
+}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "node-mac-recorder",
-	"version": "1.4.0",
+	"version": "1.6.0",
 	"description": "Native macOS screen recording package for Node.js applications",
 	"main": "index.js",
 	"keywords": [