@geoalgeria/culture 1.0.0

package/data/metadata.json

@@ -0,0 +1,33 @@
+{
+  "source": "Cartes du Patrimoine Culturel Algérien (cartes.patrimoineculturelalgerien.org) — the Ministry of Culture's cultural atlas",
+  "origin": "https://cartes.patrimoineculturelalgerien.org",
+  "license": "Factual public cultural listing from the Ministry of Culture (names, types, coordinates as published by the portal). Commune linkage derived from the GeoAlgeria commune set. See README for attribution.",
+  "culture": 1083,
+  "by_type": {
+    "protected-cultural-property": 580,
+    "museum": 48,
+    "museum-moudjahid": 13,
+    "theatre": 45,
+    "library": 257,
+    "cultural-house": 51,
+    "cultural-palace": 6,
+    "cultural-center": 15,
+    "cultural-directorate": 33,
+    "cinema": 20,
+    "arts-school": 15
+  },
+  "by_category": {
+    "heritage": 943,
+    "establishment": 140
+  },
+  "by_geo_precision": {
+    "source_point": 1083
+  },
+  "wilayas_covered": 66,
+  "geocoded": 1083,
+  "bilingual": 1083,
+  "virtual_tours": 22,
+  "linkage_note": "Names, type, coordinates and virtual-tour flag are from the Patrimoine Culturel portal (the portal's FR and AR catalogs are disjoint node sets, unioned by coordinate proximity and translated to fill bilingual gaps). Wilaya is exact (from the portal); commune is the nearest GeoAlgeria commune centroid (the repo ships centroids, not boundary polygons), so commune is best-effort.",
+  "coverage_note": "1083 cultural places from Algeria's official cultural atlas (Ministry of Culture) — protected heritage sites, museums, theatres, libraries, and cultural establishments (maisons & palais de culture, cinemas, culture directorates, arts schools). Every place carries a source coordinate; wilaya is exact, commune is best-effort. 22 offer a 360° virtual tour.",
+  "generated_at": "2026-06-29"
+}

package/index.js

@@ -0,0 +1,12 @@
+// @geoalgeria/culture — lightweight loaders for Algeria's cultural atlas.
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
+
+const DATA = join(dirname(fileURLToPath(import.meta.url)), "data");
+const load = (p) => JSON.parse(readFileSync(join(DATA, p), "utf-8"));
+
+export const culture = () => load("culture.json"); // cultural places (Patrimoine Culturel atlas, geocoded)
+export const metadata = () => load("metadata.json");
+
+export default { culture, metadata };

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@geoalgeria/culture",
+  "version": "1.0.0",
+  "type": "module",
+  "description": "Algeria's cultural atlas — protected heritage sites, museums, theatres, libraries and cultural establishments (maisons & palais de culture, cinemas, culture directorates, arts schools) from the Ministry of Culture's Patrimoine Culturel portal, bilingual FR/AR, fully geocoded, with commune/wilaya linkage. JSON, CSV, GeoJSON, TypeScript.",
+  "main": "index.js",
+  "types": "types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./types/index.d.ts",
+      "default": "./index.js"
+    },
+    "./data/*": "./data/*"
+  },
+  "files": [
+    "data/**/*.json",
+    "data/**/*.csv",
+    "data/**/*.geojson",
+    "types/",
+    "index.js"
+  ],
+  "scripts": {
+    "fetch": "node scripts/fetch.mjs",
+    "test": "node ../../scripts/validate-packages.mjs culture"
+  },
+  "keywords": [
+    "algeria",
+    "culture",
+    "patrimoine",
+    "heritage",
+    "monument",
+    "museum",
+    "musee",
+    "theatre",
+    "library",
+    "cinema",
+    "unesco",
+    "ministry-of-culture",
+    "geojson",
+    "geoalgeria",
+    "dz"
+  ],
+  "author": "Yasser's Studio (https://yasser.studio)",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "bugs": {
+    "url": "https://github.com/yasserstudio/geoalgeria/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/yasserstudio/geoalgeria.git",
+    "directory": "packages/culture"
+  },
+  "homepage": "https://geoalgeria.com",
+  "engines": {
+    "node": ">=18"
+  }
+}

