واجهات برمجة Electron.js الشاملة

const { app } = require('electron')

// عند تهيئة التطبيق
console.log('بدء تشغيل التطبيق...')

// عند استعداد Electron
app.whenReady().then(() => {
  console.log('التطبيق جاهز الآن')
  createWindow() // دالة لإنشاء النافذة الرئيسية
})

// عند إغلاق جميع النوافذ
app.on('window-all-closed', () => {
  console.log('تم إغلاق جميع النوافذ')
  
  // في Windows و Linux، عادة ما يتم إغلاق التطبيق عند إغلاق كل النوافذ
  if (process.platform !== 'darwin') {
    app.quit()
  }
})

// في macOS، عند النقر على أيقونة الـ Dock
app.on('activate', () => {
  console.log('تم تنشيط التطبيق')
  
  // إعادة إنشاء النافذة إذا لم تكن موجودة
  if (BrowserWindow.getAllWindows().length === 0) {
    createWindow()
  }
})

// قبل إغلاق التطبيق
app.on('before-quit', () => {
  console.log('التطبيق على وشك الإغلاق، حفظ البيانات...')
  // يمكنك هنا حفظ البيانات أو إجراء عمليات التنظيف
})

// أثناء إغلاق التطبيق
app.on('will-quit', () => {
  console.log('التطبيق يتم إغلاقه الآن...')
})

// بعد إغلاق التطبيق
app.on('quit', (event, exitCode) => {
  console.log(`تم إغلاق التطبيق بكود الخروج: ${exitCode}`)
})

// مثال لاستخدام أحداث متنوعة من app

// منع فتح نسخ متعددة من التطبيق
const gotTheLock = app.requestSingleInstanceLock()

if (!gotTheLock) {
  // إذا كانت هناك نسخة أخرى قيد التشغيل، قم بإغلاق هذه النسخة
  app.quit()
} else {
  // هذه هي النسخة الرئيسية من التطبيق
  
  // عند محاولة تشغيل نسخة ثانية
  app.on('second-instance', (event, commandLine, workingDirectory) => {
    // إذا كان المستخدم يحاول فتح نسخة أخرى، ركز على النافذة الموجودة
    const mainWindow = BrowserWindow.getAllWindows()[0]
    if (mainWindow) {
      if (mainWindow.isMinimized()) mainWindow.restore()
      mainWindow.focus()
    }
  })
  
  // عند بدء الإغلاق
  let isQuitting = false
  
  app.on('before-quit', () => {
    isQuitting = true
    // يمكنك هنا حفظ حالة التطبيق، إغلاق الاتصالات، إلخ
  })
  
  // في macOS، عند فتح ملف بواسطة التطبيق
  app.on('open-file', (event, path) => {
    event.preventDefault()
    console.log(`تم محاولة فتح الملف: ${path}`)
    // افتح الملف في التطبيق
  })
  
  // عندما يتغير وضع الطاقة في الجهاز (مفيد للاستجابة لوضع البطارية المنخفضة)
  app.on('power-monitor-on-battery', () => {
    console.log('تم الانتقال لوضع البطارية، تقليل استهلاك الطاقة...')
    // قم بتقليل استهلاك الطاقة (مثلاً: تقليل معدل تحديث البيانات)
  })
  
  app.on('power-monitor-on-ac', () => {
    console.log('تم الانتقال لوضع الطاقة المتصلة، استعادة الأداء الكامل...')
    // استعادة الأداء الكامل
  })
}

// أمثلة على استخدام طرق app

// بدء التطبيق عند بدء تشغيل النظام
app.setLoginItemSettings({
  openAtLogin: true,
  openAsHidden: false, // فتح النافذة عند بدء التشغيل
  path: process.execPath, // مسار ملف التنفيذ
  args: ['--autostart'] // وسائط إضافية
})

// الحصول على مسارات مهمة
const userDataPath = app.getPath('userData')
console.log(`مسار بيانات المستخدم: ${userDataPath}`)

const downloadsPath = app.getPath('downloads')
console.log(`مسار التنزيلات: ${downloadsPath}`)

// الحصول على معلومات عن التطبيق
console.log(`اسم التطبيق: ${app.getName()}`)
console.log(`إصدار التطبيق: ${app.getVersion()}`)
console.log(`مسار التطبيق: ${app.getAppPath()}`)
console.log(`هل التطبيق معبأ؟: ${app.isPackaged}`)

