feat: add initial Pokémon map data and loader

- Introduced a new JSON file `map_pokemon_v1.json` containing detailed city data for the Pokémon map, including attributes like population, agriculture, commerce, and connections.
- Implemented a map loader in `mapLoader.ts` to read and parse map definitions from JSON files, allowing for dynamic loading of map data.
- Created a script `generate-map-data.mjs` to convert legacy PHP map data into the new JSON format, ensuring compatibility with the updated map system.

app/game-engine/src/scenario/mapLoader.ts

@@ -0,0 +1,51 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+import type { MapDefinition } from '@sammo-ts/logic';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const DEFAULT_MAP_ROOT = path.resolve(
+    __dirname,
+    '..',
+    '..',
+    'resources',
+    'map'
+);
+
+export interface MapLoaderOptions {
+    mapRoot?: string;
+    filePrefix?: string;
+}
+
+const readJsonFile = async (filePath: string): Promise<unknown> => {
+    const raw = await fs.readFile(filePath, 'utf8');
+    return JSON.parse(raw) as unknown;
+};
+
+const resolveMapRoot = (options?: MapLoaderOptions): string =>
+    options?.mapRoot ?? DEFAULT_MAP_ROOT;
+
+export const resolveMapDefinitionPath = (
+    mapName: string,
+    options?: MapLoaderOptions
+): string => {
+    const prefix = options?.filePrefix ?? 'map_';
+    return path.resolve(resolveMapRoot(options), `${prefix}${mapName}.json`);
+};
+
+export const loadMapDefinition = async (
+    mapPath: string
+): Promise<MapDefinition> => {
+    const raw = await readJsonFile(mapPath);
+    return raw as MapDefinition;
+};
+
+export const loadMapDefinitionByName = async (
+    mapName: string,
+    options?: MapLoaderOptions
+): Promise<MapDefinition> => {
+    const mapPath = resolveMapDefinitionPath(mapName, options);
+    return loadMapDefinition(mapPath);
+};