package/types/index.d.ts

@@ -0,0 +1,110 @@
+// Type definitions for @geoalgeria/culture
+// Algeria's cultural atlas — the Ministry of Culture's "Cartes du Patrimoine
+// Culturel Algérien" portal (cartes.patrimoineculturelalgerien.org), bilingual
+// FR/AR, with coordinates as published by the portal.
+
+/**
+ * Kind of cultural place. The first five are the portal's heritage/institution
+ * layers; the last six are cultural establishments from the combined map.
+ */
+export type CulturalType =
+  // heritage & institutions
+  | "protected-cultural-property"
+  | "museum"
+  | "museum-moudjahid"
+  | "theatre"
+  | "library"
+  // cultural establishments / venues
+  | "cultural-house"
+  | "cultural-palace"
+  | "cultural-center"
+  | "cultural-directorate"
+  | "cinema"
+  | "arts-school";
+
+/** Coarse grouping: protected sites + museums + theatres + libraries vs. operating establishments. */
+export type CulturalCategory = "heritage" | "establishment";
+
+/** Provenance of the record. */
+export type CultureSource = "patrimoineculturel";
+
+/** How the coordinates were obtained. The portal publishes a point for every place. */
+export type GeoPrecision = "source_point";
+
+/** A cultural place. */
+export interface CulturalSite {
+  /** Stable id, `{wilaya_code}-{type_code}-{seq}` (e.g. "16-museum-01"). */
+  id: string;
+  /** Best available display name (French preferred, else Arabic). */
+  name: string;
+  /** Arabic name, or null. */
+  name_ar: string | null;
+  /** French name, or null. */
+  name_fr: string | null;
+  /** Kind of cultural place. */
+  type: CulturalType;
+  /** Coarse grouping (`heritage` for the 5 institution layers, `establishment` for the 6 venue layers). */
+  category: CulturalCategory;
+  /** Canonical French label for the type. */
+  type_label_fr: string;
+  /** Canonical Arabic label for the type. */
+  type_label_ar: string;
+  /** True when the portal offers a 360° virtual tour of the place. */
+  has_virtual_tour: boolean;
+  /** Wilaya name (French). */
+  wilaya: string;
+  /** Wilaya name (Arabic). */
+  wilaya_ar: string;
+  /** Wilaya code as a zero-padded string ("01".."69", current Law 26-06 scheme). */
+  wilaya_code: string;
+  /** Commune name (French), nearest-centroid best-effort. Null when unresolved. */
+  commune: string | null;
+  /** Commune code (geoalgeria code_commune), best-effort. Null when unresolved. */
+  commune_code: number | null;
+  /** Provenance (the Patrimoine Culturel portal). */
+  source: CultureSource;
+  /** How `lat`/`lng` were obtained (always the portal's published point). */
+  geo_precision: GeoPrecision;
+  /** Deep link to the place's record on the portal, or null. */
+  url: string | null;
+  /** Node id of the French record on the portal, or null. */
+  node_id_fr: number | null;
+  /** Node id of the Arabic record on the portal, or null. */
+  node_id_ar: number | null;
+  /** URL slug of the place name. */
+  slug: string;
+  /** Latitude (always present — every place carries a source point). */
+  lat: number;
+  /** Longitude (always present). */
+  lng: number;
+}
+
+/** Dataset metadata (data/metadata.json). */
+export interface Metadata {
+  source: string;
+  origin: string;
+  license: string;
+  culture: number;
+  by_type: Record<CulturalType, number>;
+  by_category: Record<CulturalCategory, number>;
+  by_geo_precision: Record<GeoPrecision, number>;
+  wilayas_covered: number;
+  geocoded: number;
+  bilingual: number;
+  virtual_tours: number;
+  linkage_note: string;
+  coverage_note: string;
+  /** ISO date (YYYY-MM-DD) the snapshot was generated. */
+  generated_at: string;
+}
+
+/** All cultural places. */
+export function culture(): CulturalSite[];
+/** Dataset metadata. */
+export function metadata(): Metadata;
+
+declare const _default: {
+  culture: typeof culture;
+  metadata: typeof metadata;
+};
+export default _default;