task: Restructure site a bit (plain js -> ts)

Author: tuxuser

.github/workflows/deploy.yml

@@ -30,20 +30,21 @@ jobs:
         run: pip install -U uv
       - name: Verify CSVs
         run: ./scripts/verify_via_meta.py meta.json.sample
-      - name: Create meta file
-        run: |
-          ./scripts/create_meta.py --postcodes postcodes.csv --errormasks errormasks.csv --oserrors oserrors.csv meta.json
-      - name: Copy files into site-dir
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+      - name: Build site
         run: |
-          cp meta.json site/
-          cp *.csv site/
+          npm ci
+          npm run build
       - name: Upload artifacts
         uses: actions/upload-artifact@v4
         with:
-          name: site
+          name: dist
           if-no-files-found: error
           path: |
-            site
+            dist
 
   deploy:
     needs: prepare
@@ -55,16 +56,16 @@ jobs:
     steps:
       - uses: actions/download-artifact@v4
         with:
-          name: site
-          path: site
+          name: dist
+          path: dist
       - name: List current dir
         run: ls -R
       - name: Setup Pages
         uses: actions/configure-pages@v5
       - name: Upload artifact
         uses: actions/upload-pages-artifact@v3
         with:
-          path: 'site'
+          path: 'dist'
       - name: Deploy to GitHub Pages
         id: deployment
         uses: actions/deploy-pages@v4

.gitignore

@@ -1,3 +1,5 @@
 site/*.csv
 meta.json
-**/__pycache__
+**/__pycache__
+node_modules
+dist

README.md

@@ -62,6 +62,16 @@ To open/edit the CSV files in LibreOffice Calc, use the following settings:
 
 ![Libreoffice Calc CSV settings](./assets/csv_libreoffice_calc.png)
 
+## Building the site
+
+The site's client-side logic is written in TypeScript (`src/*.ts`). `site/` holds the static source (HTML, CSS, assets); `npm run build` compiles the TypeScript and assembles the deployable site into `dist/`.
+
+```sh
+npm install
+npm run build
+npm run dev   # serves dist/ at http://localhost:3000
+```
+
 ## Scripts
 
 There are scripts to verify CSVs and also create metadata.