// إعادة تشغيل التطبيق (مفيد بعد التحديث)
app.relaunch({ args: process.argv.slice(1).concat(['--relaunch']) })
app.exit(0)

// ضبط معلومات "حول" للتطبيق (macOS)
app.setAboutPanelOptions({
  applicationName: 'تطبيقي الرائع',
  applicationVersion: app.getVersion(),
  copyright: 'حقوق النشر © ' + new Date().getFullYear(),
  credits: 'فريق التطوير',
  authors: ['المطور الأول', 'المطور الثاني'],
  website: 'https://example.com',
  iconPath: path.join(__dirname, 'assets/icon.png')
})

// استخدام خصائص app

console.log(`اسم التطبيق: ${app.name}`)
console.log(`هل التطبيق معبأ: ${app.isPackaged}`)
console.log(`هل Electron جاهز: ${app.isReady()}`)

// التمييز بين وضع التطوير ووضع الإنتاج
if (app.isPackaged) {
  // كود خاص بوضع الإنتاج
  console.log('تشغيل في وضع الإنتاج')
} else {
  // كود خاص بوضع التطوير
  console.log('تشغيل في وضع التطوير')
  // تفعيل أدوات التطوير، التحميل الفوري، إلخ
}

// تعديل سلسلة User Agent
app.userAgentFallback = `${app.name}/${app.getVersion()} (${process.platform}; ${process.arch})`

const { BrowserWindow, app } = require('electron')
const path = require('path')

// انتظر حتى يكون Electron جاهزًا
app.whenReady().then(() => {
  // إنشاء نافذة جديدة
  const mainWindow = new BrowserWindow({
    width: 800,               // عرض النافذة بالبكسل
    height: 600,              // ارتفاع النافذة بالبكسل
    title: 'تطبيق Electron',  // عنوان النافذة
    
    // الخيارات الأساسية للنافذة
    show: false,              // لا تظهر النافذة عند الإنشاء
    center: true,             // توسيط النافذة على الشاشة
    resizable: true,          // السماح بتغيير حجم النافذة
    movable: true,            // السماح بتحريك النافذة
    minimizable: true,        // السماح بتصغير النافذة
    maximizable: true,        // السماح بتكبير النافذة
    closable: true,           // السماح بإغلاق النافذة
    
    // الخصائص المتقدمة للنافذة
    backgroundColor: '#FFFFFF',  // لون خلفية النافذة
    icon: path.join(__dirname, 'assets/icon.png'),  // أيقونة النافذة
    minWidth: 400,            // الحد الأدنى للعرض
    minHeight: 300,           // الحد الأدنى للارتفاع
    maxWidth: 1200,           // الحد الأقصى للعرض
    maxHeight: 900,           // الحد الأقصى للارتفاع
    
    // إعدادات webPreferences تحدد سلوك عملية العرض
    webPreferences: {
      preload: path.join(__dirname, 'preload.js'),  // سكريبت التحميل المسبق
      nodeIntegration: false,  // تعطيل تكامل Node.js لأسباب أمنية
      contextIsolation: true,  // تفعيل عزل السياق
      sandbox: true,           // تفعيل الصندوق الرملي
      spellcheck: true,        // تفعيل التدقيق الإملائي
      enableRemoteModule: false  // تعطيل الوحدة البعيدة
    }
  })
  
  // تحميل محتوى في النافذة (ملف HTML أو عنوان URL)
  mainWindow.loadFile('index.html')
  // أو: mainWindow.loadURL('https://example.com')
  
  // إظهار النافذة عند اكتمال التحميل لتجنب الوميض
  mainWindow.once('ready-to-show', () => {
    mainWindow.show()
  })
  
  // معالجة حدث الإغلاق
  mainWindow.on('closed', () => {
    // إزالة الإشارة إلى الكائن عند إغلاق النافذة
    mainWindow = null
  })
})

// أمثلة على معالجة أحداث BrowserWindow

