@quran.ws/qiraat-ayah-map 0.1.0

package/data/classical-count-attestations.json

@@ -0,0 +1,325 @@
+{
+  "_version": "0.1.0",
+  "_description": "Canonical scholar-facing attestation layer for the classical total ayah count of each counting madhhab. Records which total each madhhab is attested with, on whose authority, and which total this repository adopts. Computed fields (mapping totals, deltas, status, current mapping decisions) are added by scripts/generate-classical-count-attestations.mjs into dist/classical-count-attestations.json.",
+  "_paired_generated_file": "dist/classical-count-attestations.json",
+  "_counting_system_order": [
+    "madani-first",
+    "madani-last",
+    "makki",
+    "basri",
+    "dimashqi",
+    "kufi"
+  ],
+  "_role_descriptions": {
+    "primary": "The total this repository adopts as the classical reference figure for the madhhab.",
+    "alternative": "A second total attested for the same counting madhhab by a different transmission route or a reported variant reading.",
+    "conflicting": "An attested total that conflicts with the adopted figure and is not yet reconciled."
+  },
+  "_status_descriptions": {
+    "resolved_to_primary_riwaya": "The generated mapping total equals the adopted primary classical total.",
+    "follows_alternative_attested_riwaya": "The generated mapping total does not equal the adopted primary total, but does equal another total explicitly attested for this counting madhhab.",
+    "drift_from_primary_riwaya": "The generated mapping total matches no attested total for this counting madhhab."
+  },
+  "_scope_note_en": "This repository models six counting madhhabs. al-Bayan itself works with exactly six — المدني الأول، المدني الأخير، المكي، الكوفي، البصري، الشامي (chapters at ص 79-81) — and its الشامي maps one-to-one onto this repository's dimashqi. Nafa'is al-Bayan instead lists seven authorities on the well-known view, adding the Himsi count (6232) attributed to Shurayh ibn Yazid al-Himsi al-Hadrami. Himsi is excluded here because no Qiraa among the ten follows it, and because the primary source does not treat it as a separate count. Recorded so the omission is a stated scope decision rather than a silent gap.",
+  "_scope_note_ar": "يقتصر هذا المستودع على مذاهب العدّ الستة. والبيان نفسه يقتصر على ستة: المدني الأول والمدني الأخير والمكي والكوفي والبصري والشامي (أبوابها ص ٧٩-٨١)، وشاميُّه ينطبق تمامًا على الدمشقي في هذا المستودع. أما نفائس البيان فذكر أن علماء العدد سبعة على المشهور بزيادة العدد الحمصي (٦٢٣٢) المنسوب إلى شريح بن يزيد الحمصي الحضرمي. وتُرك الحمصي هنا إذ لا تتبعه قراءة من القراءات العشر، ولأن المصدر الأصل لم يفرده عدًّا مستقلًّا. وأُثبت ذلك ليكون تركه قرارًا مصرَّحًا به.",
+  "systems": {
+    "madani-first": {
+      "verification_status": "primary_cited",
+      "primary_classical_total_ayahs": 6217,
+      "policy_en": "The First Madinan count is what Nafi' transmits from his two shaykhs Abu Ja'far and Shaybah ibn Nissah. It reaches us by two routes with two different totals: the Kufan route from the people of Madinah (6217), and the Basran route through Warsh from Nafi' (6214). Al-Shatibi adopted the Kufan route, following al-Dani, so 6217 is recorded here as the primary figure.",
+      "policy_ar": "العدد المدني الأول هو ما رواه نافع عن شيخيه أبي جعفر وشيبة بن نصاح، وقد ورد من طريقين بجملتين مختلفتين: رواية أهل الكوفة عن أهل المدينة (٦٢١٧)، ورواية أهل البصرة عن ورش عن نافع (٦٢١٤). واعتمد الإمام الشاطبي رواية أهل الكوفة تبعًا للإمام الداني، فأُثبتت ٦٢١٧ هنا جملةً أصلية.",
+      "attested_totals": [
+        {
+          "total_ayahs": 6217,
+          "role": "primary",
+          "attribution_en": "Kufan route: the Kufans transmitting from the people of Madinah without naming a transmitter. Adopted by al-Shatibi, following al-Dani.",
+          "attribution_ar": "رواية أهل الكوفة عن أهل المدينة من غير تعيين أحد منهم، وهي التي اعتمدها الشاطبي تبعًا للداني.",
+          "evidence": [
+            {
+              "tier": "primary",
+              "work": "البيان في عدّ آي القرآن",
+              "edition": "تحقيق غانم قدوري الحمد، مركز المخطوطات والتراث، الكويت، الطبعة الأولى، 1414هـ/1994م",
+              "locator": "ص 79",
+              "strength": "direct",
+              "note": "قسم count_school.madani_1: جميع عدد آي القرآن في المدني الأول ستة آلاف آية ومئتا آية وسبع عشرة آية، وهو العدد الذي رواه أهل الكوفة عن أهل المدينة"
+            },
+            {
+              "tier": "commentary",
+              "work": "نفائس البيان — شرح الفرائد الحسان",
+              "locator": "ص 25-26",
+              "strength": "direct",
+              "note": "مقطع nfb.madkhal.enumerators.madani_first"
+            }
+          ]
+        },
+        {
+          "total_ayahs": 6214,
+          "role": "alternative",
+          "attribution_en": "Basran route: the Basrans transmitting through Warsh from Nafi' from his two shaykhs.",
+          "attribution_ar": "رواية أهل البصرة عن ورش عن نافع عن شيخيه.",
+          "evidence": [
+            {
+              "tier": "commentary",
+              "work": "نفائس البيان — شرح الفرائد الحسان",
+              "locator": "ص 25-26",
+              "strength": "direct",
+              "note": "مقطع nfb.madkhal.enumerators.madani_first: ورواية أهل البصرة عن ورش ٦٢١٤"
+            }
+          ]
+        }
+      ],
+      "open_question_en": "The generated mapping reproduces 6214, the Basran route, while the adopted primary figure is 6217. Three boundary points counted in the Kufan route are therefore not yet present in the primitive layer. Two tasks follow: cite the six totals from al-Bayan directly rather than through a commentary, and identify the three missing First Madinan boundaries. Until then this system must not be described as settled. Note also that the mapping total for madani-first currently equals madani-last (6214) while the two systems differ in 15 surahs, which is consistent with the Basran route but should be re-checked once the three points are located.",
+      "open_question_ar": "الخريطة المولَّدة تعطي ٦٢١٤ وهي جملة الطريق البصري، والجملة الأصلية المعتمدة ٦٢١٧. فثلاثة مواضع معدودة في الطريق الكوفي لم تُثبت بعد في طبقة المواضع. ويلزم أمران: توثيق الجمل الست من البيان نفسه لا من شرح، وتعيين المواضع الثلاثة الناقصة. ولا يوصف هذا العدد بالاستقرار قبل ذلك.",
+      "disputed_boundaries": []
+    },
+    "madani-last": {
+      "verification_status": "primary_cited",
+      "primary_classical_total_ayahs": 6214,
+      "policy_en": "The Last Madinan count is what Isma'il ibn Ja'far transmits from Yazid and Shaybah by way of Sulayman ibn Jimmaz. Only one total is attested for it.",
+      "policy_ar": "العدد المدني الأخير هو ما رواه إسماعيل بن جعفر عن يزيد وشيبة بواسطة سليمان بن جماز، ولم تُنقل له إلا جملة واحدة.",
+      "attested_totals": [
+        {
+          "total_ayahs": 6214,
+          "role": "primary",
+          "attribution_en": "Isma'il ibn Ja'far, from Sulayman ibn Jimmaz, from Shaybah and Yazid.",
+          "attribution_ar": "إسماعيل بن جعفر عن سليمان بن جماز عن شيبة ويزيد.",
+          "evidence": [
+            {
+              "tier": "primary",
+              "work": "البيان في عدّ آي القرآن",
+              "edition": "تحقيق غانم قدوري الحمد، مركز المخطوطات والتراث، الكويت، الطبعة الأولى، 1414هـ/1994م",
+              "locator": "ص 79",
+              "strength": "direct",
+              "note": "قسم count_school.madani_2: جميع عدد آي القرآن في قول إسماعيل بن جعفر ستة آلاف آية ومئتا آية وأربع عشرة آية"
+            },
+            {
+              "tier": "commentary",
+              "work": "نفائس البيان — شرح الفرائد الحسان",
+              "locator": "ص 26",
+              "strength": "direct",
+              "note": "مقطع nfb.madkhal.enumerators.madani_last"
+            }
+          ]
+        },
+        {
+          "total_ayahs": 6210,
+          "role": "alternative",
+          "attribution_en": "Abu Ja'far's own count, differing from Shaybah — recorded by al-Dani in the same chapter. Relevant because Abu Ja'far is the Qiraa this repository maps to the First Madinan madhhab.",
+          "attribution_ar": "جملة أبي جعفر نفسه للاختلاف بينه وبين شيبة، ذكرها الداني في الباب نفسه. وتُعنى هنا لأن أبا جعفر هو القارئ المنسوب في هذا المستودع إلى العدد المدني الأول.",
+          "evidence": [
+            {
+              "tier": "primary",
+              "work": "البيان في عدّ آي القرآن",
+              "edition": "تحقيق غانم قدوري الحمد، مركز المخطوطات والتراث، الكويت، الطبعة الأولى، 1414هـ/1994م",
+              "locator": "ص 79",
+              "strength": "direct",
+              "note": "قسم count_school.madani_2: وجميع آي القرآن في قول أبي جعفر للاختلاف الذي ذكرناه بينه وبين شيبة ستة آلاف ومئتان وعشر آيات"
+            }
+          ]
+        }
+      ],
+      "disputed_boundaries": []
+    },
+    "makki": {
+      "verification_status": "primary_cited",
+      "primary_classical_total_ayahs": 6219,
+      "policy_en": "Prefer the primary Makki total reported by Abu Amr al-Dani when later computed variants can be reproduced only by disputed boundary positions. The adopted figure is 6219, directly attested in al-Bayan. Nafa'is al-Bayan reports 6210 for the Makkan chain; al-Bayan shows that 6210 is the figure of Ubayy ibn Ka'b, recorded separately from the Makkiyyun total in the same chapter. The two figures describe different things.",
+      "policy_ar": "يُقدَّم مجموع العدد المكي الذي رواه أبو عمرو الداني إذا لم يمكن بلوغ الجمل الأخرى إلا بعدِّ مواضع مختلف فيها، والمعتمد ٦٢١٩ وهو منصوص في البيان. وذكر نفائس البيان ٦٢١٠ في سند المكي، وبيَّن البيانُ أن ٦٢١٠ جملة أبيّ بن كعب مذكورةً على حدة في الباب نفسه، فالجملتان في شيئين مختلفين.",
+      "attested_totals": [
+        {
+          "total_ayahs": 6219,
+          "role": "primary",
+          "attribution_en": "The Makkan count as reported by Abu Amr al-Dani. Adopted by this repository.",
+          "attribution_ar": "العدد المكي كما رواه أبو عمرو الداني، وهو المعتمد في هذا المستودع.",
+          "evidence": [
+            {
+              "tier": "primary",
+              "work": "البيان في عدّ آي القرآن",
+              "edition": "تحقيق غانم قدوري الحمد، مركز المخطوطات والتراث، الكويت، الطبعة الأولى، 1414هـ/1994م",
+              "locator": "ص 79",
+              "strength": "direct",
+              "note": "قسم count_school.makki: وعدد آي القرآن في قول المكيين ستة آلاف آية ومئتان وتسع عشرة آية"
+            }
+          ]
+        },
+        {
+          "total_ayahs": 6210,
+          "role": "alternative",
+          "attribution_en": "The figure of Ubayy ibn Ka'b, recorded by al-Dani immediately after the Makkiyyun total. Nafa'is al-Bayan attaches this figure to the Makkan chain (al-Dani to Ibn Kathir, from Mujahid, from Ibn 'Abbas, from Ubayy), which is why the two sources appear to conflict.",
+          "attribution_ar": "جملة أبيّ بن كعب، ذكرها الداني عقب جملة المكيين. ونسبها نفائس البيان إلى سند المكي (الداني إلى ابن كثير عن مجاهد عن ابن عباس عن أبيّ)، ومن هنا نشأ توهم التعارض بين المصدرين.",
+          "evidence": [
+            {
+              "tier": "primary",
+              "work": "البيان في عدّ آي القرآن",
+              "edition": "تحقيق غانم قدوري الحمد، مركز المخطوطات والتراث، الكويت، الطبعة الأولى، 1414هـ/1994م",
+              "locator": "ص 79",
+              "strength": "direct",
+              "note": "قسم count_school.makki: وفي قول أبي بن كعب ستة آلاف ومئتان وعشر آيات"
+            },
+            {
+              "tier": "commentary",
+              "work": "نفائس البيان — شرح الفرائد الحسان",
+              "locator": "ص 26",
+              "strength": "direct",
+              "note": "مقطع nfb.madkhal.enumerators.makki: وعدد الآي عنده ٦٢١٠"
+            }
+          ]
+        }
+      ],
+      "disputed_boundaries": [
+        {
+          "surah": 78,
+          "hafs_ayah": 40,
+          "word": "قريبا",
+          "primary_riwaya_decision": "excluded",
+          "note_en": "Abu Amr al-Dani reports this boundary for Basri only, not for Makki.",
+          "note_ar": "نصَّ أبو عمرو الداني على عدِّ هذا الموضع للبصري فقط دون المكي."
+        },
+        {
+          "surah": 91,
+          "hafs_ayah": 14,
+          "word": "فعقروها",
+          "primary_riwaya_decision": "excluded",
+          "note_en": "Abu Amr al-Dani marks the Makki count here as disputed (بخلاف عنه); the repository excludes it to preserve the primary Makki total of 6219.",
+          "note_ar": "ذكر أبو عمرو الداني عدَّ هذا الموضع للمكي بخلاف عنه؛ واعتمد المستودع تركه محافظةً على الجملة الأصلية للعدد المكي (6219)."
+        }
+      ]
+    },
+    "basri": {
+      "verification_status": "primary_cited",
+      "primary_classical_total_ayahs": 6204,
+      "policy_en": "The Basran count is what 'Ata' ibn Yasar and 'Asim al-Jahdari transmit, later attributed also to Ayyub ibn al-Mutawakkil. One total is attested: 6204. This is the count that Abu Amr al-Basri and Ya'qub follow, and therefore the count that governs the riwayat of al-Duri 'an Abi 'Amr, al-Susi, Ruways and Rawh.",
+      "policy_ar": "العدد البصري هو ما رواه عطاء بن يسار وعاصم الجحدري، ونُسب بعدُ إلى أيوب بن المتوكل، وجملته ٦٢٠٤. وهو عدد أبي عمرو البصري ويعقوب، فيجري على روايات الدوري عن أبي عمرو والسوسي ورويس وروح.",
+      "attested_totals": [
+        {
+          "total_ayahs": 6204,
+          "role": "primary",
+          "attribution_en": "'Ata' ibn Yasar and 'Asim al-Jahdari; later attributed to Ayyub ibn al-Mutawakkil.",
+          "attribution_ar": "عطاء بن يسار وعاصم الجحدري، ونُسب بعدُ إلى أيوب بن المتوكل.",
+          "evidence": [
+            {
+              "tier": "primary",
+              "work": "البيان في عدّ آي القرآن",
+              "edition": "تحقيق غانم قدوري الحمد، مركز المخطوطات والتراث، الكويت، الطبعة الأولى، 1414هـ/1994م",
+              "locator": "ص 80",
+              "strength": "direct",
+              "note": "قسم count_school.basri: وجميع عدد آي القرآن في عدد البصريين ستة آلاف ومئتان وأربع آيات، وهو العدد الذي عليه مصاحفهم حتى الآن، وهو عدد أيوب بن المتوكل"
+            },
+            {
+              "tier": "commentary",
+              "work": "نفائس البيان — شرح الفرائد الحسان",
+              "locator": "ص 26",
+              "strength": "direct",
+              "note": "مقطع nfb.madkhal.enumerators.basri"
+            }
+          ]
+        },
+        {
+          "total_ayahs": 6205,
+          "role": "alternative",
+          "attribution_en": "The count of 'Asim al-Jahdari, one ayah more than Ayyub ibn al-Mutawakkil's, on the view that 'Asim counted ﴿قال فالحق﴾ in Sad.",
+          "attribution_ar": "عدد عاصم الجحدري بزيادة آية على عدد أيوب بن المتوكل، على قول من قال إن عاصمًا كان يعدّ في ص ﴿قال فالحق﴾.",
+          "evidence": [
+            {
+              "tier": "primary",
+              "work": "البيان في عدّ آي القرآن",
+              "edition": "تحقيق غانم قدوري الحمد، مركز المخطوطات والتراث، الكويت، الطبعة الأولى، 1414هـ/1994م",
+              "locator": "ص 80",
+              "strength": "direct",
+              "note": "قسم count_school.basri: وأما عدد عاصم الجحدري فهو وخمس آيات، وذلك على قول من قال إن عاصمًا كان يعد في ص ﴿قال فالحق﴾"
+            }
+          ]
+        }
+      ],
+      "disputed_boundaries": []
+    },
+    "dimashqi": {
+      "verification_status": "primary_cited",
+      "primary_classical_total_ayahs": 6226,
+      "policy_en": "The Damascene count is what Yahya al-Dhimari transmitted from Ibn 'Amir al-Yahsubi from Abu al-Darda', and is also attributed to 'Uthman ibn 'Affan. al-Bayan attests 6226 directly, so 6226 is adopted. Nafa'is al-Bayan gives 6227 and reports 6226 only as a second reading; the primary source is preferred over the commentary.",
+      "policy_ar": "العدد الدمشقي هو ما رواه يحيى الذماري عن ابن عامر اليحصبي عن أبي الدرداء، ويُنسب إلى عثمان بن عفان رضي الله عنه. وقد نصّ البيان على ٦٢٢٦ فاعتُمدت. وذكر نفائس البيان ٦٢٢٧ ثم قال: وقيل ٦٢٢٦؛ ويُقدَّم الأصل على الشرح.",
+      "attested_totals": [
+        {
+          "total_ayahs": 6226,
+          "role": "primary",
+          "attribution_en": "Yahya al-Dhimari, via Suwayd ibn 'Abd al-'Aziz from Hisham ibn 'Ammar — al-Dani reports this chain three times.",
+          "attribution_ar": "يحيى بن الحارث الذماري من طريق سويد بن عبد العزيز عن هشام بن عمار، أوردها الداني بثلاثة أسانيد.",
+          "evidence": [
+            {
+              "tier": "primary",
+              "work": "البيان في عدّ آي القرآن",
+              "edition": "تحقيق غانم قدوري الحمد، مركز المخطوطات والتراث، الكويت، الطبعة الأولى، 1414هـ/1994م",
+              "locator": "ص 81",
+              "strength": "direct",
+              "note": "قسم count_school.shami: سألت يحيى بن الحارث الذماري عن عدد آي القرآن فأشار إليّ بيده ستة آلاف ومئتان وست وعشرون"
+            }
+          ]
+        },
+        {
+          "total_ayahs": 6225,
+          "role": "alternative",
+          "attribution_en": "A report of 'six thousand two hundred and twenty-five, one ayah short'; Ibn Dhakwan explains it as Yahya not counting the basmala.",
+          "attribution_ar": "رواية: ستة آلاف ومئتان وخمس وعشرون آية نقص آية. قال ابن ذكوان: فظننت يحيى لم يعد ﴿بسم الله الرحمن الرحيم﴾.",
+          "evidence": [
+            {
+              "tier": "primary",
+              "work": "البيان في عدّ آي القرآن",
+              "edition": "تحقيق غانم قدوري الحمد، مركز المخطوطات والتراث، الكويت، الطبعة الأولى، 1414هـ/1994م",
+              "locator": "ص 81",
+              "strength": "direct",
+              "note": "قسم count_school.shami: هو ستة آلاف ومئتان وخمس وعشرون آية نقص آية، قال ابن ذكوان فظننت يحيى لم يعد ﴿بسم الله الرحمن الرحيم﴾"
+            }
+          ]
+        },
+        {
+          "total_ayahs": 6227,
+          "role": "conflicting",
+          "attribution_en": "Given as the Damascene total in Nafa'is al-Bayan, which then reports 6226 with the qualifier wa-qila. Not supported by al-Bayan.",
+          "attribution_ar": "جاءت في نفائس البيان جملةً للعدد الدمشقي ثم قال: وقيل ٦٢٢٦. ولم يوافقه البيان.",
+          "evidence": [
+            {
+              "tier": "commentary",
+              "work": "نفائس البيان — شرح الفرائد الحسان",
+              "locator": "ص 26",
+              "strength": "direct",
+              "note": "مقطع nfb.madkhal.enumerators.dimashqi: وعدد الآي فيه ٦٢٢٧ وقيل ٦٢٢٦"
+            }
+          ]
+        }
+      ],
+      "disputed_boundaries": []
+    },
+    "kufi": {
+      "verification_status": "primary_cited",
+      "primary_classical_total_ayahs": 6236,
+      "policy_en": "The Kufan count is what Hamzah and Sufyan transmit from 'Ali ibn Abi Talib. It is the reference madhhab of this repository: every mapping is expressed as Kufi to target. Note that the Kufans carry two counts — whatever they narrate stopping at the people of Madinah is the First Madinan count, and only what they narrate with a connected chain to 'Ali is the Kufan count proper.",
+      "policy_ar": "العدد الكوفي هو ما رواه حمزة وسفيان عن علي بن أبي طالب رضي الله عنه، وهو العدد المرجعي في هذا المستودع، وكل الخرائط مبنية على: من الكوفي إلى غيره. وينبَّه أن لأهل الكوفة عددين: ما رووه موقوفًا على أهل المدينة فهو المدني الأول، وما رووه موصولًا إلى علي فهو الكوفي.",
+      "attested_totals": [
+        {
+          "total_ayahs": 6236,
+          "role": "primary",
+          "attribution_en": "Hamzah and Sufyan, from 'Ali ibn Abi Talib.",
+          "attribution_ar": "حمزة وسفيان عن علي بن أبي طالب رضي الله عنه.",
+          "evidence": [
+            {
+              "tier": "primary",
+              "work": "البيان في عدّ آي القرآن",
+              "edition": "تحقيق غانم قدوري الحمد، مركز المخطوطات والتراث، الكويت، الطبعة الأولى، 1414هـ/1994م",
+              "locator": "ص 80",
+              "strength": "direct",
+              "note": "قسم count_school.kufi: وجميع عدد آي القرآن في قول الكوفيين خاصة ستة آلاف ومئتا آية وثلاثون وست آيات، وهو العدد الذي رواه سليم والكسائي عن حمزة وأسنده الكسائي إلى علي رضي الله عنه"
+            },
+            {
+              "tier": "commentary",
+              "work": "نفائس البيان — شرح الفرائد الحسان",
+              "locator": "ص 26-27",
+              "strength": "direct",
+              "note": "مقطع nfb.madkhal.enumerators.kufi"
+            }
+          ]
+        }
+      ],
+      "disputed_boundaries": []
+    }
+  }
+}

