fase 7 completata

Author: ronzim

.github/workflows/ci.yml

@@ -0,0 +1,76 @@
+name: CI
+
+on:
+    push:
+        branches: [main, refactoring]
+    pull_request:
+        branches: [main]
+
+jobs:
+    lint:
+        name: Lint
+        runs-on: ubuntu-latest
+        steps:
+            - uses: actions/checkout@v4
+            - uses: actions/setup-node@v4
+              with:
+                  node-version: 20
+                  cache: npm
+            - run: npm ci
+            - run: npm run lint
+
+    test:
+        name: Test (Node ${{ matrix.node-version }})
+        runs-on: ubuntu-latest
+        strategy:
+            matrix:
+                node-version: [18, 20, 22]
+        steps:
+            - uses: actions/checkout@v4
+            - uses: actions/setup-node@v4
+              with:
+                  node-version: ${{ matrix.node-version }}
+                  cache: npm
+            - run: npm ci
+            - run: npm run build --workspace=packages/core
+            - run: npm run test --workspace=packages/core
+
+    typecheck:
+        name: Type Check
+        runs-on: ubuntu-latest
+        steps:
+            - uses: actions/checkout@v4
+            - uses: actions/setup-node@v4
+              with:
+                  node-version: 20
+                  cache: npm
+            - run: npm ci
+            - run: npm run typecheck --workspace=packages/core
+            - run: npm run typecheck --workspace=packages/app
+
+    build-app:
+        name: Build Electron App (${{ matrix.os }})
+        runs-on: ${{ matrix.os }}
+        needs: [lint, test, typecheck]
+        strategy:
+            matrix:
+                os: [ubuntu-latest, windows-latest, macos-latest]
+        steps:
+            - uses: actions/checkout@v4
+            - uses: actions/setup-node@v4
+              with:
+                  node-version: 20
+                  cache: npm
+            - run: npm ci
+            - run: npm run build --workspace=packages/core
+            - run: npm run build --workspace=packages/app
+            - name: Package with electron-builder
+              run: npm run dist --workspace=packages/app
+              env:
+                  GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+            - name: Upload artifacts
+              uses: actions/upload-artifact@v4
+              with:
+                  name: mappit-app-${{ matrix.os }}
+                  path: packages/app/release/*.*
+                  if-no-files-found: ignore

.github/workflows/publish.yml

@@ -0,0 +1,27 @@
+name: Publish mappit-core to npm
+
+on:
+    release:
+        types: [published]
+
+jobs:
+    publish:
+        name: Publish to npm
+        runs-on: ubuntu-latest
+        permissions:
+            contents: read
+            id-token: write
+        steps:
+            - uses: actions/checkout@v4
+            - uses: actions/setup-node@v4
+              with:
+                  node-version: 20
+                  cache: npm
+                  registry-url: https://registry.npmjs.org
+            - run: npm ci
+            - run: npm run build --workspace=packages/core
+            - run: npm run test --workspace=packages/core
+            - name: Publish
+              run: npm publish --workspace=packages/core --provenance --access public
+              env:
+                  NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

.gitignore

@@ -3,4 +3,6 @@ node_modules
 packages/*/node_modules
 packages/*/dist
 packages/*/coverage
