@geogdev/styles 0.1.0

package/src/language.ts

@@ -0,0 +1,320 @@
+import languagesConfig from "./config/languages.json";
+
+// Type definition for language entries
+interface LanguageScriptPair {
+  lang: string;
+  full_name: string;
+  script: string;
+}
+
+// Export the language/script pairs from JSON config
+export const LANGUAGE_SCRIPT_PAIRS: LanguageScriptPair[] = languagesConfig;
+
+function get_name_block(
+  script_segment: "name" | "name2" | "name3",
+  regular?: string,
+) {
+  let script = "script";
+
+  if (script_segment === "name") {
+    script = "script";
+  } else if (script_segment === "name2") {
+    script = "script2";
+  } else if (script_segment === "name3") {
+    script = "script3";
+  }
+
+  return [
+    ["coalesce", ["get", `pgf:${script_segment}`], ["get", script_segment]],
+    {
+      "text-font": [
+        "case",
+        ["==", ["get", script], "Devanagari"],
+        ["literal", ["Noto Sans Devanagari Regular v1"]],
+        ["literal", [regular || "Noto Sans Regular"]],
+      ],
+    },
+  ];
+}
+
+function is_not_in_target_script(
+  lang: string,
+  script: string,
+  script_segment: "name" | "name2" | "name3",
+) {
+  let suffix = "name";
+  if (script_segment === "name") {
+    suffix = "";
+  } else if (script_segment === "name2") {
+    suffix = "2";
+  } else if (script_segment === "name3") {
+    suffix = "3";
+  }
+
+  if (script === "Latin") {
+    return ["has", `script${suffix}`];
+  }
+
+  if (lang === "ja") {
+    return [
+      "all",
+      ["!=", ["get", `script${suffix}`], "Han"],
+      ["!=", ["get", `script${suffix}`], "Hiragana"],
+      ["!=", ["get", `script${suffix}`], "Katakana"],
+      ["!=", ["get", `script${suffix}`], "Mixed-Japanese"],
+    ];
+  }
+
+  return ["!=", ["get", `script${suffix}`], script];
+}
+
+function get_font_formatting(script: string) {
+  if (script === "Devanagari") {
+    return {
+      "text-font": ["literal", ["Noto Sans Devanagari Regular v1"]],
+    };
+  }
+  return {};
+}
+
+function getDefaultScript(lang: string) {
+  const pair = LANGUAGE_SCRIPT_PAIRS.find((d) => d.lang === lang);
+  return pair === undefined ? "Latin" : pair.script;
+}
+
+export function getCountryName(lang: string, script?: string) {
+  const _script = script || getDefaultScript(lang);
+  let name_prefix: string;
+  if (_script === "Devanagari") {
+    name_prefix = "pgf:";
+  } else {
+    name_prefix = "";
+  }
+  return [
+    "format",
+    ["coalesce", ["get", `${name_prefix}name:${lang}`], ["get", "name:en"]],
+    get_font_formatting(_script),
+  ];
+}
+
+export function getMultilineName(
+  lang: string,
+  script?: string,
+  regular?: string,
+) {
+  const _script = script || getDefaultScript(lang);
+  let name_prefix: string;
+  if (_script === "Devanagari") {
+    name_prefix = "pgf:";
+  } else {
+    name_prefix = "";
+  }
+
+  const result = [
+    "case",
+    [
+      "all",
+      ["any", ["has", "name"], ["has", "pgf:name"]],
+      ["!", ["any", ["has", "name2"], ["has", "pgf:name2"]]],
+      ["!", ["any", ["has", "name3"], ["has", "pgf:name3"]]],
+    ],
+    // The local name has 1 script segment: `name`
+    [
+      "case",
+      is_not_in_target_script(lang, _script, "name"),
+      // `name` is not in the target script
+      [
+        "case",
+        ["any", ["is-supported-script", ["get", "name"]], ["has", "pgf:name"]],
+        // `name` can be rendered correctly
+        [
+          "format",
+          [
+            "coalesce",
+            ["get", `${name_prefix}name:${lang}`],
+            ["get", "name:en"], // Always fallback to English
+          ],
+          get_font_formatting(_script),
+          "\n",
+          {},
+          [
+            "case",
+            [
+              "all",
+              ["!", ["has", `${name_prefix}name:${lang}`]],
+              ["has", "name:en"],
+              ["!", ["has", "script"]],
+            ],
+            // We did fallback to English in the first line and `name` is Latin
+            "",
+            ["coalesce", ["get", "pgf:name"], ["get", "name"]],
+          ],
+          {
+            "text-font": [
+              "case",
+              ["==", ["get", "script"], "Devanagari"],
+              ["literal", ["Noto Sans Devanagari Regular v1"]],
+              ["literal", [regular || "Noto Sans Regular"]],
+            ],
+          },
+        ],
+        // `name` cannot be rendered correctly, fallback to `name:en`
+        ["get", "name:en"],
+      ],
+      // `name` is in the target script
+      [
+        "format",
+        [
+          "coalesce",
+          ["get", `${name_prefix}name:${lang}`],
+          ["get", "pgf:name"],
+          ["get", "name"],
+        ],
+        get_font_formatting(_script),
+      ],
+    ],
+    [
+      "all",
+      ["any", ["has", "name"], ["has", "pgf:name"]],
+      ["any", ["has", "name2"], ["has", "pgf:name2"]],
+      ["!", ["any", ["has", "name3"], ["has", "pgf:name3"]]],
+    ],
+    // The local name has 2 script segments: `name` and `name2`
+    [
+      "case",
+      [
+        "all",
+        is_not_in_target_script(lang, _script, "name"),
+        is_not_in_target_script(lang, _script, "name2"),
+      ],
+      // Both `name` and `name2` are not in the target script
+      [
+        "format",
+        ["get", `${name_prefix}name:${lang}`],
+        get_font_formatting(_script),
+        "\n",
+        {},
+        ...get_name_block("name", regular),
+        "\n",
+        {},
+        ...get_name_block("name2", regular),
+      ],
+      // Either `name` or `name2` is in the target script
+      [
+        "case",
+        is_not_in_target_script(lang, _script, "name2"),
+        // `name2` is not in the target script, therefore `name` is in the target script
+        [
+          "format",
+          [
+            "coalesce",
+            ["get", `${name_prefix}name:${lang}`],
+            ["get", "pgf:name"],
+            ["get", "name"],
+          ],
+          get_font_formatting(_script),
+          "\n",
+          {},
+          ...get_name_block("name2", regular),
+        ],
+        // `name2` is in the target script, therefore `name` is not in the target script
+        [
+          "format",
+          [
+            "coalesce",
+            ["get", `${name_prefix}name:${lang}`],
+            ["get", "pgf:name2"],
+            ["get", "name2"],
+          ],
+          get_font_formatting(_script),
+          "\n",
+          {},
+          ...get_name_block("name", regular),
+        ],
+      ],
+    ],
+    // The local name has 3 script segments: `name`, `name2`, and `name3`
+    [
+      "case",
+      [
+        "all",
+        is_not_in_target_script(lang, _script, "name"),
+        is_not_in_target_script(lang, _script, "name2"),
+        is_not_in_target_script(lang, _script, "name3"),
+      ],
+      // All three `name`, `name2`, and `name3` are not in the target script
+      [
+        "format",
+        ["get", `${name_prefix}name:${lang}`],
+        get_font_formatting(_script),
+        "\n",
+        {},
+        ...get_name_block("name", regular),
+        "\n",
+        {},
+        ...get_name_block("name2", regular),
+        "\n",
+        {},
+        ...get_name_block("name3", regular),
+      ],
+      // Exactly one of the 3 script segments `name`, `name2`, or `name3` is in the target script
+      [
+        "case",
+        ["!", is_not_in_target_script(lang, _script, "name")],
+        // `name` is in the target script, and `name2` and `name3` are not
+        [
+          "format",
+          [
+            "coalesce",
+            ["get", `${name_prefix}name:${lang}`],
+            ["get", "pgf:name"],
+            ["get", "name"],
+          ],
+          get_font_formatting(_script),
+          "\n",
+          {},
+          ...get_name_block("name2", regular),
+          "\n",
+          {},
+          ...get_name_block("name3", regular),
+        ],
+        ["!", is_not_in_target_script(lang, _script, "name2")],
+        // `name2` is in the target script, and `name` and `name3` are not
+        [
+          "format",
+          [
+            "coalesce",
+            ["get", `${name_prefix}name:${lang}`],
+            ["get", "pgf:name2"],
+            ["get", "name2"],
+          ],
+          get_font_formatting(_script),
+          "\n",
+          {},
+          ...get_name_block("name", regular),
+          "\n",
+          {},
+          ...get_name_block("name3", regular),
+        ],
+        // `name3` is in the target script, and `name` and `name2` are not
+        [
+          "format",
+          [
+            "coalesce",
+            ["get", `${name_prefix}name:${lang}`],
+            ["get", "pgf:name3"],
+            ["get", "name3"],
+          ],
+          get_font_formatting(_script),
+          "\n",
+          {},
+          ...get_name_block("name", regular),
+          "\n",
+          {},
+          ...get_name_block("name2", regular),
+        ],
+      ],
+    ],
+  ];
+  return result;
+}

