@geoalgeria/culture 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-2026 Yasser's Studio (https://yasser.studio)
+
+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.ar.md

@@ -0,0 +1,190 @@
+[English](README.md) | [Français](README.fr.md) | **العربية**
+
+<div align="center">
+
+# @geoalgeria/culture
+
+**الأطلس الثقافي للجزائر — كبيانات قابلة للتثبيت.**
+
+[![npm](https://img.shields.io/npm/v/@geoalgeria/culture)](https://www.npmjs.com/package/@geoalgeria/culture)
+[![npm downloads](https://img.shields.io/npm/dm/@geoalgeria/culture)](https://www.npmjs.com/package/@geoalgeria/culture)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
+
+</div>
+
+**1083 موقعًا ثقافيًا** عبر **66 ولاية من أصل 69 في الجزائر** — الممتلكات الثقافية
+المحمية، والمتاحف، والمسارح، والمكتبات، والمؤسسات الثقافية (دور وقصور الثقافة،
+وقاعات السينما، ومديريات الثقافة، ومدارس الفنون) من أطلس *خريطة التراث الثقافي
+الجزائري* التابع لـ**وزارة الثقافة**، **ثنائية اللغة 100%** عربي/فرنسي و**كاملة
+الإحداثيات** (كل موقع يحمل إحداثية مصدرية). متوفر بصيغ JSON وCSV وGeoJSON
+وTypeScript. جزء من [GeoAlgeria](https://github.com/yasserstudio/geoalgeria).
+
+```bash
+npm install @geoalgeria/culture
+```
+
+```js
+import culture from "@geoalgeria/culture";
+
+const all = culture.culture();          // 1083 موقعًا ثقافيًا
+
+// المتاحف في ولاية (ربط بـ wilaya_code في GeoAlgeria)
+const museesAlger = all.filter((p) => p.wilaya_code === "16" && p.type === "museum");
+
+// فقط الممتلكات الثقافية المحمية، جاهزة للخريطة
+const patrimoine = all.filter((p) => p.category === "heritage");
+
+// المواقع ذات الجولة الافتراضية 360°
+const visites = all.filter((p) => p.has_virtual_tour);
+```
+
+## ما يمكنك بناؤه
+
+- **خرائط ثقافية والبحث عن الأقرب** — لكلٍّ من المواقع الـ1083 إحداثيات، جاهزة
+  للخريطة أو لميزة «بالقرب مني».
+- **أدلّة ثقافية ثنائية اللغة** — أسماء عربية وفرنسية، والنوع الرسمي والولاية لكل
+  موقع؛ مع تصفية التراث مقابل المؤسسات العاملة.
+- **تطبيقات التراث والسياحة** — المواقع المحمية والمتاحف والجولات الافتراضية 360°،
+  مربوطة بالبلدية/الولاية لتحديد المسارات وتحليل التغطية.
+
+## المحتوى
+
+| مجموعة البيانات | العدد | الإحداثيات | ملاحظات |
+| --- | --- | --- | --- |
+| المواقع الثقافية | **1083** | 1083 بإحداثيات | 66 ولاية، ثنائية اللغة 100%، 22 بجولة 360° |
+
+**حسب الفئة**
+
+| الفئة | العدد | المعنى |
+| --- | --- | --- |
+| `heritage` | 943 | مواقع محمية، متاحف، مسارح، مكتبات |
+| `establishment` | 140 | مؤسسات ثقافية عاملة ومديريات |
+
+**حسب النوع**
+
+| النوع | العدد | المعنى |
+| --- | --- | --- |
+| `protected-cultural-property` | 580 | ممتلك ثقافي محمي — نصب/موقع محمي |
+| `library` | 257 | مكتبة المطالعة العمومية |
+| `museum` | 48 | متحف |
+| `theatre` | 45 | مسرح |
+| `museum-moudjahid` | 13 | متحف المجاهد |
+| `cultural-house` | 51 | دار الثقافة |
+| `cultural-directorate` | 33 | مديرية الثقافة / ديوان |
+| `cinema` | 20 | قاعة سينما / سينماتيك |
+| `cultural-center` | 15 | مركز ثقافي / بحثي |
+| `arts-school` | 15 | مدرسة الفنون — الفنون الجميلة / معهد |
+| `cultural-palace` | 6 | قصر الثقافة |
+
+> **الأطلس رسمي؛ أما الإحداثيات فأفضل ما أمكن.** الأسماء والنوع والإحداثيات وعلامة
+> الـ360° من بوابة وزارة الثقافة. الولاية دقيقة؛ أما البلدية فمُستنتَجة (انظر
+> *المصدر والمنهجية*). تتغيّر الأعداد مع تحديثات البوابة.
+
+## الصيغ
+
+تتضمّن حزمة npm ملف **JSON** (قابل للاستيراد مباشرة):
+
+```js
+import culture from "@geoalgeria/culture/data/culture.json" with { type: "json" };
+// أو عبر CDN، دون تثبيت:
+// https://cdn.jsdelivr.net/npm/@geoalgeria/culture/data/culture.json
+```
+
+المُحمِّلات وبنية السجلات **مُوثَّقة الأنواع** بالكامل — تعريفات TypeScript مرفقة في الحزمة:
+
+```ts
+import culture, { type CulturalSite } from "@geoalgeria/culture";
+const all: CulturalSite[] = culture.culture();
+```
+
+ملفّا **CSV وGeoJSON** موجودان في المستودع ضمن [`data/`](data) ومُرفقان في كل
+[إصدار على GitHub](https://github.com/yasserstudio/geoalgeria/releases):
+
+```
+data/
+  culture.json              # 1083 موقعًا ثقافيًا (مصفوفة)
+  metadata.json             # المصادر، الأعداد، التغطية، generated_at
+  csv/culture.csv           # المستودع + الإصدار
+  geojson/culture.geojson   # معالم نقطية (كل السجلات)
+```
+
+## بنية السجل
+
+```json
+{
+  "id": "16-museum-03",
+  "name": "Musée national Public d'art moderne et contemporain",
+  "name_ar": "المتحف العمومي الوطني للفن الحديث و المعاصر",
+  "name_fr": "Musée national Public d'art moderne et contemporain",
+  "type": "museum",
+  "category": "heritage",
+  "type_label_fr": "Musée",
+  "type_label_ar": "متحف",
+  "has_virtual_tour": true,
+  "wilaya": "Alger",
+  "wilaya_ar": "الجزائر",
+  "wilaya_code": "16",
+  "commune": "Casbah",
+  "commune_code": 1607,
+  "source": "patrimoineculturel",
+  "geo_precision": "source_point",
+  "url": "https://cartes.patrimoineculturelalgerien.org/fr/node/101",
+  "node_id_fr": 101,
+  "node_id_ar": 817,
+  "slug": "musee-national-public-d-art-moderne-et-contemporain",
+  "lat": 36.777301,
+  "lng": 3.057572
+}
+```
+
+`id` مفتاح ثابت `{wilaya_code}-{type_code}-{seq}` يولّده GeoAlgeria. `name` هو
+الاسم الفرنسي إن وُجد، وإلا العربي. `type` هو طبقة الموقع على البوابة، و`category`
+يجمع الأنواع الـ11 في `heritage` مقابل `establishment`. `has_virtual_tour` يساوي
+`true` للمواقع الـ22 ذات الجولة 360°. `geo_precision` يساوي `"source_point"` لكل
+سجل.
+
+> **الولاية دقيقة؛ أما البلدية فمُستنتَجة.** لا تزال البوابة تصنّف بعض المواقع تحت
+> رموز ولايات ما قبل 2019؛ يعيد GeoAlgeria إسناد كل موقع إلى التقسيم الحالي البالغ
+> 69 ولاية بمطابقة إحداثيته لأقرب مركز ثقل بلدية في
+> [`geoalgeria`](https://www.npmjs.com/package/geoalgeria) (الذي يوفّر أيضًا
+> `commune`/`commune_code`). البلدية تقريبية (الحزمة الرئيسية توفّر مراكز ثقل لا
+> مضلّعات حدود).
+
+## تحتاج التقسيمات الإدارية أيضًا؟
+
+للولايات والدوائر والبلديات، استخدم الحزمة الرئيسية
+**[`geoalgeria`](https://www.npmjs.com/package/geoalgeria)** — بها تحوّل
+`commune_code` لموقعٍ ما إلى مضلّع أو مركز ثقل. استخدم `@geoalgeria/culture` عندما
+تحتاج المواقع الثقافية *فقط*.
+
+## المصدر والمنهجية
+
+شغّل `npm run fetch` لإعادة توليد المخرجات. يقوم السكربت بـ:
+
+1. قراءة الأطلس الثقافي ثنائي اللغة المُنسَّق (المُجمَّع والمُترجَم من بوابة
+   `cartes.patrimoineculturelalgerien.org` التابعة لوزارة الثقافة — كتالوجا
+   البوابة الفرنسي والعربي مجموعتا عُقَد منفصلتان، تُوحَّدان بتقارب الإحداثيات
+   وتُترجَمان لسدّ الفجوات الثنائية)؛
+2. **إعادة إسناد** كل موقع إلى التقسيم الحالي البالغ 69 ولاية وربط
+   `commune`/`commune_code` به بمطابقته لأقرب مركز ثقل بلدية في `geoalgeria`؛
+3. إسناد معرّفات ثابتة، وإزالة العُقَد المكرّرة، وإنتاج JSON وCSV وGeoJSON
+   والبيانات الوصفية.
+
+المصدر المُنسَّق وملاحظات الاستخراج تحت
+[`research/patrimoine/`](https://github.com/yasserstudio/geoalgeria/tree/main/research/patrimoine).
+
+## الترخيص والإسناد
+
+**شيفرة** الحزمة بترخيص [MIT](LICENSE). أما **البيانات** فهي قائمة واقعية عمومية
+من بوابة التراث الثقافي لـ**وزارة الثقافة** (الأسماء والأنواع والإحداثيات وجولات
+360° كما نُشرت). ربط البلدية/الولاية مُستنتَج من المجموعة الإدارية
+[`geoalgeria`](https://www.npmjs.com/package/geoalgeria).
+
+تحقّق من المصادر الرسمية للمعلومات الموثوقة. تُقدَّم هذه البيانات للمرجعية ولتشغيل
+[GeoAlgeria](https://geoalgeria.com).
+
+[توثيق API والحقول →](https://geoalgeria.com/data/docs/culture) · [تصفّح كل الحزم →](https://geoalgeria.com/data)
+
+---
+
+من إنجاز [Yasser's Studio](https://yasser.studio) · [LinkedIn](https://www.linkedin.com/in/yasserberrehail/) · [X](https://x.com/yassersstudio) · [hello@yasser.studio](mailto:hello@yasser.studio)

package/README.fr.md

@@ -0,0 +1,196 @@
+[English](README.md) | **Français** | [العربية](README.ar.md)
+
+<div align="center">
+
+# @geoalgeria/culture
+
+**L'atlas culturel de l'Algérie — sous forme de données prêtes à installer.**
+
+[![npm](https://img.shields.io/npm/v/@geoalgeria/culture)](https://www.npmjs.com/package/@geoalgeria/culture)
+[![npm downloads](https://img.shields.io/npm/dm/@geoalgeria/culture)](https://www.npmjs.com/package/@geoalgeria/culture)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
+
+</div>
+
+**1 083 lieux culturels** dans **66 des 69 wilayas d'Algérie** — biens culturels
+protégés, musées, théâtres, bibliothèques et établissements culturels (maisons et
+palais de la culture, salles de cinéma, directions de la culture, écoles d'art) de
+l'atlas *Cartes du Patrimoine Culturel Algérien* du **Ministère de la Culture**,
+**100 % bilingues** français/arabe et **entièrement géolocalisés** (chaque lieu
+porte une coordonnée source). Livré en JSON, CSV, GeoJSON et TypeScript. Fait
+partie de [GeoAlgeria](https://github.com/yasserstudio/geoalgeria).
+
+```bash
+npm install @geoalgeria/culture
+```
+
+```js
+import culture from "@geoalgeria/culture";
+
+const all = culture.culture();          // 1 083 lieux culturels
+
+// Musées d'une wilaya (jointure sur le wilaya_code de GeoAlgeria)
+const museesAlger = all.filter((p) => p.wilaya_code === "16" && p.type === "museum");
+
+// Uniquement les biens culturels protégés, prêts pour une carte
+const patrimoine = all.filter((p) => p.category === "heritage");
+
+// Les lieux dotés d'une visite virtuelle à 360°
+const visites = all.filter((p) => p.has_virtual_tour);
+```
+
+## Ce que vous pouvez construire
+
+- **Cartes culturelles & recherche de proximité** — chacun des 1 083 lieux a des
+  coordonnées, prêtes pour une carte ou une fonction « à proximité ».
+- **Annuaires culturels bilingues** — noms français et arabe, type officiel et
+  wilaya pour chaque lieu ; filtrer patrimoine vs établissements en activité.
+- **Applications patrimoine & tourisme** — sites protégés, musées et visites
+  virtuelles à 360°, rattachés à la commune/wilaya pour l'itinéraire et l'analyse.
+
+## Contenu
+
+| Jeu de données | Nombre | Coordonnées | Notes |
+| --- | --- | --- | --- |
+| Lieux culturels | **1 083** | 1 083 géolocalisés | 66 wilayas, 100 % bilingues, 22 visites 360° |
+
+**Par catégorie**
+
+| Catégorie | Nombre | Signification |
+| --- | --- | --- |
+| `heritage` | 943 | sites protégés, musées, théâtres, bibliothèques |
+| `establishment` | 140 | lieux culturels en activité & directions |
+
+**Par type**
+
+| Type | Nombre | Signification |
+| --- | --- | --- |
+| `protected-cultural-property` | 580 | Bien culturel protégé — monument/site protégé |
+| `library` | 257 | Bibliothèque de lecture publique |
+| `museum` | 48 | Musée |
+| `theatre` | 45 | Théâtre |
+| `museum-moudjahid` | 13 | Musée du Moudjahid |
+| `cultural-house` | 51 | Maison de la culture |
+| `cultural-directorate` | 33 | Direction de la culture / office |
+| `cinema` | 20 | Salle de cinéma / cinémathèque |
+| `cultural-center` | 15 | Centre culturel / de recherche |
+| `arts-school` | 15 | École d'art — beaux-arts / conservatoire |
+| `cultural-palace` | 6 | Palais de la culture |
+
+> **L'atlas est officiel ; les coordonnées sont au mieux.** Les noms, le type, les
+> coordonnées et le drapeau 360° proviennent du portail du Ministère de la
+> Culture. La wilaya est exacte ; la commune est dérivée (voir *Source &
+> méthode*). Les totaux évoluent au gré des mises à jour du portail.
+
+## Formats
+
+Le paquet npm fournit le **JSON** (importable directement) :
+
+```js
+import culture from "@geoalgeria/culture/data/culture.json" with { type: "json" };
+// ou via CDN, sans installation :
+// https://cdn.jsdelivr.net/npm/@geoalgeria/culture/data/culture.json
+```
+
+Les chargeurs et les enregistrements sont entièrement **typés** — les définitions TypeScript sont incluses :
+
+```ts
+import culture, { type CulturalSite } from "@geoalgeria/culture";
+const all: CulturalSite[] = culture.culture();
+```
+
+Les **CSV et GeoJSON** sont dans le dépôt sous [`data/`](data) et inclus dans
+chaque [GitHub Release](https://github.com/yasserstudio/geoalgeria/releases) :
+
+```
+data/
+  culture.json              # 1 083 lieux culturels (tableau)
+  metadata.json             # sources, totaux, couverture, generated_at
+  csv/culture.csv           # dépôt + Release
+  geojson/culture.geojson   # entités Point (chaque enregistrement)
+```
+
+## Structure d'un enregistrement
+
+```json
+{
+  "id": "16-museum-03",
+  "name": "Musée national Public d'art moderne et contemporain",
+  "name_ar": "المتحف العمومي الوطني للفن الحديث و المعاصر",
+  "name_fr": "Musée national Public d'art moderne et contemporain",
+  "type": "museum",
+  "category": "heritage",
+  "type_label_fr": "Musée",
+  "type_label_ar": "متحف",
+  "has_virtual_tour": true,
+  "wilaya": "Alger",
+  "wilaya_ar": "الجزائر",
+  "wilaya_code": "16",
+  "commune": "Casbah",
+  "commune_code": 1607,
+  "source": "patrimoineculturel",
+  "geo_precision": "source_point",
+  "url": "https://cartes.patrimoineculturelalgerien.org/fr/node/101",
+  "node_id_fr": 101,
+  "node_id_ar": 817,
+  "slug": "musee-national-public-d-art-moderne-et-contemporain",
+  "lat": 36.777301,
+  "lng": 3.057572
+}
+```
+
+`id` est une clé stable `{wilaya_code}-{type_code}-{seq}` synthétisée par
+GeoAlgeria. `name` est le nom français s'il existe, sinon l'arabe. `type` est la
+couche du lieu sur le portail ; `category` regroupe les 11 types en `heritage` vs
+`establishment`. `has_virtual_tour` vaut `true` pour les 22 lieux dotés d'une
+visite 360°. `geo_precision` vaut `"source_point"` pour chaque enregistrement.
+
+> **La wilaya est exacte ; la commune est dérivée.** Le portail classe encore
+> certains lieux sous d'anciens codes de wilaya ; GeoAlgeria les réaffecte au
+> découpage actuel à 69 wilayas en rattachant chaque coordonnée au centroïde de
+> commune [`geoalgeria`](https://www.npmjs.com/package/geoalgeria) le plus proche
+> (qui fournit aussi `commune`/`commune_code`). La commune est approximative (le
+> paquet principal fournit des centroïdes, pas des polygones de limites).
+
+## Besoin des divisions administratives ?
+
+Pour les wilayas, dairas et communes, utilisez le paquet principal
+**[`geoalgeria`](https://www.npmjs.com/package/geoalgeria)** — c'est ce qui
+transforme le `commune_code` d'un lieu en polygone ou centroïde. Utilisez
+`@geoalgeria/culture` quand vous n'avez besoin *que* des lieux culturels.
+
+## Source & méthode
+
+Lancez `npm run fetch` pour régénérer les sorties. Le script :
+
+1. lit l'atlas culturel bilingue curé (assemblé et traduit depuis le portail
+   `cartes.patrimoineculturelalgerien.org` du Ministère de la Culture — les
+   catalogues français et arabe du portail sont des ensembles de nœuds disjoints,
+   unis par proximité de coordonnées et traduits pour combler les manques
+   bilingues) ;
+2. **réaffecte** chaque lieu au découpage actuel à 69 wilayas et lui rattache une
+   `commune`/`commune_code` en le rapprochant du centroïde de commune `geoalgeria`
+   le plus proche ;
+3. attribue des identifiants stables, retire les nœuds en double, et produit le
+   JSON, le CSV, le GeoJSON et les métadonnées.
+
+La source curée et les notes d'extraction sont sous
+[`research/patrimoine/`](https://github.com/yasserstudio/geoalgeria/tree/main/research/patrimoine).
+
+## Licence & attribution
+
+Le **code** du paquet est sous [MIT](LICENSE). Les **données** sont une liste
+factuelle publique du portail du patrimoine culturel du **Ministère de la
+Culture** (noms, types, coordonnées et visites 360° tels que publiés). Le
+rattachement commune/wilaya est dérivé du jeu administratif
+[`geoalgeria`](https://www.npmjs.com/package/geoalgeria).
+
+Vérifiez auprès des sources officielles pour toute information faisant foi. Ce jeu
+de données est fourni à titre de référence et pour alimenter
+[GeoAlgeria](https://geoalgeria.com).
+
+[Docs API & champs →](https://geoalgeria.com/data/docs/culture) · [Tous les paquets →](https://geoalgeria.com/data)
+
+---
+
+Réalisé par [Yasser's Studio](https://yasser.studio) · [LinkedIn](https://www.linkedin.com/in/yasserberrehail/) · [X](https://x.com/yassersstudio) · [hello@yasser.studio](mailto:hello@yasser.studio)

package/README.md

@@ -0,0 +1,194 @@
+**English** | [Français](README.fr.md) | [العربية](README.ar.md)
+
+<div align="center">
+
+# @geoalgeria/culture
+
+**Algeria's cultural atlas — as data you can install.**
+
+[![npm](https://img.shields.io/npm/v/@geoalgeria/culture)](https://www.npmjs.com/package/@geoalgeria/culture)
+[![npm downloads](https://img.shields.io/npm/dm/@geoalgeria/culture)](https://www.npmjs.com/package/@geoalgeria/culture)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
+
+</div>
+
+**1,083 cultural places** across **66 of Algeria's 69 wilayas** — protected
+heritage sites, museums, theatres, libraries and cultural establishments (maisons
+& palais de la culture, cinemas, culture directorates, arts schools) from the
+**Ministry of Culture's** *Cartes du Patrimoine Culturel Algérien* atlas,
+**100% bilingual** French/Arabic and **fully geocoded** (every place carries a
+source coordinate). Shipped as JSON, CSV, GeoJSON, and TypeScript. Part of
+[GeoAlgeria](https://github.com/yasserstudio/geoalgeria).
+
+```bash
+npm install @geoalgeria/culture
+```
+
+```js
+import culture from "@geoalgeria/culture";
+
+const all = culture.culture();          // 1,083 cultural places
+
+// Museums in a wilaya (joins GeoAlgeria's wilaya_code)
+const museumsAlger = all.filter((p) => p.wilaya_code === "16" && p.type === "museum");
+
+// Just the protected heritage sites, ready to map
+const heritage = all.filter((p) => p.category === "heritage");
+
+// Places with a 360° virtual tour
+const tours = all.filter((p) => p.has_virtual_tour);
+```
+
+## What you can build
+
+- **Cultural maps & nearest-place search** — every one of the 1,083 places has
+  coordinates, ready for a map or a "what's near me" feature.
+- **Bilingual cultural directories** — French and Arabic names, official type and
+  wilaya for every place; filter heritage vs. operating establishments.
+- **Heritage & tourism apps** — protected sites, museums and 360° virtual tours,
+  linked to commune/wilaya for routing and coverage analysis.
+
+## What's inside
+
+| Dataset | Count | Coordinates | Notes |
+| --- | --- | --- | --- |
+| Cultural places | **1,083** | 1,083 geocoded | 66 wilayas, 100% bilingual, 22 with 360° tours |
+
+**By category**
+
+| Category | Count | Meaning |
+| --- | --- | --- |
+| `heritage` | 943 | protected sites, museums, theatres, libraries |
+| `establishment` | 140 | operating cultural venues & directorates |
+
+**By type**
+
+| Type | Count | Meaning |
+| --- | --- | --- |
+| `protected-cultural-property` | 580 | Bien culturel protégé — protected monument/site |
+| `library` | 257 | Bibliothèque — public reading library |
+| `museum` | 48 | Musée — museum |
+| `theatre` | 45 | Théâtre — theatre |
+| `museum-moudjahid` | 13 | Musée du Moudjahid — museum of the war of independence |
+| `cultural-house` | 51 | Maison de la culture |
+| `cultural-directorate` | 33 | Direction de la culture — wilaya culture directorate/office |
+| `cinema` | 20 | Salle de cinéma — cinema / cinematheque |
+| `cultural-center` | 15 | Centre culturel — cultural / research centre |
+| `arts-school` | 15 | École d'art — fine-arts school / conservatory |
+| `cultural-palace` | 6 | Palais de la culture |
+
+> **The atlas is official; treat the coordinates as best-effort.** Names, type,
+> coordinates and the 360° flag come from the Ministry of Culture's portal. Wilaya
+> is exact; commune is derived (see *Source & method*). Counts move as the portal
+> is edited; each rebuild reflects its current state.
+
+## Formats
+
+The npm package ships the **JSON** (importable directly):
+
+```js
+import culture from "@geoalgeria/culture/data/culture.json" with { type: "json" };
+// or via CDN, no install:
+// https://cdn.jsdelivr.net/npm/@geoalgeria/culture/data/culture.json
+```
+
+The loaders and record shapes are fully **typed** — TypeScript definitions ship in the package:
+
+```ts
+import culture, { type CulturalSite } from "@geoalgeria/culture";
+const all: CulturalSite[] = culture.culture();
+```
+
+**CSV and GeoJSON** are in the repo under [`data/`](data) and bundled in every
+[GitHub Release](https://github.com/yasserstudio/geoalgeria/releases):
+
+```
+data/
+  culture.json              # 1,083 cultural places (array)
+  metadata.json             # sources, counts, coverage, generated_at
+  csv/culture.csv           # repo + Release bundle
+  geojson/culture.geojson   # Point features (every record)
+```
+
+## Record shape
+
+```json
+{
+  "id": "16-museum-03",
+  "name": "Musée national Public d'art moderne et contemporain",
+  "name_ar": "المتحف العمومي الوطني للفن الحديث و المعاصر",
+  "name_fr": "Musée national Public d'art moderne et contemporain",
+  "type": "museum",
+  "category": "heritage",
+  "type_label_fr": "Musée",
+  "type_label_ar": "متحف",
+  "has_virtual_tour": true,
+  "wilaya": "Alger",
+  "wilaya_ar": "الجزائر",
+  "wilaya_code": "16",
+  "commune": "Casbah",
+  "commune_code": 1607,
+  "source": "patrimoineculturel",
+  "geo_precision": "source_point",
+  "url": "https://cartes.patrimoineculturelalgerien.org/fr/node/101",
+  "node_id_fr": 101,
+  "node_id_ar": 817,
+  "slug": "musee-national-public-d-art-moderne-et-contemporain",
+  "lat": 36.777301,
+  "lng": 3.057572
+}
+```
+
+`id` is a stable `{wilaya_code}-{type_code}-{seq}` key synthesized by GeoAlgeria.
+`name` is the French name where available, else Arabic. `type` is the place's
+layer on the portal; `category` groups the 11 types into `heritage` vs.
+`establishment`. `has_virtual_tour` is true for the 22 places with a 360° tour.
+`geo_precision` is `"source_point"` for every record — the portal publishes a
+coordinate for each place.
+
+> **Wilaya is exact; commune is derived.** The portal still files some places
+> under pre-2019 wilaya codes; GeoAlgeria rescopes each place to the current
+> 69-wilaya scheme by matching its coordinate to the nearest
+> [`geoalgeria`](https://www.npmjs.com/package/geoalgeria) commune centroid (which
+> also yields `commune`/`commune_code`). Commune is best-effort (the flagship
+> ships centroids, not boundary polygons).
+
+## Need the administrative divisions too?
+
+For wilayas, dairas, and communes, use the main
+**[`geoalgeria`](https://www.npmjs.com/package/geoalgeria)** package — it's how
+you turn a place's `commune_code` into a polygon or centroid. Use
+`@geoalgeria/culture` when you *only* need the cultural places.
+
+## Source & method
+
+Run `npm run fetch` to regenerate every output. It:
+
+1. reads the curated, bilingual cultural atlas (assembled and translated from the
+   Ministry of Culture's `cartes.patrimoineculturelalgerien.org` portal — the
+   portal's French and Arabic catalogs are disjoint node sets, unioned by
+   coordinate proximity and translated to fill the bilingual gaps);
+2. **rescopes** each place to the current 69-wilaya scheme and attaches a
+   `commune`/`commune_code` by matching its coordinate to the nearest `geoalgeria`
+   commune centroid;
+3. assigns stable ids, drops exact duplicate nodes, and emits JSON, CSV, GeoJSON
+   and metadata.
+
+The curated source and extraction notes are under
+[`research/patrimoine/`](https://github.com/yasserstudio/geoalgeria/tree/main/research/patrimoine).
+
+## License & attribution
+
+Package **code** is [MIT](LICENSE). The **data** is a factual public listing from
+the **Ministry of Culture's** cultural-heritage portal (names, types, coordinates
+and 360° tours as published). Commune/wilaya linkage is derived from the
+[`geoalgeria`](https://www.npmjs.com/package/geoalgeria) administrative dataset.
+
+Verify against official sources for authoritative information. This dataset is
+provided for reference and to power [GeoAlgeria](https://geoalgeria.com).
+
+[API docs & field reference →](https://geoalgeria.com/data/docs/culture) · [Browse all packages →](https://geoalgeria.com/data)
+
+---
+
+Made by [Yasser's Studio](https://yasser.studio) · [LinkedIn](https://www.linkedin.com/in/yasserberrehail/) · [X](https://x.com/yassersstudio) · [hello@yasser.studio](mailto:hello@yasser.studio)