+packages/*/docs
+packages/app/release
 *.tsbuildinfo

README.md

@@ -1,4 +1,31 @@
-# MappIt
+# MappIt — Google Location History Viewer & Toolkit
+
+> **Open-source desktop app and CLI to load, filter, and visualize your Google Location History data exported from Google Takeout.**  
+> Supports all export formats (Records.json, Timeline.json, Semantic Location History), handles files > 500 MB, and keeps your data 100 % local.
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![Node.js](https://img.shields.io/badge/node-%3E%3D18-brightgreen)](https://nodejs.org/)
+
+**Keywords:** google location history viewer, google takeout visualization, google maps timeline viewer, google location history map, location history export tool, GPS data visualization, google timeline data explorer
+
+---
+
+<details>
+<summary><strong>🇬🇧 English summary</strong></summary>
+
+MappIt is a privacy-first toolkit for exploring your Google Location History locally:
+
+- **Electron desktop app** with interactive map (deck.gl + MapLibre), timeline sidebar, activity filters, area search, and KML/JSON export
+- **Node.js CLI** for headless processing, filtering, and exporting
+- **Core library** (`mappit-core`) usable in your own scripts
+- Auto-detects all Google Takeout location formats (Records.json, Timeline.json standard/semantic/iOS, monthly Semantic Location History files)
+- Filters by date range, bounding box, or activity type
+- Computes stats: distance per activity, monthly summaries, yearly breakdowns
+- Exports to JSON and KML
+
+</details>
+
+---
 
 Strumenti per caricare, filtrare e visualizzare i dati di Google Location History scaricati da Google Takeout.
 
@@ -207,7 +234,23 @@ dist/
 - **Vite** v7 come bundler per il renderer
 - **Vanilla TypeScript** per la UI (nessun framework)
 
-> La UI mappa e timeline (deck.gl, sidebar, filtri interattivi) è pianificata per la Fase 5. Vedi [ROADMAP.md](ROADMAP.md).
+> L'app include mappa interattiva (deck.gl + MapLibre), sidebar timeline, filtri attività, ricerca luoghi, area search, summary con grafici, e export KML/JSON.
+
+### Distribuzione
+
+L'app può essere pacchettizzata per Windows, macOS e Linux tramite electron-builder:
+
+```bash
+# Build + package per la piattaforma corrente
+npm run dist --workspace=packages/app
+
+# Oppure per piattaforme specifiche
+npm run dist:win --workspace=packages/app
+npm run dist:mac --workspace=packages/app
+npm run dist:linux --workspace=packages/app
+```
+
+Gli artefatti vengono generati in `packages/app/release/`.
 
 ---
 
@@ -218,11 +261,23 @@ npm run build        # build di tutti i package
 npm run test         # test di tutti i package
 npm run lint         # ESLint su tutti i sorgenti TypeScript
 npm run format       # Prettier su tutti i sorgenti TypeScript
-npm run legacy:start # avvia la vecchia app Electron+Plotly (pre-ristrutturazione)
 ```
 
 ---
 
+## Documentazione API
+
+La documentazione API di `mappit-core` è generata con [TypeDoc](https://typedoc.org/) a partire dai commenti JSDoc nel codice sorgente.
+
+```bash
+# Genera la documentazione HTML in packages/core/docs/
+npm run docs --workspace=packages/core
+```
+
+Apri `packages/core/docs/index.html` nel browser per consultarla.
+
+---
+
 ## Fixtures di test
 
 La cartella `fixtures/` contiene file di esempio per ogni formato, usati dai test unitari:
@@ -246,8 +301,11 @@ mappit-core/
 │   ├── core/               ← mappit-core (libreria + CLI)
 │   │   ├── src/
 │   │   ├── dist/           ← output build (gitignored)
+│   │   ├── docs/           ← documentazione API TypeDoc (gitignored)
+│   │   ├── tests/
 │   │   ├── package.json
 │   │   ├── tsconfig.json
+│   │   ├── typedoc.json
 │   │   └── vitest.config.ts
 │   └── app/                ← mappit-app (Electron)
 │       ├── src/
@@ -260,11 +318,9 @@ mappit-core/
 │       ├── package.json
 │       └── tsconfig.json
 ├── fixtures/               ← dati di test per tutti i formati
-├── src/                    ← codice legacy (pre-ristrutturazione)
-├── timeline.html           ← viewer HTML standalone (pre-ristrutturazione)
+├── .github/workflows/      ← CI/CD (lint, test, build)
 ├── tsconfig.base.json      ← tsconfig condiviso
 ├── eslint.config.js
-├── .prettierrc
 ├── package.json            ← workspace root
 ├── ROADMAP.md              ← piano di sviluppo dettagliato
 └── DECISIONS.md            ← registro decisioni implementative

ROADMAP.md

@@ -307,16 +307,16 @@ interface MappitDataset {
 
 ---
 
-### Fase 7 — Pulizia e rilascio
+### Fase 7 — Pulizia e rilascio ✅
 
 > **Obiettivo**: codice production-ready.
 
-- [ ] **7.1** Rimuovere i file legacy (`src/main.js`, `src/data.js`, `src/plot.js`, `src/utils.js`, `src/defaults.js`, `index.html`, `test_data.js`, `timeline.html`)
-- [ ] **7.2** Documentazione API per `mappit-core` (JSDoc o TypeDoc)
-- [ ] **7.3** README aggiornato con istruzioni per entrambi i package
-- [ ] **7.4** CI/CD: GitHub Actions per lint, test, build
-- [ ] **7.5** Pubblicazione npm del core (opzionale, può restare privato)
-- [ ] **7.6** Build dell'app Electron per distribuzione con electron-builder
+- [x] **7.1** Rimuovere i file legacy (`src/main.js`, `src/data.js`, `src/plot.js`, `src/utils.js`, `src/defaults.js`, `index.html`, `test_data.js`, `timeline.html`)
+- [x] **7.2** Documentazione API per `mappit-core` (JSDoc + TypeDoc)
+- [x] **7.3** README aggiornato con istruzioni per entrambi i package
+- [x] **7.4** CI/CD: GitHub Actions per lint, test, build
+- [x] **7.5** Pubblicazione npm del core (preparata con `prepublishOnly`, workflow publish.yml)
+- [x] **7.6** Build dell'app Electron per distribuzione con electron-builder
 
 ---