package/data/counting-systems.json

@@ -0,0 +1,72 @@
+{
+  "kufi": {
+    "name_ar": "الكوفي",
+    "name_en": "Kufan",
+    "total_ayahs": 6236,
+    "is_reference": true,
+    "used_by_qiraat": [
+      "asim",
+      "hamza",
+      "kisai",
+      "khalaf"
+    ],
+    "description_ar": "العدد الكوفي، وهو العدد الذي يتبعه الإمام عاصم وحمزة والكسائي وخلف في قراءاتهم، وهو المشهور في مصحف المدينة النبوية (مصحف حفص)",
+    "description_en": "The Kufan counting tradition, followed by Asim, Hamza, Al-Kisai, and Khalaf. The most widely used counting madhhab, found in the Madinah Mushaf (Hafs edition)."
+  },
+  "madani-last": {
+    "name_ar": "المدني الأخير",
+    "name_en": "Last Madinan",
+    "total_ayahs": 6214,
+    "is_reference": false,
+    "used_by_qiraat": [
+      "nafi"
+    ],
+    "description_ar": "العدد المدني الأخير، وهو العدد الذي يتبعه الإمام نافع المدني في قراءته",
+    "description_en": "The Last Madinan counting tradition, followed by Imam Nafi' of Madinah."
+  },
+  "madani-first": {
+    "name_ar": "المدني الأول",
+    "name_en": "First Madinan",
+    "total_ayahs": 6214,
+    "is_reference": false,
+    "used_by_qiraat": [
+      "abu-jafar"
+    ],
+    "description_ar": "العدد المدني الأول، وهو أحد مذاهب العد الستة المعتمدة في عدّ آي القرآن الكريم",
+    "description_en": "The First Madinan counting tradition, one of the six counting madhhabs."
+  },
+  "makki": {
+    "name_ar": "المكي",
+    "name_en": "Makkan",
+    "total_ayahs": 6219,
+    "is_reference": false,
+    "used_by_qiraat": [
+      "ibn-kathir"
+    ],
+    "description_ar": "العدد المكي، وهو العدد الذي يتبعه الإمام ابن كثير المكي في قراءته",
+    "description_en": "The Makkan counting tradition, followed by Imam Ibn Kathir of Makkah."
+  },
+  "basri": {
+    "name_ar": "البصري",
+    "name_en": "Basran",
+    "total_ayahs": 6204,
+    "is_reference": false,
+    "used_by_qiraat": [
+      "abu-amr",
+      "yaqub"
+    ],
+    "description_ar": "العدد البصري، وهو العدد الذي يتبعه الإمام أبو عمرو البصري ويعقوب في قراءتهما",
+    "description_en": "The Basran counting tradition, followed by Abu Amr al-Basri and Ya'qub."
+  },
+  "dimashqi": {
+    "name_ar": "الدمشقي",
+    "name_en": "Damascene",
+    "total_ayahs": 6226,
+    "is_reference": false,
+    "used_by_qiraat": [
+      "ibn-amir"
+    ],
+    "description_ar": "العدد الدمشقي (الشامي)، وهو العدد الذي يتبعه الإمام ابن عامر الدمشقي في قراءته",
+    "description_en": "The Damascene (Shami) counting tradition, followed by Ibn Amir of Damascus."
+  }
+}

