@geoalgeria/ecoles 1.0.0

package/data/metadata.json

@@ -0,0 +1,37 @@
+{
+  "source": "OpenStreetMap (ODbL) — schools (amenity=school) and kindergartens (amenity=kindergarten) in Algeria",
+  "origin": "https://www.openstreetmap.org",
+  "license": "OpenStreetMap data is © OpenStreetMap contributors, ODbL 1.0. See README for attribution.",
+  "ecoles": 11830,
+  "named": 8640,
+  "by_cycle": {
+    "primaire": 4020,
+    "moyen": 2377,
+    "secondaire": 1574,
+    "prescolaire": 268,
+    "autre": 3591
+  },
+  "by_kind": {
+    "regular": 11640,
+    "langues": 24,
+    "coranique": 40,
+    "conduite": 5,
+    "formation": 91,
+    "special": 30
+  },
+  "by_sector": {
+    "public": 313,
+    "private": 48,
+    "unknown": 11469
+  },
+  "with_address": 2625,
+  "with_isced": 2037,
+  "wilayas_covered": 69,
+  "ecoles_geocoded": 11830,
+  "official_total": 28000,
+  "coverage_note": "11830 schools compiled from OpenStreetMap, against the ~28000 establishments in Algeria's national school network (primaire + moyen + secondaire, Ministry of National Education, approximate). A community-maintained extract, not an official registry — coverage is partial and uneven by wilaya.",
+  "cycle_note": "Cycle is inferred from isced:level and the French/Arabic name (CEM→moyen, lycée→secondaire, maternelle/روضة→préscolaire); a bare \"école\"/\"مدرسة\" with no cycle word is classified primaire per Algerian convention, and anything unresolved is \"autre\".",
+  "kind_note": "Kind is the establishment type, orthogonal to cycle: most are \"regular\"; \"langues\"/\"coranique\"/\"conduite\"/\"formation\" are special-purpose places OSM files under amenity=school but that sit outside the K-12 ladder (they carry cycle \"autre\"); \"special\" are adapted/special-needs schools (which keep a cycle).",
+  "linkage_note": "Commune/wilaya linkage is derived by nearest-centroid join against the geoalgeria commune set; wilaya is effectively exact, commune is best-effort.",
+  "generated_at": "2026-07-03"
+}

package/index.js

@@ -0,0 +1,12 @@
+// @geoalgeria/ecoles — lightweight loaders for Algeria's schools (OpenStreetMap).
+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 ecoles = () => load("ecoles.json"); // 11k+ geocoded schools & kindergartens (OSM), classified by cycle
+export const metadata = () => load("metadata.json");
+
+export default { ecoles, metadata };

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@geoalgeria/ecoles",
+  "version": "1.0.0",
+  "type": "module",
+  "description": "Schools of Algeria — 11,000+ geocoded schools and kindergartens from OpenStreetMap, classified by cycle (primaire/moyen/secondaire/préscolaire), with Arabic & French names, commune/wilaya linkage and GPS coordinates. 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 ecoles"
+  },
+  "keywords": [
+    "algeria",
+    "schools",
+    "ecoles",
+    "education",
+    "primaire",
+    "cem",
+    "lycee",
+    "openstreetmap",
+    "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/ecoles"
+  },
+  "homepage": "https://geoalgeria.com",
+  "engines": {
+    "node": ">=18"
+  }
+}

package/types/index.d.ts

