@geoalgeria/culture 2.0.0 → 2.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.ar.md CHANGED
@@ -4,7 +4,7 @@
4
4
 
5
5
  # @geoalgeria/culture
6
6
 
7
- **الأطلس الثقافي للجزائر كبيانات قابلة للتثبيت.**
7
+ **الأطلس الثقافي للجزائر، كبيانات قابلة للتثبيت.**
8
8
 
9
9
  [![npm](https://img.shields.io/npm/v/@geoalgeria/culture)](https://www.npmjs.com/package/@geoalgeria/culture)
10
10
  [![npm downloads](https://img.shields.io/npm/dm/@geoalgeria/culture)](https://www.npmjs.com/package/@geoalgeria/culture)
@@ -12,7 +12,7 @@
12
12
 
13
13
  </div>
14
14
 
15
- **1083 موقعًا ثقافيًا** عبر **66 ولاية من أصل 69 في الجزائر** الممتلكات الثقافية
15
+ **1083 موقعًا ثقافيًا** عبر **66 ولاية من أصل 69 في الجزائر** الممتلكات الثقافية
16
16
  المحمية، والمتاحف، والمسارح، والمكتبات، والمؤسسات الثقافية (دور وقصور الثقافة،
17
17
  وقاعات السينما، ومديريات الثقافة، ومدارس الفنون) من أطلس *خريطة التراث الثقافي
18
18
  الجزائري* التابع لـ**وزارة الثقافة**، **ثنائية اللغة 100%** عربي/فرنسي و**كاملة
@@ -40,11 +40,11 @@ const visites = all.filter((p) => p.has_virtual_tour);
40
40
 
41
41
  ## ما يمكنك بناؤه
42
42
 
43
- - **خرائط ثقافية والبحث عن الأقرب** لكلٍّ من المواقع الـ1083 إحداثيات، جاهزة
43
+ - **خرائط ثقافية والبحث عن الأقرب** لكلٍّ من المواقع الـ1083 إحداثيات، جاهزة
44
44
  للخريطة أو لميزة «بالقرب مني».
45
- - **أدلّة ثقافية ثنائية اللغة** أسماء عربية وفرنسية، والنوع الرسمي والولاية لكل
45
+ - **أدلّة ثقافية ثنائية اللغة** أسماء عربية وفرنسية، والنوع الرسمي والولاية لكل
46
46
  موقع؛ مع تصفية التراث مقابل المؤسسات العاملة.
47
- - **تطبيقات التراث والسياحة** المواقع المحمية والمتاحف والجولات الافتراضية 360°،
47
+ - **تطبيقات التراث والسياحة** المواقع المحمية والمتاحف والجولات الافتراضية 360°،
48
48
  مربوطة بالبلدية/الولاية لتحديد المسارات وتحليل التغطية.
49
49
 
50
50
  ## المحتوى
@@ -64,7 +64,7 @@ const visites = all.filter((p) => p.has_virtual_tour);
64
64
 
65
65
  | النوع | العدد | المعنى |
66
66
  | --- | --- | --- |
67
- | `protected-cultural-property` | 580 | ممتلك ثقافي محمي نصب/موقع محمي |
67
+ | `protected-cultural-property` | 580 | ممتلك ثقافي محمي نصب/موقع محمي |
68
68
  | `library` | 257 | مكتبة المطالعة العمومية |
69
69
  | `museum` | 48 | متحف |
70
70
  | `theatre` | 45 | مسرح |
@@ -73,7 +73,7 @@ const visites = all.filter((p) => p.has_virtual_tour);
73
73
  | `cultural-directorate` | 33 | مديرية الثقافة / ديوان |
74
74
  | `cinema` | 20 | قاعة سينما / سينماتيك |
75
75
  | `cultural-center` | 15 | مركز ثقافي / بحثي |
76
- | `arts-school` | 15 | مدرسة الفنون الفنون الجميلة / معهد |
76
+ | `arts-school` | 15 | مدرسة الفنون الفنون الجميلة / معهد |
77
77
  | `cultural-palace` | 6 | قصر الثقافة |
78
78
 
79
79
  > **الأطلس رسمي؛ أما الإحداثيات فأفضل ما أمكن.** الأسماء والنوع والإحداثيات وعلامة
@@ -90,7 +90,7 @@ import culture from "@geoalgeria/culture/data/culture.json" with { type: "json"
90
90
  // https://cdn.jsdelivr.net/npm/@geoalgeria/culture/data/culture.json
91
91
  ```
92
92
 
93
- المُحمِّلات وبنية السجلات **مُوثَّقة الأنواع** بالكامل تعريفات TypeScript مرفقة في الحزمة:
93
+ المُحمِّلات وبنية السجلات **مُوثَّقة الأنواع** بالكامل تعريفات TypeScript مرفقة في الحزمة:
94
94
 
95
95
  ```ts
96
96
  import culture, { type CulturalSite } from "@geoalgeria/culture";
@@ -137,11 +137,11 @@ data/
137
137
  }
138
138
  ```
139
139
 
140
- `id` مفتاح ثابت `{wilaya_code}-{type_code}-{seq}`، فريد ضمن هذا الملف يُعامَل
140
+ `id` مفتاح ثابت `{wilaya_code}-{type_code}-{seq}`، فريد ضمن هذا الملف يُعامَل
141
141
  كمعرّف معتم (opaque). `name` هو الاسم الفرنسي إن وُجد، وإلا العربي. `type` هو
142
142
  طبقة الموقع على البوابة، و`category` يجمع الأنواع الـ11 في `heritage` مقابل
143
143
  `establishment`. `has_virtual_tour` يساوي `true` للمواقع الـ22 ذات الجولة 360°.
144
- `geo_precision` يساوي `"exact"` لـ1067 سجلًا و`"approximate"` لـ16 لكل موقع
144
+ `geo_precision` يساوي `"exact"` لـ1067 سجلًا و`"approximate"` لـ16 لكل موقع
145
145
  إحداثية، لكن 16 منها لا تبلغ عتبة الدقة اللازمة لـ`"exact"`. `geo_method`
146
146
  يساوي `"source_point"` لكل سجل: الإحداثية هي النقطة التي تنشرها البوابة نفسها،
147
147
  وليست مركز ثقل مُشتقًا. `refs.patrimoine` هو معرّف الموقع على البوابة.
@@ -156,7 +156,7 @@ data/
156
156
  ## تحتاج التقسيمات الإدارية أيضًا؟
157
157
 
158
158
  للولايات والدوائر والبلديات، استخدم الحزمة الرئيسية
159
- **[`geoalgeria`](https://www.npmjs.com/package/geoalgeria)** بها تحوّل
159
+ **[`geoalgeria`](https://www.npmjs.com/package/geoalgeria)** بها تحوّل
160
160
  `commune_code` لموقعٍ ما إلى مضلّع أو مركز ثقل. استخدم `@geoalgeria/culture` عندما
161
161
  تحتاج المواقع الثقافية *فقط*.
162
162
 
@@ -165,7 +165,7 @@ data/
165
165
  شغّل `npm run fetch` لإعادة توليد المخرجات. يقوم السكربت بـ:
166
166
 
167
167
  1. قراءة الأطلس الثقافي ثنائي اللغة المُنسَّق (المُجمَّع والمُترجَم من بوابة
168
- `cartes.patrimoineculturelalgerien.org` التابعة لوزارة الثقافة كتالوجا
168
+ `cartes.patrimoineculturelalgerien.org` التابعة لوزارة الثقافة كتالوجا
169
169
  البوابة الفرنسي والعربي مجموعتا عُقَد منفصلتان، تُوحَّدان بتقارب الإحداثيات
170
170
  وتُترجَمان لسدّ الفجوات الثنائية)؛
171
171
  2. **إعادة إسناد** كل موقع إلى التقسيم الحالي البالغ 69 ولاية وربط
package/README.fr.md CHANGED
@@ -4,7 +4,7 @@
4
4
 
5
5
  # @geoalgeria/culture
6
6
 
7
- **L'atlas culturel de l'Algérie sous forme de données prêtes à installer.**
7
+ **L'atlas culturel de l'Algérie, sous forme de données prêtes à installer.**
8
8
 
9
9
  [![npm](https://img.shields.io/npm/v/@geoalgeria/culture)](https://www.npmjs.com/package/@geoalgeria/culture)
10
10
  [![npm downloads](https://img.shields.io/npm/dm/@geoalgeria/culture)](https://www.npmjs.com/package/@geoalgeria/culture)
@@ -12,7 +12,7 @@
12
12
 
13
13
  </div>
14
14
 
15
- **1 083 lieux culturels** dans **66 des 69 wilayas d'Algérie** biens culturels
15
+ **1 083 lieux culturels** dans **66 des 69 wilayas d'Algérie** biens culturels
16
16
  protégés, musées, théâtres, bibliothèques et établissements culturels (maisons et
17
17
  palais de la culture, salles de cinéma, directions de la culture, écoles d'art) de
18
18
  l'atlas *Cartes du Patrimoine Culturel Algérien* du **Ministère de la Culture**,
@@ -41,11 +41,11 @@ const visites = all.filter((p) => p.has_virtual_tour);
41
41
 
42
42
  ## Ce que vous pouvez construire
43
43
 
44
- - **Cartes culturelles & recherche de proximité** chacun des 1 083 lieux a des
44
+ - **Cartes culturelles & recherche de proximité** chacun des 1 083 lieux a des
45
45
  coordonnées, prêtes pour une carte ou une fonction « à proximité ».
46
- - **Annuaires culturels bilingues** noms français et arabe, type officiel et
46
+ - **Annuaires culturels bilingues** noms français et arabe, type officiel et
47
47
  wilaya pour chaque lieu ; filtrer patrimoine vs établissements en activité.
48
- - **Applications patrimoine & tourisme** sites protégés, musées et visites
48
+ - **Applications patrimoine & tourisme** sites protégés, musées et visites
49
49
  virtuelles à 360°, rattachés à la commune/wilaya pour l'itinéraire et l'analyse.
50
50
 
51
51
  ## Contenu
@@ -65,7 +65,7 @@ const visites = all.filter((p) => p.has_virtual_tour);
65
65
 
66
66
  | Type | Nombre | Signification |
67
67
  | --- | --- | --- |
68
- | `protected-cultural-property` | 580 | Bien culturel protégé monument/site protégé |
68
+ | `protected-cultural-property` | 580 | Bien culturel protégé monument/site protégé |
69
69
  | `library` | 257 | Bibliothèque de lecture publique |
70
70
  | `museum` | 48 | Musée |
71
71
  | `theatre` | 45 | Théâtre |
@@ -74,7 +74,7 @@ const visites = all.filter((p) => p.has_virtual_tour);
74
74
  | `cultural-directorate` | 33 | Direction de la culture / office |
75
75
  | `cinema` | 20 | Salle de cinéma / cinémathèque |
76
76
  | `cultural-center` | 15 | Centre culturel / de recherche |
77
- | `arts-school` | 15 | École d'art beaux-arts / conservatoire |
77
+ | `arts-school` | 15 | École d'art beaux-arts / conservatoire |
78
78
  | `cultural-palace` | 6 | Palais de la culture |
79
79
 
80
80
  > **L'atlas est officiel ; les coordonnées sont au mieux.** Les noms, le type, les
@@ -92,7 +92,7 @@ import culture from "@geoalgeria/culture/data/culture.json" with { type: "json"
92
92
  // https://cdn.jsdelivr.net/npm/@geoalgeria/culture/data/culture.json
93
93
  ```
94
94
 
95
- Les chargeurs et les enregistrements sont entièrement **typés** les définitions TypeScript sont incluses :
95
+ Les chargeurs et les enregistrements sont entièrement **typés** les définitions TypeScript sont incluses :
96
96
 
97
97
  ```ts
98
98
  import culture, { type CulturalSite } from "@geoalgeria/culture";
@@ -140,11 +140,11 @@ data/
140
140
  ```
141
141
 
142
142
  `id` est une clé stable `{wilaya_code}-{type_code}-{seq}`, unique au sein de ce
143
- fichier à traiter comme opaque. `name` est le nom français s'il existe, sinon
143
+ fichier à traiter comme opaque. `name` est le nom français s'il existe, sinon
144
144
  l'arabe. `type` est la couche du lieu sur le portail ; `category` regroupe les
145
145
  11 types en `heritage` vs `establishment`. `has_virtual_tour` vaut `true` pour
146
146
  les 22 lieux dotés d'une visite 360°. `geo_precision` vaut `"exact"` pour
147
- 1 067 enregistrements et `"approximate"` pour 16 chaque lieu a une
147
+ 1 067 enregistrements et `"approximate"` pour 16 chaque lieu a une
148
148
  coordonnée, mais 16 n'atteignent pas le seuil de précision de `"exact"`.
149
149
  `geo_method` vaut `"source_point"` pour chaque enregistrement : la coordonnée
150
150
  est le point publié par le portail lui-même, pas un centroïde dérivé.
@@ -160,7 +160,7 @@ est le point publié par le portail lui-même, pas un centroïde dérivé.
160
160
  ## Besoin des divisions administratives ?
161
161
 
162
162
  Pour les wilayas, dairas et communes, utilisez le paquet principal
163
- **[`geoalgeria`](https://www.npmjs.com/package/geoalgeria)** c'est ce qui
163
+ **[`geoalgeria`](https://www.npmjs.com/package/geoalgeria)** c'est ce qui
164
164
  transforme le `commune_code` d'un lieu en polygone ou centroïde. Utilisez
165
165
  `@geoalgeria/culture` quand vous n'avez besoin *que* des lieux culturels.
166
166
 
@@ -169,7 +169,7 @@ transforme le `commune_code` d'un lieu en polygone ou centroïde. Utilisez
169
169
  Lancez `npm run fetch` pour régénérer les sorties. Le script :
170
170
 
171
171
  1. lit l'atlas culturel bilingue curé (assemblé et traduit depuis le portail
172
- `cartes.patrimoineculturelalgerien.org` du Ministère de la Culture les
172
+ `cartes.patrimoineculturelalgerien.org` du Ministère de la Culture les
173
173
  catalogues français et arabe du portail sont des ensembles de nœuds disjoints,
174
174
  unis par proximité de coordonnées et traduits pour combler les manques
175
175
  bilingues) ;
package/README.md CHANGED
@@ -4,7 +4,7 @@
4
4
 
5
5
  # @geoalgeria/culture
6
6
 
7
- **Algeria's cultural atlas as data you can install.**
7
+ **Algeria's cultural atlas, as data you can install.**
8
8
 
9
9
  [![npm](https://img.shields.io/npm/v/@geoalgeria/culture)](https://www.npmjs.com/package/@geoalgeria/culture)
10
10
  [![npm downloads](https://img.shields.io/npm/dm/@geoalgeria/culture)](https://www.npmjs.com/package/@geoalgeria/culture)
@@ -12,7 +12,7 @@
12
12
 
13
13
  </div>
14
14
 
15
- **1,083 cultural places** across **66 of Algeria's 69 wilayas** protected
15
+ **1,083 cultural places** across **66 of Algeria's 69 wilayas**, protected
16
16
  heritage sites, museums, theatres, libraries and cultural establishments (maisons
17
17
  & palais de la culture, cinemas, culture directorates, arts schools) from the
18
18
  **Ministry of Culture's** *Cartes du Patrimoine Culturel Algérien* atlas,
@@ -41,11 +41,11 @@ const tours = all.filter((p) => p.has_virtual_tour);
41
41
 
42
42
  ## What you can build
43
43
 
44
- - **Cultural maps & nearest-place search** every one of the 1,083 places has
44
+ - **Cultural maps & nearest-place search** every one of the 1,083 places has
45
45
  coordinates, ready for a map or a "what's near me" feature.
46
- - **Bilingual cultural directories** French and Arabic names, official type and
46
+ - **Bilingual cultural directories** French and Arabic names, official type and
47
47
  wilaya for every place; filter heritage vs. operating establishments.
48
- - **Heritage & tourism apps** protected sites, museums and 360° virtual tours,
48
+ - **Heritage & tourism apps** protected sites, museums and 360° virtual tours,
49
49
  linked to commune/wilaya for routing and coverage analysis.
50
50
 
51
51
  ## What's inside
@@ -65,16 +65,16 @@ const tours = all.filter((p) => p.has_virtual_tour);
65
65
 
66
66
  | Type | Count | Meaning |
67
67
  | --- | --- | --- |
68
- | `protected-cultural-property` | 580 | Bien culturel protégé protected monument/site |
69
- | `library` | 257 | Bibliothèque public reading library |
70
- | `museum` | 48 | Musée museum |
71
- | `theatre` | 45 | Théâtre theatre |
72
- | `museum-moudjahid` | 13 | Musée du Moudjahid museum of the war of independence |
68
+ | `protected-cultural-property` | 580 | Bien culturel protégé protected monument/site |
69
+ | `library` | 257 | Bibliothèque public reading library |
70
+ | `museum` | 48 | Musée museum |
71
+ | `theatre` | 45 | Théâtre theatre |
72
+ | `museum-moudjahid` | 13 | Musée du Moudjahid museum of the war of independence |
73
73
  | `cultural-house` | 51 | Maison de la culture |
74
- | `cultural-directorate` | 33 | Direction de la culture wilaya culture directorate/office |
75
- | `cinema` | 20 | Salle de cinéma cinema / cinematheque |
76
- | `cultural-center` | 15 | Centre culturel cultural / research centre |
77
- | `arts-school` | 15 | École d'art fine-arts school / conservatory |
74
+ | `cultural-directorate` | 33 | Direction de la culture wilaya culture directorate/office |
75
+ | `cinema` | 20 | Salle de cinéma cinema / cinematheque |
76
+ | `cultural-center` | 15 | Centre culturel cultural / research centre |
77
+ | `arts-school` | 15 | École d'art fine-arts school / conservatory |
78
78
  | `cultural-palace` | 6 | Palais de la culture |
79
79
 
80
80
  > **The atlas is official; treat the coordinates as best-effort.** Names, type,
@@ -92,7 +92,7 @@ import culture from "@geoalgeria/culture/data/culture.json" with { type: "json"
92
92
  // https://cdn.jsdelivr.net/npm/@geoalgeria/culture/data/culture.json
93
93
  ```
94
94
 
95
- The loaders and record shapes are fully **typed** TypeScript definitions ship in the package:
95
+ The loaders and record shapes are fully **typed**, TypeScript definitions ship in the package:
96
96
 
97
97
  ```ts
98
98
  import culture, { type CulturalSite } from "@geoalgeria/culture";
@@ -140,11 +140,11 @@ data/
140
140
  ```
141
141
 
142
142
  `id` is a stable `{wilaya_code}-{type_code}-{seq}` key, unique within this
143
- file treat it as opaque. `name` is the French name where available, else
143
+ file, treat it as opaque. `name` is the French name where available, else
144
144
  Arabic. `type` is the place's layer on the portal; `category` groups the 11
145
145
  types into `heritage` vs. `establishment`. `has_virtual_tour` is true for the
146
146
  22 places with a 360° tour. `geo_precision` is `"exact"` for 1,067 records and
147
- `"approximate"` for 16 every place has a coordinate, but 16 don't meet the
147
+ `"approximate"` for 16, every place has a coordinate, but 16 don't meet the
148
148
  precision bar for `"exact"`. `geo_method` is `"source_point"` for every
149
149
  record: the coordinate is the portal's own published point, not a derived
150
150
  centroid. `refs.patrimoine` is the place's node id on the portal.
@@ -159,7 +159,7 @@ centroid. `refs.patrimoine` is the place's node id on the portal.
159
159
  ## Need the administrative divisions too?
160
160
 
161
161
  For wilayas, dairas, and communes, use the main
162
- **[`geoalgeria`](https://www.npmjs.com/package/geoalgeria)** package it's how
162
+ **[`geoalgeria`](https://www.npmjs.com/package/geoalgeria)** package, it's how
163
163
  you turn a place's `commune_code` into a polygon or centroid. Use
164
164
  `@geoalgeria/culture` when you *only* need the cultural places.
165
165
 
@@ -168,7 +168,7 @@ you turn a place's `commune_code` into a polygon or centroid. Use
168
168
  Run `npm run fetch` to regenerate every output. It:
169
169
 
170
170
  1. reads the curated, bilingual cultural atlas (assembled and translated from the
171
- Ministry of Culture's `cartes.patrimoineculturelalgerien.org` portal the
171
+ Ministry of Culture's `cartes.patrimoineculturelalgerien.org` portal, the
172
172
  portal's French and Arabic catalogs are disjoint node sets, unioned by
173
173
  coordinate proximity and translated to fill the bilingual gaps);
174
174
  2. **rescopes** each place to the current 69-wilaya scheme and attaches a