Glossary

Used as the basic unit for referring to the Quranic text, and for attaching translations, tafsir, recitations, analyses and other data to a specific place in the Quran.

Used to mark an ayah's boundary in the written text; it is the sign from which a renderer or an analyser reads where an ayah ends and what its number is.

This is the single most common source of silent bugs in Qur'an software. 6,236 is not a constant — it is the Kufan count, which is what Ḥafṣ uses, which is why it looks universal. Hard-code it and your app breaks the moment a user selects another riwayah. Two further traps: a counting system's published total and the ayah count printed in a given muṣḥaf are different numbers and can disagree, and two systems can share a total while placing their boundaries differently. Read the count from the loaded data, and translate references with Qiraat Ayah Map.

Used to identify the basmalah and to represent its position and its relation to the surah and to the ayah numbering system.

Check it. Because encodings diverge invisibly, a wrong-but-plausible text does not throw — it silently mislabels letters. The digest is what converts that into a loud failure at load time.

Qiraat Ayah Map records each disputed position by its fāṣilah wording, in `word`. Treat it as a human-readable anchor, not a join key — it is a bare orthographic form, not the muṣḥaf's spelling, and it carries no word index. Locate the position by ayah number instead.

Used as the parent of the dabt marks that determine how the letter itself is pronounced.

Used when the properties of the written representation matter: rasm, layout, pages, lines and marks.

Two texts of the same ayah from two of our own repositories are frequently not byte-identical, and Unicode NFC does not fully resolve it. Practical rule: character offsets are only valid against the exact text they were computed from. Ship the text with the offsets, or ship a digest so a mismatch is caught loudly instead of silently pointing at the wrong letters.

A frame asset gives you the text area as a rectangle, so you can lay text out inside it rather than guessing a margin. Where the border repeats along its sides it also ships as separate corner and edge pieces, which is how you fit it to a page shape the printed original never had.

It gives you hit-testing without doing any text layout: mount the vector, attach handlers to the ayah regions, and taps resolve to references. The coordinates belong to that page of that muṣḥaf, so they are not portable to another edition.

It is what lets you answer "where did this text come from" in a review or an audit, without re-deriving it. Every dataset we ship carries one, and the site's provenance registry lists them.

Represents the top level of the qiraat model and ties together the riwayahs, the tariqs and the texts bound to them.

Used as a classification stating which rasm a text, a mushaf or a dataset is written in, so that search, comparison and rendering branch on it; and it keeps the layer of the rasm distinct from the font, the layout and the drawn glyphs.

Used to represent the person a `riwayah` is bound to.

Our packages use this form everywhere as an object key: "1:1", "2:255", "1:1:3". It is a string, not a number pair, so it sorts lexically rather than numerically — sort on the parsed integers if order matters.

Used to state which riwayah a text, a mushaf, a recording or a dataset follows.

Used as a value of harakah, so that a letter's pronunciation is read from it in analysis, rendering and teaching rather than from the shape of the mark.

Used as the principal unit for organising the text and for attaching ayahs and surah-level data.

When this ornament ships as an asset the name is not part of the artwork — the artwork keeps an empty rectangle where the name belongs and you draw the text yourself. That rectangle's position is published with the file, so you can place your own type at any size without re-measuring the picture.

Used as the discipline that tajwid rules, rulings and colour annotations belong to, so that a rule in an engine or a dictionary is attributed to it.

Used as the parent of the rulings of tajwid and the holder of their registry, so that the places in the text where a ruling falls are attributed to it, and a particular ruling is named by a row of the registry rather than by a free name that differs from one engine to another.

Represents the general concept of stopping, while `waqf_mark` represents the printed signs that point to it.

This is the join key across our blocks. Address a word as `surah:ayah:word`, and highlighting, tapping and annotation all line up. Matching on the Arabic string instead will fail, because encodings differ.