package/data/printed-editions.json

@@ -0,0 +1,108 @@
+{
+  "_model": "A counting madhhab is attributed to a qāriʾ; a numbering is printed by an edition. They are two different questions, and this file answers only the second. Every entry here is the result of measuring one printed muṣḥaf, never an inference from the qāriʾ. Where a qāriʾ's edition has not been measured, there is no entry — absence means unmeasured, not agreement.",
+  "_worked_example": "Abū ʿAmr al-Baṣrī is attributed the Baṣrī count (qiraat.json: counting_system_associated_with_qari = basri). Both KFGQPC muṣḥafs of his rāwīs measure onto First Madani — Dūrī at distance 0, Sūsī at distance 1, against 97 and 98 from Baṣrī. Neither figure is wrong: the attribution is about the qāriʾ, the measurement is about the printing. A consumer that joins on one field and reads it as the other gets a contradiction, which is exactly what these two fields exist to prevent.",
+  "_fields": {
+    "rawi": "the rāwī slug in qiraat.json whose muṣḥaf this is",
+    "qiraa": "the qiraa slug in qiraat.json",
+    "counting_system_printed": "the counting system this printing's own āyah ends measure onto — the nearest system, not an assumed one",
+    "distance_to_printed_system": "how many āyah ends of this printing the nearest system does not account for; 0 is an exact match",
+    "distance_to_system_associated_with_qari": "the same distance to the system qiraat.json attributes to the qāriʾ",
+    "differs_from_association": "true when the printing does not measure onto the attributed system",
+    "ayah_count": "the number of āyāt this printing carries",
+    "source_package": "the publisher package the measurement was taken from",
+    "release_year": "the year of that package, so a later release is visibly a different measurement"
+  },
+  "_measured_by": {
+    "repository": "https://github.com/quran-ws/quran-text",
+    "commit": "d0987a6006aa9d5ab88095230c10dd03ff6cf661",
+    "method": "Every āyah end of the edition is compared against the boundaries this repository publishes for each of the six systems. The system left with the fewest unaccounted ends is the one the printing measures onto.",
+    "note": "quran-text vendors this repository's boundaries at a pinned commit, so the two sides measure against the same points."
+  },
+  "editions": [
+    {
+      "id": "kfgqpc-hafs-v3.0",
+      "rawi": "hafs",
+      "qiraa": "asim",
+      "counting_system_printed": "kufi",
+      "distance_to_printed_system": 0,
+      "distance_to_system_associated_with_qari": 0,
+      "differs_from_association": false,
+      "ayah_count": 6236,
+      "source_package": "UthmanicHafs-v-3.0.zip",
+      "release_year": 2026
+    },
+    {
+      "id": "kfgqpc-shuba-v3.0",
+      "rawi": "shuba",
+      "qiraa": "asim",
+      "counting_system_printed": "kufi",
+      "distance_to_printed_system": 0,
+      "distance_to_system_associated_with_qari": 0,
+      "differs_from_association": false,
+      "ayah_count": 6236,
+      "source_package": "UthmanicShubah-v-3.0.zip",
+      "release_year": 2026
+    },
+    {
+      "id": "kfgqpc-warsh-v3.0",
+      "rawi": "warsh",
+      "qiraa": "nafi",
+      "counting_system_printed": "madani-last",
+      "distance_to_printed_system": 0,
+      "distance_to_system_associated_with_qari": 0,
+      "differs_from_association": false,
+      "ayah_count": 6214,
+      "source_package": "UthmanicWarsh-v-3.0.zip",
+      "release_year": 2026
+    },
+    {
+      "id": "kfgqpc-qalun-v3.0",
+      "rawi": "qalun",
+      "qiraa": "nafi",
+      "counting_system_printed": "madani-last",
+      "distance_to_printed_system": 0,
+      "distance_to_system_associated_with_qari": 0,
+      "differs_from_association": false,
+      "ayah_count": 6214,
+      "source_package": "UthmanicQaloun-v-3.0.zip",
+      "release_year": 2026
+    },
+    {
+      "id": "kfgqpc-duri-v2.0",
+      "rawi": "duri",
+      "qiraa": "abu-amr",
+      "counting_system_printed": "madani-first",
+      "distance_to_printed_system": 0,
+      "distance_to_system_associated_with_qari": 97,
+      "differs_from_association": true,
+      "ayah_count": 6217,
+      "source_package": "UthmanicDouri_V20.zip",
+      "release_year": 2022,
+      "note": "Measured against the 2022 package. KFGQPC has published a later official release of this muṣḥaf, and this repository's Dūrī entry has not yet been measured against it, so counting_system_printed, distance_to_printed_system and ayah_count here all describe the 2022 printing only. Printings of this muṣḥaf are known to disagree with each other about al-Mulk 67:9, so a later release can legitimately carry a different āyah count."
+    },
+    {
+      "id": "kfgqpc-susi-v3.0",
+      "rawi": "susi",
+      "qiraa": "abu-amr",
+      "counting_system_printed": "madani-first",
+      "distance_to_printed_system": 1,
+      "distance_to_system_associated_with_qari": 98,
+      "differs_from_association": true,
+      "ayah_count": 6218,
+      "source_package": "UthmanicSousi-v-3.0.zip",
+      "release_year": 2026
+    },
+    {
+      "id": "kfgqpc-bazzi-v3.0",
+      "rawi": "bazzi",
+      "qiraa": "ibn-kathir",
+      "counting_system_printed": "makki",
+      "distance_to_printed_system": 1,
+      "distance_to_system_associated_with_qari": 1,
+      "differs_from_association": false,
+      "ayah_count": 6220,
+      "source_package": "UthmanicBazzi-v-3.0.zip",
+      "release_year": 2026
+    }
+  ]
+}