package/src/layers/background.ts

@@ -0,0 +1,91 @@
+import type { LayerSpecification } from "@maplibre/maplibre-gl-style-spec";
+import { FILTERS, ZOOM } from "../constants";
+import type { Style } from "../styles";
+
+/**
+ * Creates background and base terrain layers
+ */
+export function createBackgroundLayers(
+  source: string,
+  style: Style,
+): LayerSpecification[] {
+  return [
+    // Background color
+    {
+      id: "background",
+      type: "background",
+      paint: {
+        "background-color": style.background,
+      },
+    },
+    // Earth (land) polygons
+    {
+      id: "earth",
+      type: "fill",
+      filter: FILTERS.IS_POLYGON,
+      source,
+      "source-layer": "earth",
+      paint: {
+        "fill-color": style.earth,
+      },
+    },
+  ];
+}
+
+/**
+ * Creates water layers (polygons and waterways)
+ */
+export function createWaterLayers(
+  source: string,
+  style: Style,
+): LayerSpecification[] {
+  return [
+    // Water polygons
+    {
+      id: "water",
+      type: "fill",
+      filter: FILTERS.IS_POLYGON,
+      source,
+      "source-layer": "water",
+      paint: {
+        "fill-color": style.water,
+      },
+    },
+    // Stream waterways
+    {
+      id: "water_stream",
+      type: "line",
+      source,
+      "source-layer": "waterway",
+      minzoom: ZOOM.WATERWAY_STREAM_MIN,
+      filter: ["==", "class", "stream"],
+      paint: {
+        "line-color": style.water,
+        "line-width": 0.5,
+      },
+    },
+    // River waterways
+    {
+      id: "water_river",
+      type: "line",
+      source,
+      "source-layer": "waterway",
+      minzoom: ZOOM.WATERWAY_RIVER_MIN,
+      filter: ["==", "class", "river"],
+      paint: {
+        "line-color": style.water,
+        "line-width": [
+          "interpolate",
+          ["exponential", 1.6],
+          ["zoom"],
+          9,
+          0,
+          9.5,
+          1.0,
+          18,
+          12,
+        ],
+      },
+    },
+  ];
+}

