@noeva/analytics-core 0.4.0 → 0.4.1

package/CHANGELOG.md

@@ -3,6 +3,12 @@
 Le versioni del pacchetto che i repository dei progetti installano (ADR 0005). Prima di
 `analytics upgrade` si legge cosa cambia fra la versione installata e la nuova.
 
+## 0.4.1 — 10 novembre 2026
+
+- `voce.js`: `montaSceltaVoce("#voce", { lingue: ["it"] })` mostra solo le lingue in cui
+  il progetto ha pagine con il commento; senza `lingue` restano tutte quelle del
+  catalogo. La 0.4.0 su npm aveva il modulo senza questa opzione.
+
 ## 0.4.0 — 10 novembre 2026
 
 - **Le risposte alle domande si registrano in ogni progetto allo stesso modo**
@@ -20,6 +26,14 @@ Le versioni del pacchetto che i repository dei progetti installano (ADR 0005). P
   di fuoco e `commento.js` legge da li' filtri e fuoco. Una pagina che non chiama
   `montaVista` resta com'e'. Le frasi nuove da tradurre in `en.js` sono in
   `lib/pagina/README.md` di NOEVA Analytics.
+- **La voce del commento anche sul sito pubblicato** (NW-1091). Modulo nuovo
+  `apps/assets/voce.js`: `montaSceltaVoce("#voce")` nella home del progetto offre, per
+  italiano e inglese, le voci del catalogo del contenitore (`ai/voci`, ElevenLabs con la
+  chiave in un secret del Worker) con «Ascolta»; la scelta resta nel browser. Dove il
+  contenitore non fa la voce il riquadro resta nascosto. `commento.js` usa la voce
+  scelta; chi non sceglie sente quella di prima. La home monta il modulo con un
+  `import()` dinamico, cosi' resta buona anche prima dell'aggiornamento. Le frasi nuove
+  da tradurre in `en.js` sono in `lib/pagina/README.md` di NOEVA Analytics.
 - La chat su NOEVA Agents chiede `ai/token` solo quando si apre (NW-1279): al
   caricamento della pagina chiede solo `ai/token?disponibile`, senza token.
 - `snapshot.json` porta in `progetto` l'id del progetto nel contenitore, non il nome

package/contenuto/assets/voce.js

@@ -9,6 +9,7 @@
  *   montaSceltaVoce("#voce")        nella home del progetto: per ogni lingua le
  *                                   voci, con «Ascolta»; non compare se il
  *                                   contenitore non ha la voce online
+ *   montaSceltaVoce("#voce", { lingue: ["it"] })   solo le lingue del progetto
  *   await voceOnline()              true se il contenitore fa la voce
  *   voceScelta("it")                l'id scelto per la lingua, o null
  *   await parla(testo, { pagina })  l'URL (blob:) dell'mp3, dalla voce scelta
@@ -71,8 +72,9 @@ export async function parla(testo, { lingua = LINGUA, voce = voceScelta(lingua),
 
 /* La scelta della voce, nella home del progetto. Si monta in un contenitore
  * qualunque (`dove`: selettore o elemento); resta vuoto e nascosto se il
- * contenitore Analytics non fa la voce. */
-export async function montaSceltaVoce(dove) {
+ * contenitore Analytics non fa la voce. `lingue`: quelle in cui il progetto ha
+ * pagine con il commento (di default tutte quelle del catalogo). */
+export async function montaSceltaVoce(dove, { lingue: soloLingue } = {}) {
   const el = typeof dove === "string" ? document.querySelector(dove) : dove;
   if (!el) return null;
   el.hidden = true;
@@ -80,7 +82,10 @@ export async function montaSceltaVoce(dove) {
   if (!cat) return null;
 
   // prima la lingua della pagina, poi le altre
-  const lingue = Object.keys(cat.lingue).sort((a, b) => (a === LINGUA ? -1 : b === LINGUA ? 1 : 0));
+  const lingue = Object.keys(cat.lingue)
+    .filter((l) => !soloLingue || soloLingue.includes(l))
+    .sort((a, b) => (a === LINGUA ? -1 : b === LINGUA ? 1 : 0));
+  if (!lingue.length) return null;
   el.classList.add("scelta-voce");
   el.innerHTML = `
     <h3>${t("La voce del commento")}</h3>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@noeva/analytics-core",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "Gli strumenti di un progetto NOEVA Analytics nel suo repository: moduli di pagina, snapshot, verifica dello standard e kit dell'agente (ADR 0005).",
   "type": "module",
   "bin": {