// منع إغلاق النافذة مباشرة (مثلاً لعرض تأكيد قبل الإغلاق)
mainWindow.on('close', (event) => {
  // إذا كانت هناك تغييرات غير محفوظة
  if (hasUnsavedChanges) {
    event.preventDefault() // منع الإغلاق التلقائي
    
    const { dialog } = require('electron')
    const choice = dialog.showMessageBoxSync(mainWindow, {
      type: 'question',
      buttons: ['حفظ وإغلاق', 'إغلاق بدون حفظ', 'إلغاء'],
      title: 'تأكيد الإغلاق',
      message: 'لديك تغييرات غير محفوظة. هل تريد حفظها قبل الإغلاق؟'
    })
    
    if (choice === 0) {
      // حفظ التغييرات ثم إغلاق
      saveChanges()
      mainWindow.destroy()
    } else if (choice === 1) {
      // إغلاق بدون حفظ
      mainWindow.destroy()
    }
    // إذا اختار المستخدم "إلغاء"، لا نفعل شيئًا والنافذة تبقى مفتوحة
  }
})

// معالجة تغيير حجم النافذة
mainWindow.on('resize', () => {
  const [width, height] = mainWindow.getSize()
  console.log(`تم تغيير حجم النافذة إلى: ${width}×${height}`)
  
  // يمكنك هنا حفظ الحجم الجديد للاستخدام في المرة القادمة
  saveWindowDimensions(width, height)
})

// معالجة تغيير حالة التركيز
mainWindow.on('focus', () => {
  console.log('النافذة نشطة الآن')
  // يمكنك هنا تحديث الواجهة أو إجراء عمليات عند استعادة التركيز
})

mainWindow.on('blur', () => {
  console.log('النافذة غير نشطة الآن')
  // يمكنك هنا تقليل استخدام الموارد أو إيقاف بعض العمليات مؤقتًا
})

// تنفيذ إجراء عندما تكون النافذة جاهزة للعرض
mainWindow.once('ready-to-show', () => {
  // show() تُستدعى هنا بدلاً من استدعائها فورًا بعد إنشاء النافذة
  mainWindow.show()
  
  // يمكنك أيضًا تنفيذ إجراءات أخرى، مثل:
  mainWindow.focus() // جعل النافذة نشطة
  // mainWindow.maximize() // تكبير النافذة
  
  // إظهار رسالة ترحيبية
  mainWindow.webContents.send('app-ready', { message: 'تم تحميل التطبيق بنجاح!' })
})

// أمثلة على استخدام طرق BrowserWindow

// التحكم في تحميل المحتوى
mainWindow.loadFile('index.html')
mainWindow.loadURL('https://example.com')

// إعادة تحميل الصفحة الحالية (مفيد أثناء التطوير)
mainWindow.reload()

// التحكم في مظهر النافذة وحالتها
mainWindow.maximize() // تكبير النافذة
mainWindow.setFullScreen(true) // تفعيل وضع ملء الشاشة
mainWindow.setAlwaysOnTop(true) // جعل النافذة دائمًا في المقدمة

// ضبط خصائص النافذة
mainWindow.setTitle('عنوان جديد للنافذة')
mainWindow.setSize(1024, 768)
mainWindow.setPosition(100, 100)
mainWindow.setContentSize(800, 600) // ضبط حجم منطقة المحتوى فقط
mainWindow.setResizable(false) // منع تغيير حجم النافذة

// الحصول على معلومات عن النافذة
const title = mainWindow.getTitle()
const [width, height] = mainWindow.getSize()
const [x, y] = mainWindow.getPosition()
const isVisible = mainWindow.isVisible()
const isFullScreen = mainWindow.isFullScreen()

console.log(`عنوان النافذة: ${title}`)
console.log(`أبعاد النافذة: ${width}×${height}`)
console.log(`موقع النافذة: (${x}, ${y})`)
console.log(`هل النافذة مرئية؟ ${isVisible}`)
console.log(`هل النافذة في وضع ملء الشاشة؟ ${isFullScreen}`)

// التحكم في سلوك النافذة
mainWindow.center() // توسيط النافذة على الشاشة
mainWindow.setMenuBarVisibility(false) // إخفاء شريط القوائم
mainWindow.setAutoHideMenuBar(true) // إخفاء تلقائي لشريط القوائم

// التعامل مع webContents (محتويات الويب) للنافذة
mainWindow.webContents.openDevTools() // فتح أدوات المطور
mainWindow.webContents.send('message-to-renderer', { data: 'بيانات للإرسال' }) // إرسال رسالة إلى عملية العرض

// أمثلة على استخدام خصائص BrowserWindow

// الوصول إلى webContents للنافذة
console.log(`هل النافذة تحمل صفحة؟ ${mainWindow.webContents.isLoading() ? 'نعم' : 'لا'}`)
console.log(`عنوان URL الحالي: ${mainWindow.webContents.getURL()}`)

