isnady 0.3.4 → 0.3.6

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 Bayram Kotan
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 Bayram Kotan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -8,12 +8,12 @@
 
 <p align="center">
   <a href="https://pypi.org/project/isnady/">
-    <img src="https://img.shields.io/badge/PyPI-v0.3.4-1D4777?style=for-the-badge&logo=pypi&logoColor=white" alt="PyPI">
+    <img src="https://img.shields.io/badge/PyPI-v0.3.6-1D4777?style=for-the-badge&logo=pypi&logoColor=white" alt="PyPI">
   </a>
   <img src="https://img.shields.io/pypi/pyversions/isnady?style=for-the-badge&color=A47E24&logo=python&logoColor=white" alt="Python">
   <img src="https://img.shields.io/badge/Platform-Windows%20%7C%20Linux%20%7C%20macOS-5B6878?style=for-the-badge" alt="Platform">
   <a href="https://www.npmjs.com/package/isnady">
-    <img src="https://img.shields.io/badge/npm-v0.3.4-14304F?style=for-the-badge&logo=npm" alt="npm">
+    <img src="https://img.shields.io/badge/npm-v0.3.6-14304F?style=for-the-badge&logo=npm" alt="npm">
   </a>
   <a href="https://github.com/bayramkotan/isnady-data">
     <img src="https://img.shields.io/badge/data-isnady--data-2E6B4F?style=for-the-badge&logo=github" alt="isnady-data">
@@ -45,7 +45,7 @@
   <img src="https://raw.githubusercontent.com/bayramkotan/isnady/main/assets/screenshots/search-arabic.png" alt="Searching النيات finds بالنيات in Sahih al-Bukhari 1, with the chain above the text" width="850">
 </p>
 
-> **Pre-alpha (0.3.4).** Search, chains of transmission, narrators, books, scholars, statistics and
+> **Pre-alpha (0.3.6).** Search, chains of transmission, narrators, books, scholars, statistics and
 > the glossary work today, Sunni and Shia, on data you import in one click. Everything is built in
 > the open, one piece at a time.
 
@@ -509,9 +509,27 @@ famous man of that name when nothing else excludes him ("Anas" Anas b. Malik, "M
 to a name. On road B the same help reads al-Kulayni's chains: his teachers named short ("'Ali b. Ibrahim" b. Hashim
 al-Qummi, "Muhammad b. Yahya" al-'Attar), the nisbas and kunyas the chains use alone (al-Sakuni, al-Nawfali, Abu
 Basir, al-Halabi, Ibn Faddal) and "from his father" read from the son's full name ("'Ali b. Ibrahim from his father"
-is Ibrahim b. Hashim). About 273,000 links are identified this way — two of every three in the Sunni chains, one in
+is Ibrahim b. Hashim). About 280,000 links are identified this way — two of every three in the Sunni chains, one in
 two in the Shia ones.
 
+**Who is not a narrator.** The Prophet ﷺ named by his kunya or an epithet ("سمعت أبا القاسم ﷺ", "حدثني خليلي",
+"الصادق المصدوق") ends the chain; he is never matched to a narrator of that kunya. The man a Companion tells a story
+about is not his teacher: "عن أبي هريرة أنّ سعد بن عبادة قال لرسول الله" ends at Abu Hurayra, and so does "عمر،
+سمعت هشام بن حكيم يقرأ". A second road written after a link — "… عن عروة، عن عائشة، وعن هشام بن عروة، عن أبيه، عن
+عائشة", "وحدثنا …", "قال وأخبرني …", "، وأبي الزناد، عن الأعرج" after a Companion — is drawn as its own chain, joined to
+the first where they meet, never read on as one; a road begun again without a sign (a narrator named twice) is cut
+there. And two neighbours that cannot both be right — a narrator his own teacher, a teacher four generations after
+his student or six before him — are not left so: the less certain of the two is left unidentified.
+
+**The famous ones, however they are written.** ★ **Famous Companions** on the Narrators page and in the Genealogies
+lists them group by group — the four Caliphs, the ten promised Paradise, the Mothers of the Believers, the Prophet's
+household, those who narrated most and some forty more (`iy narrator --famous`); on road B, the Imami scholars' own
+Ashab al-Ijma'. Typed, a famous Companion comes first whichever way he is written — "Ebubekir", "Ebû Bekr",
+"Abu Bakr", "Hz. Ömer", "Omer ibn Hattap", "Umar bin Khattab", "Osman", "Uthman", "Ayşe", "Aisha", أبو بكر الصديق —
+shown by the name people know him by ("Hz. Ebû Bekir es-Sıddîk (r.a.)": his entry begins with 'Abd Allah b.
+'Uthman), and every name found carries its tabaqa and death year, so 'Umar b. al-Khattab the Caliph is not mistaken
+for the two later men of that name.
+
 Sunni narrators filter by tabaqa, rank and book; Shia narrators by the Imami assessment.
 
 <p align="center">
@@ -839,7 +857,7 @@ command line never loads Qt. Every command that takes a book accepts its full na
 | `iy search WORDS` | `iy search niyet --book abudawud` | Search; `--mode all\|any\|phrase\|meaning`, `--whole-words`, `--book`, `--language`, `--limit`; `--in narrators\|scholars`, `--tradition sunni\|shia`; `--recent`, `--clear-recent` |
 | `iy chain BOOK NUMBER` | `iy chain kafi 5:1740` | One chain, narrator by narrator, with who each one is and whom it reaches; `--raw` adds the wording; without a number, the book's range |
 | `iy isnads` | `iy isnads --rebuild` | Read every chain and report per book: split, reaching the Prophet or a Ma'sum, identified |
-| `iy narrator NAME` | `iy narrator "Ibn Umar"` | A narrator: his critic's verdict (Ibn Hajar's rank, or the Imami terms), tabaqa, death year, books; `--limit 1` adds teachers, students and hadith |
+| `iy narrator NAME` | `iy narrator "Ibn Umar"` | A narrator: his critic's verdict (Ibn Hajar's rank, or the Imami terms), tabaqa, death year, books; `--limit 1` adds teachers, students and hadith; `--famous` lists the famous Companions by group (`--tradition shia`: Ashab al-Ijma') |
 | `iy book [KEY [CHAPTER]]` | `iy book bukhari 2` | The books; a book's chapters; a chapter read in order |
 | `iy scholar [NAME]` | `iy scholar albani` | The scholars in the data, or one of them with his measured statistics |
 | `iy tahric BOOK NUMBER` | `iy tahric bukhari 1` | Other narrations of a hadith in the imported books (takhrij) |

package/index.d.ts

@@ -1,11 +1,11 @@
-export declare const version: string;
-export declare const name: string;
-
-export interface IsnadyInfo {
-  name: string;
-  version: string;
-  dataLoaded: boolean;
-  homepage: string;
-}
-
-export declare function info(): IsnadyInfo;
+export declare const version: string;
+export declare const name: string;
+
+export interface IsnadyInfo {
+  name: string;
+  version: string;
+  dataLoaded: boolean;
+  homepage: string;
+}
+
+export declare function info(): IsnadyInfo;

package/index.js

@@ -6,7 +6,7 @@
  * database (used by both the Python and JavaScript packages) exists.
  */
 
-export const version = "0.3.4";
+export const version = "0.3.6";
 export const name = "isnady";
 
 /** Returns basic package information. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "isnady",
-  "version": "0.3.4",
+  "version": "0.3.6",
   "description": "Hadith search with full isnad chains, narrator biographies, jarh wa ta'dil verdicts and reliability scores",
   "type": "module",
   "main": "./index.js",