@@ -0,0 +1,115 @@
+// Type definitions for @geoalgeria/ecoles
+// Schools of Algeria, extracted from OpenStreetMap (ODbL) and classified by cycle.
+
+/** Where a record came from. OSM is the sole source (Wikidata is school-poor). */
+export type EcoleSource = "osm";
+
+/** Education cycle in the Algerian system. */
+export type EcoleCycle =
+  | "primaire" // école primaire (ISCED 1)
+  | "moyen" // collège d'enseignement moyen / CEM (ISCED 2)
+  | "secondaire" // lycée (ISCED 3)
+  | "prescolaire" // préscolaire / maternelle / روضة (ISCED 0)
+  | "autre"; // school of undetermined cycle
+
+/** Establishment kind — what the "école" is, orthogonal to its cycle. */
+export type EcoleKind =
+  | "regular" // a standard école / CEM / lycée / maternelle
+  | "langues" // language school / institute (cycle "autre")
+  | "coranique" // Quranic school (cycle "autre")
+  | "conduite" // driving school / auto-école (cycle "autre")
+  | "formation" // vocational / training centre (cycle "autre")
+  | "special"; // adapted / special-needs school (keeps a cycle)
+
+/** Ownership sector, only when an explicit signal is present. */
+export type EcoleSector = "public" | "private";
+
+/** How the coordinates were obtained. */
+export type GeoPrecision = "osm_node" | "osm_centroid";
+
+/** A geocoded school or kindergarten. */
+export interface Ecole {
+  /** Stable id, `{wilaya_code}-{seq}` (e.g. "16-00042"). */
+  id: string;
+  /** Provenance — always "osm". */
+  source: EcoleSource;
+  /** OSM element id (e.g. "way/292876445"). */
+  osm_id: string;
+  /** Best available display name (raw name preferred, else FR/AR), or null if unnamed. */
+  name: string | null;
+  /** Arabic name, or null. */
+  name_ar: string | null;
+  /** French / Latin-script name, or null. */
+  name_fr: string | null;
+  /** Education cycle, inferred from isced:level + the FR/AR name. */
+  cycle: EcoleCycle;
+  /** Canonical French label for the cycle. */
+  cycle_label_fr: string;
+  /** Canonical Arabic label for the cycle. */
+  cycle_label_ar: string;
+  /** Establishment kind (mostly "regular"; special-purpose kinds carry cycle "autre"). */
+  kind: EcoleKind;
+  /** Canonical French label for the kind. */
+  kind_label_fr: string;
+  /** Canonical Arabic label for the kind. */
+  kind_label_ar: string;
+  /** ISCED levels served, sorted ";"-joined ("0;1", "2", "1;2;3"), from OSM isced:level; null if absent. */
+  isced_levels: string | null;
+  /** Ownership sector when asserted (operator:type or a privé/خاص name), else null. */
+  sector: EcoleSector | null;
+  /** Wilaya name (French), nearest-centroid join. */
+  wilaya: string;
+  /** Wilaya name (Arabic). */
+  wilaya_ar: string;
+  /** Wilaya code as a zero-padded string ("01".."69"). */
+  wilaya_code: string;
+  /** Commune name (French), nearest-centroid best-effort. */
+  commune: string;
+  /** Commune code (geoalgeria code_commune), nearest-centroid best-effort. */
+  commune_code: number | null;
+  /** Single-line address from OSM addr:* tags, or null when none are present. */
+  address: string | null;
+  /** Latitude. */
+  lat: number;
+  /** Longitude. */
+  lng: number;
+  /** How `lat`/`lng` were obtained (surveyed node vs building centroid). */
+  geo_precision: GeoPrecision;
+}
+
+/** Dataset metadata (data/metadata.json). */
+export interface Metadata {
+  source: string;
+  origin: string;
+  license: string;
+  ecoles: number;
+  named: number;
+  by_cycle: Record<EcoleCycle, number>;
+  by_kind: Record<EcoleKind, number>;
+  by_sector: { public: number; private: number; unknown: number };
+  /** Records carrying an `address`. */
+  with_address: number;
+  /** Records carrying `isced_levels`. */
+  with_isced: number;
+  wilayas_covered: number;
+  ecoles_geocoded: number;
+  /** Approximate national school-network size, for honest coverage framing. */
+  official_total: number;
+  coverage_note: string;
+  cycle_note: string;
+  kind_note: string;
+  linkage_note: string;
+  /** ISO date (YYYY-MM-DD) the snapshot was generated. */
+  generated_at: string;
+}
+
+/** All schools and kindergartens. */
+export function ecoles(): Ecole[];
+/** Dataset metadata. */
+export function metadata(): Metadata;
+
+declare const _default: {
+  ecoles: typeof ecoles;
+  metadata: typeof metadata;
+};
+export default _default;