// إرسال رسالة إلى عملية العرض
mainWindow.webContents.send('update-counter', { count: 5 })

// تنفيذ JavaScript في سياق الصفحة
mainWindow.webContents.executeJavaScript('document.title = "عنوان جديد"')
mainWindow.webContents.executeJavaScript('console.log("مرحبًا من العملية الرئيسية")')

// العمل مع جميع النوافذ
const allWindows = BrowserWindow.getAllWindows()
console.log(`عدد النوافذ المفتوحة: ${allWindows.length}`)

// البحث عن النافذة النشطة
const focusedWindow = BrowserWindow.getFocusedWindow()
if (focusedWindow) {
  console.log(`النافذة النشطة حاليًا هي: ${focusedWindow.getTitle()}`)
} else {
  console.log('لا توجد نافذة نشطة حاليًا')
}

// البحث عن نافذة بواسطة معرفها
const windowById = BrowserWindow.fromId(mainWindow.id)
if (windowById) {
  console.log(`تم العثور على النافذة: ${windowById.getTitle()}`)
}

// في العملية الرئيسية (main.js)
const { ipcMain } = require('electron')

// استخدام ipcMain.on للاستماع لرسائل أحادية الاتجاه
ipcMain.on('async-message', (event, arg) => {
  console.log('تم استلام رسالة:', arg)
  
  // الرد على المرسل (اختياري)
  event.reply('async-reply', 'تم استلام رسالتك!')
  // أو باستخدام sender مباشرة
  // event.sender.send('async-reply', 'تم استلام رسالتك!')
})

// استخدام ipcMain.handle للاستماع لطلبات نمط الوعد/promise
ipcMain.handle('invoke-handler', async (event, arg) => {
  console.log('تم استلام استدعاء:', arg)
  
  // يمكن إجراء عمليات غير متزامنة هنا
  await new Promise(resolve => setTimeout(resolve, 1000))
  
  // القيمة المعادة ستكون نتيجة الوعد في عملية العرض
  return {
    success: true,
    data: 'هذه هي النتيجة',
    received: arg
  }
})

// استخدام ipcMain.handleOnce للاستماع مرة واحدة فقط
ipcMain.handleOnce('one-time-request', async (event, arg) => {
  console.log('تم استلام طلب لمرة واحدة:', arg)
  return { message: 'تمت معالجة الطلب لمرة واحدة' }
})

// إلغاء تسجيل معالج
// ipcMain.removeHandler('invoke-handler')

// في سكريبت preload.js
const { contextBridge, ipcRenderer } = require('electron')

// كشف واجهة آمنة للاتصال بين العمليات لعملية العرض
contextBridge.exposeInMainWorld('electronAPI', {
  // إرسال رسالة أحادية الاتجاه إلى العملية الرئيسية
  sendMessage: (message) => ipcRenderer.send('async-message', message),
  
  // استدعاء وانتظار رد من العملية الرئيسية
  invokeAction: (data) => ipcRenderer.invoke('invoke-handler', data),
  
  // استماع للرسائل من العملية الرئيسية
  onUpdateMessage: (callback) => {
    ipcRenderer.on('async-reply', (_event, value) => callback(value))
    
    // إرجاع دالة لإلغاء الاستماع عند الحاجة
    return () => {
      ipcRenderer.removeAllListeners('async-reply')
    }
  }
})

// في ملف renderer.js (عملية العرض)
// استخدام الواجهة التي تم كشفها في preload.js

// إرسال رسالة للعملية الرئيسية
document.getElementById('send-button').addEventListener('click', () => {
  window.electronAPI.sendMessage('مرحبًا من عملية العرض!')
})

// استدعاء وانتظار النتيجة (Promise)
document.getElementById('invoke-button').addEventListener('click', async () => {
  try {
    const result = await window.electronAPI.invokeAction({ 
      action: 'getInfo', 
      params: { id: 123 }
    })
    
    console.log('تم استلام النتيجة:', result)
    document.getElementById('result').textContent = JSON.stringify(result)
  } catch (error) {
    console.error('خطأ في الاستدعاء:', error)
  }
})

// الاستماع للرسائل من العملية الرئيسية
const cleanup = window.electronAPI.onUpdateMessage((message) => {
  console.log('رسالة واردة من العملية الرئيسية:', message)
  document.getElementById('messages').textContent = message
})

// إلغاء الاستماع عند الحاجة (مثلاً عند إزالة المكون)
// cleanup()