Quran Entity Experience v3
==========================

Purpose
-------
Adds a complete Entity experience on top of the existing Quran Knowledge Engine:
- Entity details
- Breadcrumb
- Linked ayahs
- Related entities
- Aliases and tags
- Navigation between entities using UUID
- Shareable URL parameter: ?entity=entity-slug

Files
-----
api/entity-full.php
assets/js/quran-entity-view.js
assets/css/quran-entity-view.css

Installation
------------
1. Upload the three files to the matching folders under public_html/Quran/.

2. Edit public_html/Quran/index.php.

Inside <head>, after quran.css, add:
<link rel="stylesheet" href="assets/css/quran-entity-view.css">

Before </body>, after quran-explorer.js, add:
<script src="assets/js/quran-entity-view.js"></script>

3. Hard refresh with Ctrl+F5.

API tests
---------
Patience by topic:
https://how-2-know.com/Quran/api/entity-full.php?topic_id=33

Patience by slug:
https://how-2-know.com/Quran/api/entity-full.php?slug=topic-patience

Frontend direct link:
https://how-2-know.com/Quran/?entity=topic-patience

Opening from existing JavaScript
--------------------------------
Use either:

window.QuranKnowledgeEntity.openByTopicId(33);

window.QuranKnowledgeEntity.openByUuid('UUID-HERE');

window.QuranKnowledgeEntity.openBySlug('topic-patience');

Existing related cards
----------------------
The script automatically handles clicks on elements containing any of:
data-qke-uuid="..."
data-entity-uuid="..."
data-qke-slug="..."

To make an existing related card open the entity drawer, ensure its HTML includes:
data-entity-uuid="${item.Entity_UUID}"