package/src/layers/boundaries.ts

@@ -0,0 +1,51 @@
+import type { LayerSpecification } from "@maplibre/maplibre-gl-style-spec";
+import type { Style } from "../styles";
+
+/**
+ * Creates administrative boundary layers
+ */
+export function createBoundaryLayers(
+  source: string,
+  style: Style,
+): LayerSpecification[] {
+  return [
+    // Country boundaries (admin_level <= 2)
+    {
+      id: "boundaries_country",
+      type: "line",
+      source,
+      "source-layer": "boundary",
+      filter: ["<=", "admin_level", 2],
+      paint: {
+        "line-color": style.boundaries,
+        "line-width": 0.7,
+        "line-dasharray": [
+          "step",
+          ["zoom"],
+          ["literal", [2, 0]],
+          4,
+          ["literal", [2, 1]],
+        ],
+      },
+    },
+    // Other administrative boundaries (admin_level > 2)
+    {
+      id: "boundaries",
+      type: "line",
+      source,
+      "source-layer": "boundary",
+      filter: [">", "admin_level", 2],
+      paint: {
+        "line-color": style.boundaries,
+        "line-width": 0.4,
+        "line-dasharray": [
+          "step",
+          ["zoom"],
+          ["literal", [2, 0]],
+          4,
+          ["literal", [2, 1]],
+        ],
+      },
+    },
+  ];
+}

