.github/copilot-instructions.md

@@ -1,76 +1,58 @@
 # Fantasy Map Generator
 
-Azgaar's Fantasy Map Generator is a web application for creating fantasy maps. It generates detailed fantasy worlds with countries, cities, rivers, biomes, and cultural elements.
+Azgaar's Fantasy Map Generator is a client-side JavaScript web application for creating fantasy maps. It generates detailed fantasy worlds with countries, cities, rivers, biomes, and cultural elements.
 
 Always reference these instructions first and fallback to search or bash commands only when you encounter unexpected information that does not match the info here.
 
 ## Working Effectively
 
-- The project uses NPM, Vite, and TypeScript for development and building.
+- **CRITICAL**: This is a static web application - NO build process needed. No npm install, no compilation, no bundling.
-- **Setup**: Run `npm install` to install dependencies (requires Node.js >= 24.0.0)
+- Run the application using HTTP server (required - cannot run with file:// protocol):
-- **Development**: Run `npm run dev` to start the Vite development server
+  - `python3 -m http.server 8000` - takes 2-3 seconds to start
-  - Access at: `http://localhost:5173` (Vite's default port)
+- Access at: `http://localhost:8000`
-  - Hot module replacement (HMR) enabled - changes are reflected immediately
-- **Building**: Run `npm run build` to compile TypeScript and build for production
-  - TypeScript compilation runs first (`tsc`)
-  - Vite builds the application to `dist/` directory
-- **Preview**: Run `npm run preview` to preview the production build locally
 
 ## Validation
 
 - Always manually validate any changes by:
-  1. Run `npm run dev` to start the development server (wait for "ready" message)
+  1. Starting the HTTP server (NEVER CANCEL - wait for full startup)
-  2. Navigate to the application in browser (typically `http://localhost:5173`)
+  2. Navigate to the application in browser
   3. Click the "►" button to open the menu and generate a new map
   4. **CRITICAL VALIDATION**: Verify the map generates with countries, cities, roads, and geographic features
   5. Test UI interaction: click "Layers" button, verify layer controls work
   6. Test regeneration: click "New Map!" button, verify new map generates correctly
 - **Known Issues**: Google Analytics and font loading errors are normal (blocked external resources)
-- For production build validation: run `npm run build` followed by `npm run preview`
 
 ## Repository Structure
 
 ### Core Files
 
-- `package.json` - NPM package configuration with scripts and dependencies
+- `index.html` - Main application entry point
-- `vite.config.ts` - Vite build configuration
+- `main.js` - Core application logic
-- `tsconfig.json` - TypeScript compiler configuration
+- `versioning.js` - Version management and update handling
 
-### Source Directories
+### Key Directories
 
-- `src/` - Source code directory (build input)
+- `modules/` - core functionality modules:
-  - `src/index.html` - Main application entry point
-  - `src/utils/` - TypeScript utility modules (migrated from JS)
-- `public/` - Static assets (copied to build output)
-  - `public/main.js` - Core application logic
-  - `public/versioning.js` - Version management and update handling
-  - `public/modules/` - Core functionality modules:
   - `modules/ui/` - UI components (editors, tools, style management)
   - `modules/dynamic/` - runtime modules (export, installation)
   - `modules/renderers/` - drawing and rendering logic
-  - `public/styles/` - Visual style presets (JSON files)
+- `utils/` - utility libraries (math, arrays, strings, etc.)
-  - `public/libs/` - Third-party libraries (D3.js, TinyMCE, etc.)
+- `styles/` - visual style presets (JSON files)
-  - `public/images/` - Backgrounds, UI elements
+- `libs/` - Third-party libraries (D3.js, TinyMCE, etc.)
-  - `public/charges/` - Heraldic symbols and coat of arms elements
+- `images/` - backgrounds, UI elements
-  - `public/config/` - Heightmap templates and configurations
+- `charges/` - heraldic symbols and coat of arms elements
-  - `public/heightmaps/` - Terrain generation data
+- `config/` - Heightmap templates and configurations
-- `dist/` - Production build output (generated by `npm run build`)
+- `heightmaps/` - Terrain generation data
 
 ## Common Tasks
 
 ### Making Code Changes
 
-1. **TypeScript files** (`src/utils/*.ts`):
+1. Edit JavaScript files directly (no compilation needed)
-   - Edit TypeScript files in the `src/utils/` directory
+2. Refresh browser to see changes immediately
-   - Changes are automatically recompiled and hot-reloaded in dev mode
+3. **ALWAYS test map generation** after making changes
-   - Run `npm run build` to verify TypeScript compilation succeeds
+4. Update version in `versioning.js` for all changes
-2. **JavaScript files** (`public/*.js`, `public/modules/*.js`):
+5. Update file hashes in `index.html` for changed files (format: `file.js?v=1.108.1`)
-   - Edit JavaScript files directly in the `public/` directory
-   - Changes are automatically reflected in dev mode via HMR
-   - **Note**: Core application logic is still in JavaScript and gradually being migrated
-3. **Always test map generation** after making changes
-4. Update version in `public/versioning.js` for all changes
-5. For production builds, update file hashes in `src/index.html` if needed (format: `file.js?v=1.108.1`)
 
 ### Debugging Map Generation
 
@@ -89,30 +71,19 @@ Always reference these instructions first and fallback to search or bash command
 
 ### Application Won't Load
 
-- Run `npm install` to ensure dependencies are installed
+- Ensure using HTTP server (not file://)
-- Run `npm run dev` to start the development server
+- Check console for JavaScript errors
-- Check console for JavaScript/TypeScript errors
 - Verify all files are present in repository
-- Ensure Node.js version >= 24.0.0 (`node --version`)
-
-### Build Failures
-
-- Check TypeScript compilation errors (`tsc` output)
-- Verify all dependencies are installed (`npm install`)
-- Check `tsconfig.json` for configuration issues
-- Look for import/module resolution errors
 
 ### Map Generation Fails
 
 - Check browser console for error messages
 - Look for specific module failures in generation logs
 - Try refreshing page and generating new map
-- Verify build completed successfully if using production build
 
 ### Performance Issues
 
 - Map generation should complete in ~1 second for standard configurations
 - If slower, check browser console for errors
-- Development mode may be slower due to HMR overhead
 
-Remember: This is a sophisticated application that generates complete fantasy worlds with political systems, geography, cultures, and detailed cartographic elements. The project is gradually migrating from vanilla JavaScript to TypeScript. Always validate that your changes preserve the core map generation functionality.
+Remember: This is a sophisticated client-side application that generates complete fantasy worlds with political systems, geography, cultures, and detailed cartographic elements. Always validate that your changes preserve the core map generation functionality.

.github/pull_request_template.md

@@ -4,7 +4,7 @@
 
 # Type of change
 
-<!-- Please put X into brackets of required option OR delete options that are not relevant -->
+<!-- Please put X into brackers of required option OR delete options that are not relevant -->
 
 - [ ] Bug fix
 - [ ] New feature

.github/workflows/deploy.yml

@@ -1,51 +0,0 @@
-# Simple workflow for deploying static content to GitHub Pages
-name: Deploy static content to Pages
-
-on:
-  # Runs on pushes targeting the default branch
-  push:
-    branches: ['master']
-
-  # Allows you to run this workflow manually from the Actions tab
-  workflow_dispatch:
-
-# Sets the GITHUB_TOKEN permissions to allow deployment to GitHub Pages
-permissions:
-  contents: read
-  pages: write
-  id-token: write
-
-# Allow one concurrent deployment
-concurrency:
-  group: 'pages'
-  cancel-in-progress: true
-
-jobs:
-  # Single deploy job since we're just deploying
-  deploy:
-    environment:
-      name: github-pages
-      url: ${{ steps.deployment.outputs.page_url }}
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v5
-      - name: Set up Node
-        uses: actions/setup-node@v6
-        with:
-          node-version: lts/*
-          cache: 'npm'
-      - name: Install dependencies
-        run: npm ci
-      - name: Build
-        run: npm run build
-      - name: Setup Pages
-        uses: actions/configure-pages@v5
-      - name: Upload artifact
-        uses: actions/upload-pages-artifact@v4
-        with:
-          # Upload dist folder
-          path: './dist'
-      - name: Deploy to GitHub Pages
-        id: deployment
-        uses: actions/deploy-pages@v4

.github/workflows/lint.yml

@@ -1,22 +0,0 @@
-name: Code quality
-
-on:
-  push:
-  pull_request:
-
-jobs:
-  quality:
-    runs-on: ubuntu-latest
-    permissions:
-      contents: read
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v5
-        with:
-          persist-credentials: false
-      - name: Setup Biome
-        uses: biomejs/setup-biome@v2
-        with:
-          version: latest
-      - name: Run Biome
-        run: biome ci .

.github/workflows/playwright.yml

@@ -1,25 +0,0 @@
-name: Playwright Tests
-on:
-  pull_request:
-    branches: [ master ]
-jobs:
-  test:
-    timeout-minutes: 60
-    runs-on: ubuntu-latest
-    steps:
-    - uses: actions/checkout@v5
-    - uses: actions/setup-node@v5
-      with:
-        node-version: '24'
-    - name: Install dependencies
-      run: npm ci
-    - name: Install Playwright Browsers
-      run: npx playwright install --with-deps
-    - name: Run Playwright tests
-      run: npm run test:e2e
-    - uses: actions/upload-artifact@v4
-      if: ${{ !cancelled() }}
-      with:
-        name: playwright-report
-        path: playwright-report/
-        retention-days: 30

.github/workflows/unit-tests.yml

@@ -1,17 +0,0 @@
-name: Unit Tests
-on:
-  pull_request:
-    branches: [ master ]
-jobs:
-  test:
-    timeout-minutes: 60
-    runs-on: ubuntu-latest
-    steps:
-    - uses: actions/checkout@v5
-    - uses: actions/setup-node@v5
-      with:
-        node-version: '24'
-    - name: Install dependencies
-      run: npm ci
-    - name: Run Unit tests
-      run: npm run test

.gitignore

@@ -1,8 +1,5 @@
 .vscode
 .idea
 /node_modules
-*/node_modules
 /dist
 /coverage
-/playwright-report
-/test-results

.vscode/launch.json

@@ -0,0 +1,11 @@
+{
+  "version": "0.1.0",
+  "configurations": [
+    {
+      "name": "Debug",
+      "type": "chrome",
+      "request": "launch",
+      "file": "${workspaceFolder}/index.html"
+    }
+  ]
+}

Dockerfile

@@ -1,27 +1,7 @@
-# Build stage
-FROM node:24-alpine AS builder
-
-WORKDIR /app
-
-# Copy package files
-COPY package*.json ./
-
-# Install dependencies
-RUN npm ci
-
-# Copy source code
-COPY ./src ./src
-COPY ./public ./public
-COPY vite.config.js .
-
-# Build the application
-RUN npm run build
-
-# Production stage
 FROM nginx:stable-alpine
 
-# Copy built files from builder stage
+# Copy the contents of the repo to the container
-COPY --from=builder /app/dist /usr/share/nginx/html
+COPY . /usr/share/nginx/html
 
-# Copy the customized nginx config file to the nginx folder
+# Move the customized nginx config file to the nginx folder
-COPY .docker/default.conf /etc/nginx/conf.d/default.conf
+RUN mv /usr/share/nginx/html/.docker/default.conf /etc/nginx/conf.d/default.conf

biome.json

@@ -1,58 +0,0 @@
-{
-  "$schema": "https://biomejs.dev/schemas/2.3.13/schema.json",
-  "vcs": {
-    "enabled": true,
-    "clientKind": "git",
-    "useIgnoreFile": true
-  },
-  "files": {
-    "includes": ["src/**/*.ts"]
-  },
-  "formatter": {
-    "enabled": true,
-    "indentStyle": "space"
-  },
-  "linter": {
-    "enabled": true,
-    "rules": {
-      "recommended": true,
-      "style": {
-        "useTemplate": {
-          "level": "warn",
-          "fix": "safe"
-        },
-        "noNonNullAssertion": "off"
-      },
-      "suspicious": {
-        "noExplicitAny": "off",
-        "noGlobalIsNan": {
-          "level": "error",
-          "fix": "safe"
-        }
-      },
-      "correctness": {
-        "noUnusedVariables": {
-          "level": "error",
-          "fix": "safe"
-        },
-        "useParseIntRadix": {
-          "fix": "safe",
-          "level": "error"
-        }
-      }
-    }
-  },
-  "javascript": {
-    "formatter": {
-      "quoteStyle": "double"
-    }
-  },
-  "assist": {
-    "enabled": true,
-    "actions": {
-      "source": {
-        "organizeImports": "on"
-      }
-    }
-  }
-}