mushaf 0.2.0

Flutter mushaf with Hafs and Warsh bundled and ready to read, including ayah selection, page navigation, fullscreen, and book layout.

mushaf

قارئ مصحف جاهز لـ Flutter، بروايتي حفص عن عاصم وورش عن نافع في حزمة واحدة.

تفتح سورة، تقلب الصفحات، وتضغط ضغطاً مطوّلاً على الآية لتحديدها. من الإعدادات تختار ملء الشاشة أو شكل الكتاب، والتمرير الأفقي أو العمودي، وصفحة واحدة أو صفحتين عندما تكون النافذة عريضة وأفقية. حفص يُرسم بخطوط QCF4، ويمكن تلوين التجويد. ورش يُرسم بخط واحد مع ضبط السطور.

A Flutter mushaf reader for Hafs (QCF4) and Warsh: surah list, page turns, long-press ayah selection, fullscreen or book frame, and a two-page spread on a wide landscape window.

المعاينة

من مثال الحزمة على macOS.

قائمة السور	ورش — الفاتحة

حفص بالتجويد	تحديد الآية

ملء الشاشة	إطار الكتاب

صفحتان متقابلتان في الوضع الأفقي العريض:

ماذا ترى في القارئ

• قائمة السور مع البحث، والتبديل بين حفص (604 صفحة) وورش (599 صفحة).
• تحديد الآية بالضغط المطوّل، مع تمييزها، والانتقال إلى صفحة أو آية.
• ملء الشاشة، أو إطار كتاب بحواف الصفحات.
• تمرير أفقي أو عمودي.
• في النافذة العريضة الأفقية: صفحة واحدة أو صفحتان.
• شريط مصغّرات للصفحات، أو منزلق يقفز عند الإفلات.
• ساعة اختيارية، وخلفية سوداء في الوضع الليلي.
• تلوين التجويد لحفص فقط.

التثبيت

dependencies:
  mushaf: ^0.2.0

import 'package:flutter/material.dart';
import 'package:mushaf/mushaf.dart';

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();
  registerMushafHafsQcf4(localRoot: hafsPackRoot);
  registerMushafWarsh(localRoot: warshPackRoot);
  await Mushaf.initialize();
  runApp(const MyApp());
}

MushafReader(
  riwayah: MushafRiwayah.hafs,
  initialPage: 1,
  settings: const MushafReadingSettings(),
  onSettingsChanged: (settings) {},
  onAyahLongPress: (ref) {},
)

MushafReaderController.goToPage وgoToAyah ينقلان الصفحة ويميزان الآية. لورش استخدم MushafRiwayah.warsh بعد registerMushafWarsh.

حفص وورش داخل الحزمة

الملفان assets/packs/hafs.zip وassets/packs/warsh.zip جزء من الحزمة. أول استدعاء لـ Mushaf.initialize() يفكّهما على الجهاز، وبعدها حفص وورش جاهزان. لا يحتاج المستخدم إلى تنزيل منفصل.

cd example
flutter run

إن أردت استخدام مجلد خاص بدل الملفات المضمّنة، سجّله قبل initialize:

registerMushafHafsQcf4(localRoot: hafsPackRoot);
registerMushafWarsh(localRoot: warshPackRoot);
await Mushaf.initialize();

الترخيص

كود Dart تحت رخصة MIT. الخطوط ونص القرآن لهما شروط أصحاب الحقوق. راجع LICENSE وNOTICE.md.