package/src/layers/buildings.ts

@@ -0,0 +1,23 @@
+import type { LayerSpecification } from "@maplibre/maplibre-gl-style-spec";
+import type { Style } from "../styles";
+
+/**
+ * Creates building layers
+ */
+export function createBuildingLayers(
+  source: string,
+  style: Style,
+): LayerSpecification[] {
+  return [
+    {
+      id: "buildings",
+      type: "fill",
+      source,
+      "source-layer": "building",
+      paint: {
+        "fill-color": style.buildings,
+        "fill-opacity": 0.5,
+      },
+    },
+  ];
+}

package/src/layers/index.ts

@@ -0,0 +1,132 @@
+/**
+ * Layer generation module
+ *
+ * This module coordinates the creation of all MapLibre GL layers
+ * from the component modules.
+ */
+
+import type { LayerSpecification } from "@maplibre/maplibre-gl-style-spec";
+import type { Style } from "../styles";
+
+// Import layer creators from component modules
+import { createBackgroundLayers, createWaterLayers } from "./background";
+import { createBoundaryLayers } from "./boundaries";
+import { createBuildingLayers } from "./buildings";
+import {
+  createMiscLabels,
+  createPlaceLabels,
+  createRoadLabels,
+  createWaterLabels,
+} from "./labels";
+import {
+  createAerowayLayers,
+  createLandcoverLayers,
+  createLanduseLayers,
+  createParkLayers,
+} from "./landcover";
+import { createPoiLayers } from "./pois";
+import {
+  createBridgeLayers,
+  createPierLayer,
+  createRoadLayers,
+  createTunnelLayers,
+} from "./roads";
+import { createTransitLayers } from "./transit";
+
+/**
+ * Creates all non-label layers (fills, lines, symbols without text)
+ */
+export function nolabelsLayers(
+  source: string,
+  style: Style,
+): LayerSpecification[] {
+  return [
+    // Background and earth
+    ...createBackgroundLayers(source, style),
+
+    // Natural features
+    ...createLandcoverLayers(source, style),
+    ...createParkLayers(source, style),
+    ...createLanduseLayers(source, style),
+    ...createAerowayLayers(source, style),
+
+    // Water
+    ...createWaterLayers(source, style),
+
+    // Roads - tunnels (below other features)
+    ...createTunnelLayers(source, style),
+
+    // Buildings
+    ...createBuildingLayers(source, style),
+
+    // Roads - surface level
+    createPierLayer(source, style),
+    ...createRoadLayers(source, style),
+
+    // Transit
+    ...createTransitLayers(source, style),
+
+    // Boundaries
+    ...createBoundaryLayers(source, style),
+
+    // Roads - bridges (above other features)
+    ...createBridgeLayers(source, style),
+  ];
+}
+
+/**
+ * Creates all label layers (text symbols)
+ */
+export function labelsLayers(
+  source: string,
+  style: Style,
+  lang: string,
+  script?: string,
+): LayerSpecification[] {
+  return [
+    // Misc labels (addresses, islands)
+    ...createMiscLabels(source, style, lang, script),
+
+    // Water labels
+    ...createWaterLabels(source, style, lang, script),
+
+    // Road labels
+    ...createRoadLabels(source, style, lang, script),
+
+    // POI labels
+    ...createPoiLayers(source, style, lang, script),
+
+    // Place labels (subplaces, cities, regions, countries)
+    ...createPlaceLabels(source, style, lang, script),
+  ];
+}
+
+// Re-export component modules for direct access if needed
+export {
+  createBackgroundLayers,
+  createWaterLayers,
+} from "./background";
+export { createBoundaryLayers } from "./boundaries";
+export { createBuildingLayers } from "./buildings";
+export {
+  createLabelLayer,
+  createMiscLabels,
+  createPlaceLabels,
+  createRoadLabels,
+  createWaterLabels,
+} from "./labels";
+export {
+  createAerowayLayers,
+  createLandcoverLayers,
+  createLanduseLayers,
+  createParkLayers,
+} from "./landcover";
+export { createPoiLayers } from "./pois";
+export {
+  createBridgeLayers,
+  createPierLayer,
+  createRoadLayer,
+  createRoadLayers,
+  createTunnelLayers,
+} from "./roads";
+export { createTransitLayers } from "./transit";