diff --git a/.vscode/launch.json b/.vscode/launch.json index fb64920..986714f 100644 --- a/.vscode/launch.json +++ b/.vscode/launch.json @@ -8,12 +8,16 @@ // // Il pattern riconosce la riga «Local http://…» di Astro anche quando è colorata: su Windows // Astro scrive sempre i codici colore ANSI, che non devono finire nell'indirizzo aperto. + // + // Prima di ogni avvio il task «Sito: dipendenze» esegue npm ci se node_modules manca o è + // più vecchia di package-lock.json (clone appena fatto, pull con dipendenze nuove). "version": "0.2.0", "configurations": [ { "name": "Sito: sviluppo (Edge)", "type": "node", "request": "launch", + "preLaunchTask": "Sito: dipendenze", "program": "${workspaceFolder}/node_modules/astro/bin/astro.mjs", "args": ["dev"], "cwd": "${workspaceFolder}", @@ -33,6 +37,7 @@ "name": "Sito: sviluppo (Chrome)", "type": "node", "request": "launch", + "preLaunchTask": "Sito: dipendenze", "program": "${workspaceFolder}/node_modules/astro/bin/astro.mjs", "args": ["dev"], "cwd": "${workspaceFolder}", @@ -49,7 +54,8 @@ "presentation": { "group": "sito", "order": 2 } }, { - // Prima compila dist/ (task «Sito: build»), poi lo serve come in produzione. + // Prima controlla le dipendenze e compila dist/ (task «Sito: build»), poi lo serve come in + // produzione. "name": "Sito: anteprima della build (Edge)", "type": "node", "request": "launch", diff --git a/.vscode/tasks.json b/.vscode/tasks.json index e62d1c9..7fb534a 100644 --- a/.vscode/tasks.json +++ b/.vscode/tasks.json @@ -2,12 +2,25 @@ // Task usati da .vscode/launch.json (avviabili anche da Terminale → Esegui attività). "version": "2.0.0", "tasks": [ + { + // Prima di ogni avvio: npm ci solo se node_modules manca o è più vecchia di + // package-lock.json (clone appena fatto, pull con dipendenze nuove); altrimenti è immediato. + "label": "Sito: dipendenze", + "detail": "installa le dipendenze (npm ci) solo se mancano o sono da aggiornare", + "type": "process", + "command": "node", + "args": ["scripts/ensure-deps.mjs"], + "options": { "cwd": "${workspaceFolder}" }, + "presentation": { "reveal": "silent", "panel": "shared", "showReuseMessage": false }, + "problemMatcher": [] + }, { "label": "Sito: build", "detail": "astro build: genera il sito statico in dist/", "type": "npm", "script": "build", "group": "build", + "dependsOn": ["Sito: dipendenze"], "problemMatcher": [] } ] diff --git a/CHANGELOG.md b/CHANGELOG.md index c8fbc3e..a0d413e 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -4,6 +4,12 @@ Tutte le modifiche rilevanti a questo progetto sono documentate in questo file. Il formato segue [Keep a Changelog](https://keepachangelog.com/it-IT/1.1.0/) e il progetto adotta il [Versionamento Semantico](https://semver.org/lang/it/). +## [Non rilasciato] + +### Corretto + +- Avvio da VS Code (F5): prima di ogni avvio il nuovo task «Sito: dipendenze» (`scripts/ensure-deps.mjs`) esegue `npm ci` se `node_modules` manca o è più vecchia di `package-lock.json`. Prima, su un clone senza dipendenze installate, l'avvio falliva perché `node_modules/astro/bin/astro.mjs` non esisteva. + ## [1.1.0] - 2026-11-13 ### Modificato diff --git a/README.md b/README.md index 2c6f86e..8b5fa21 100644 --- a/README.md +++ b/README.md @@ -26,14 +26,14 @@ npm run package # crea lo zip di rilascio in release/ ### Avvio in debug con VS Code -Dopo `npm ci`, aprire il pannello **Esegui e debug** (Ctrl+Maiusc+D), scegliere una configurazione e premere **F5**: +Aprire la cartella del repository in VS Code, poi il pannello **Esegui e debug** (Ctrl+Maiusc+D), scegliere una configurazione e premere **F5**. Prima di ogni avvio il task «Sito: dipendenze» (`scripts/ensure-deps.mjs`) esegue `npm ci` se `node_modules` manca o è più vecchia di `package-lock.json`, per esempio su un clone appena fatto o dopo un pull che ha cambiato le dipendenze; altrimenti è immediato. | Configurazione | Cosa fa | | ------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `Sito: sviluppo (Edge)` / `(Chrome)` | `astro dev` con il debugger di Node; quando il server è pronto apre il browser con il debugger collegato (punti di interruzione negli script di `src/scripts/`) | | `Sito: anteprima della build (Edge)` | esegue `npm run build` e serve `dist/` come in produzione su | -Maiusc+F5 ferma il server e chiude il browser quando è selezionata la sessione del server, come all'avvio. Dopo una pausa su un punto di interruzione nel browser è selezionata la sessione del browser, e Maiusc+F5 chiude solo quella: premerlo una seconda volta, oppure usare Stop sulla sessione «Sito: sviluppo» nel pannello dello stack di chiamate. Le configurazioni sono in [`.vscode/launch.json`](.vscode/launch.json) e [`.vscode/tasks.json`](.vscode/tasks.json). Astro avvia un solo server di sviluppo per progetto: se `npm run dev` è già aperto in un terminale, chiuderlo prima di premere F5. +Maiusc+F5 ferma il server e chiude il browser quando è selezionata la sessione del server, come all'avvio. Dopo una pausa su un punto di interruzione nel browser è selezionata la sessione del browser, e Maiusc+F5 chiude solo quella: premerlo una seconda volta, oppure usare Stop sulla sessione «Sito: sviluppo» nel pannello dello stack di chiamate. Le configurazioni sono in [`.vscode/launch.json`](.vscode/launch.json) e [`.vscode/tasks.json`](.vscode/tasks.json). Astro avvia un solo server di sviluppo per progetto: se `npm run dev` è già aperto in un terminale, chiuderlo prima di premere F5 (altrimenti l'avvio si ferma con «Another astro dev server is already running»; `npx astro dev stop` chiude quello rimasto aperto). ## Comandi @@ -71,7 +71,8 @@ src/pages/ una pagina per file; servizi/[slug].astro genera le 6 pagine src/styles/ tokens.css (colori, tipografia, spaziature), global.css, fonts.css, print.css src/scripts/ piccoli script: menu, mappa su consenso, modulo, ancore del vecchio sito public/ .htaccess, favicon e immagini statiche (copiati così come sono) -scripts/ script di test, pacchetto, icone, note di rilascio, upload della release +scripts/ script di test, pacchetto, icone, note di rilascio, upload della release, + dipendenze prima dell'avvio da VS Code (ensure-deps.mjs) tests/ e2e/ e a11y/ (Playwright), helpers/ deploy/ nginx.conf.example, optional-php-form/contact.php, gitea-deploy.yml.example (esempio di deploy automatico, disattivato) diff --git a/scripts/ensure-deps.mjs b/scripts/ensure-deps.mjs new file mode 100644 index 0000000..415e295 --- /dev/null +++ b/scripts/ensure-deps.mjs @@ -0,0 +1,52 @@ +#!/usr/bin/env node +/** + * Installa le dipendenze con `npm ci` solo se servono: node_modules manca, manca una delle + * dipendenze dirette di package.json, oppure package-lock.json è più recente dell'ultima + * installazione (per esempio dopo un pull che ha aggiornato le dipendenze). Altrimenti esce + * subito. Lo usa VS Code prima di ogni avvio (.vscode/tasks.json, «Sito: dipendenze»), così + * F5 funziona anche su un clone appena fatto. + */ +import { spawnSync } from 'node:child_process'; +import { existsSync, readFileSync, statSync } from 'node:fs'; +import { join, resolve } from 'node:path'; + +const root = resolve(process.argv[2] ?? join(import.meta.dirname, '..')); +const lockFile = join(root, 'package-lock.json'); +// npm scrive questa copia del lockfile a ogni installazione completata +const installedLock = join(root, 'node_modules', '.package-lock.json'); + +function reason() { + if (!existsSync(installedLock)) return 'node_modules assente o incompleta'; + const pkg = JSON.parse(readFileSync(join(root, 'package.json'), 'utf8')); + const direct = Object.keys({ ...pkg.dependencies, ...pkg.devDependencies }); + const missing = direct.filter( + (name) => !existsSync(join(root, 'node_modules', name, 'package.json')), + ); + if (missing.length > 0) return `dipendenze mancanti: ${missing.join(', ')}`; + if (statSync(lockFile).mtimeMs > statSync(installedLock).mtimeMs) { + return 'package-lock.json è cambiato dopo l’ultima installazione'; + } + return null; +} + +const why = reason(); +if (!why) { + console.log('Dipendenze già installate.'); + process.exit(0); +} + +console.log(`Installo le dipendenze (${why}): npm ci`); +// su Windows npm è npm.cmd, che Node avvia solo attraverso la shell (e con la shell il +// comando va passato come stringa unica: argomenti separati sono deprecati, DEP0190) +const npmCi = 'npm ci --no-audit --no-fund'; +const result = + process.platform === 'win32' + ? spawnSync(npmCi, { cwd: root, stdio: 'inherit', shell: true }) + : spawnSync('npm', npmCi.split(' ').slice(1), { cwd: root, stdio: 'inherit' }); +if (result.status !== 0) { + console.error( + 'npm ci non è riuscito. Se il sito è già avviato (F5 o npm run dev), fermarlo e riprovare: ' + + 'su Windows i file in uso non si possono sostituire.', + ); + process.exit(result.status ?? 1); +}