package/data/qiraat.json

@@ -0,0 +1,92 @@
+{
+  "nafi": {
+    "name_ar": "نافع",
+    "name_en": "Nafi'",
+    "counting_system_associated_with_qari": "madani-last",
+    "rawis": {
+      "qalun":  { "name_ar": "قالون", "name_en": "Qalun" },
+      "warsh":  { "name_ar": "ورش", "name_en": "Warsh" }
+    }
+  },
+  "ibn-kathir": {
+    "name_ar": "ابن كثير",
+    "name_en": "Ibn Kathir",
+    "counting_system_associated_with_qari": "makki",
+    "rawis": {
+      "bazzi":   { "name_ar": "البزي", "name_en": "Al-Bazzi" },
+      "qunbul":  { "name_ar": "قنبل", "name_en": "Qunbul" }
+    }
+  },
+  "abu-amr": {
+    "name_ar": "أبو عمرو",
+    "name_en": "Abu Amr",
+    "counting_system_associated_with_qari": "basri",
+    "rawis": {
+      "duri":  { "name_ar": "الدوري", "name_en": "Al-Duri" },
+      "susi":  { "name_ar": "السوسي", "name_en": "Al-Susi" }
+    }
+  },
+  "ibn-amir": {
+    "name_ar": "ابن عامر",
+    "name_en": "Ibn Amir",
+    "counting_system_associated_with_qari": "dimashqi",
+    "rawis": {
+      "hisham":      { "name_ar": "هشام", "name_en": "Hisham" },
+      "ibn-dhakwan": { "name_ar": "ابن ذكوان", "name_en": "Ibn Dhakwan" }
+    }
+  },
+  "asim": {
+    "name_ar": "عاصم",
+    "name_en": "Asim",
+    "counting_system_associated_with_qari": "kufi",
+    "rawis": {
+      "shuba": { "name_ar": "شعبة", "name_en": "Shu'ba" },
+      "hafs":  { "name_ar": "حفص", "name_en": "Hafs" }
+    }
+  },
+  "hamza": {
+    "name_ar": "حمزة",
+    "name_en": "Hamza",
+    "counting_system_associated_with_qari": "kufi",
+    "rawis": {
+      "khalaf":  { "name_ar": "خلف", "name_en": "Khalaf" },
+      "khallad": { "name_ar": "خلّاد", "name_en": "Khallad" }
+    }
+  },
+  "kisai": {
+    "name_ar": "الكسائي",
+    "name_en": "Al-Kisai",
+    "counting_system_associated_with_qari": "kufi",
+    "rawis": {
+      "abu-al-harith": { "name_ar": "أبو الحارث", "name_en": "Abu al-Harith" },
+      "duri-kisai":    { "name_ar": "الدوري الكسائي", "name_en": "Al-Duri (Kisai)" }
+    }
+  },
+  "abu-jafar": {
+    "name_ar": "أبو جعفر",
+    "name_en": "Abu Ja'far",
+    "counting_system_associated_with_qari": "madani-first",
+    "rawis": {
+      "ibn-wardan": { "name_ar": "عيسى بن وردان", "name_en": "Isa ibn Wardan" },
+      "ibn-jammaz": { "name_ar": "ابن جمّاز", "name_en": "Ibn Jammaz" }
+    }
+  },
+  "yaqub": {
+    "name_ar": "يعقوب",
+    "name_en": "Ya'qub",
+    "counting_system_associated_with_qari": "basri",
+    "rawis": {
+      "ruways": { "name_ar": "رويس", "name_en": "Ruways" },
+      "rawh":   { "name_ar": "روح", "name_en": "Rawh" }
+    }
+  },
+  "khalaf": {
+    "name_ar": "خلف العاشر",
+    "name_en": "Khalaf al-Ashir",
+    "counting_system_associated_with_qari": "kufi",
+    "rawis": {
+      "ishaq": { "name_ar": "إسحاق", "name_en": "Ishaq" },
+      "idris": { "name_ar": "إدريس", "name_en": "Idris" }
+    }
+  }
+}

package/dist/README.md

@@ -0,0 +1,4 @@
+# Generated artifacts
+
+This directory is regenerated by `npm run generate`.
+Edit the canonical source files under `data/` instead of editing files here by hand.