@massimo-cassandro/minimo 1.41.4 → 1.41.6

package/src/components/unsplash-page/fetch-unsplash-data.js

@@ -16,7 +16,7 @@
  */
 
 /**
- * Fetches and normalises Unsplash photo data from the given URL.
+ * Recupera e normalizza i dati di una foto Unsplash dall'URL indicato.
  * @param {{ unsplash_data_url: string | null }} settings
  * @returns {Promise<UnsplashPhoto | undefined>}
  */
@@ -34,7 +34,7 @@ export async function fetchUnsplashData(settings) {
       throw new Error( 'Unsplash data url must be defined' );
     }
 
-    const url = settings.unsplash_data_url; // const preserves narrowing inside the IIFE closure
+    const url = settings.unsplash_data_url; // const mantiene il narrowing dentro la closure dell'IIFE
 
     const imgData = await (async () => {
       const response = await fetch(url);
@@ -52,7 +52,7 @@ export async function fetchUnsplashData(settings) {
 
         // console.log(data);
 
-        // used data
+        // dati utilizzati
         return {
           id                 : data.id,
           color              : data.color,

package/src/components/unsplash-page/unsplash-page.js

@@ -9,21 +9,21 @@ import { decode } from 'blurhash';
 import * as styles from './unsplash-page.module.css';
 
 /**
- * Initialises an Unsplash full-page photo with blurhash placeholder, responsive picture element,
- * and attribution overlay.
+ * Inizializza una foto Unsplash a pagina intera con placeholder blurhash, elemento picture responsive
+ * e overlay di attribuzione.
  * @param {Object} settings
- * @param {HTMLElement | null} settings.targetElement - Container element where the photo will be rendered.
- * @param {string | null} [settings.className=null] - Extra class added to the container. (default: null)
- * @param {string | null} settings.unsplashDataUrl - URL returning Unsplash photo JSON.
- * @param {string | null} settings.utmSource - UTM source value for attribution links.
- * @param {string | null} settings.title - Main heading text.
- * @param {string | null} [settings.text=null] - Optional body text. (default: null)
- * @param {string | null} [settings.backLink=null] - Optional back-link HTML. (default: null)
- * @param {boolean} [settings.hidePhotoLink=true] - When true, the Unsplash link is shown only on hover. (default: true)
+ * @param {HTMLElement | null} settings.targetElement - Elemento contenitore in cui verrà renderizzata la foto.
+ * @param {string | null} [settings.className=null] - Classe extra aggiunta al contenitore (default: null)
+ * @param {string | null} settings.unsplashDataUrl - URL che restituisce il JSON della foto Unsplash.
+ * @param {string | null} settings.utmSource - Valore utm_source per i link di attribuzione.
+ * @param {string | null} settings.title - Testo del titolo principale.
+ * @param {string | null} [settings.text=null] - Testo opzionale del corpo (default: null)
+ * @param {string | null} [settings.backLink=null] - HTML opzionale del link di ritorno (default: null)
+ * @param {boolean} [settings.hidePhotoLink=true] - Se true, il link a Unsplash viene mostrato solo al passaggio del mouse (default: true)
  * @returns {Promise<void>}
  */
 
-// TODO add icon file customization and more custom props for message box
+// TODO aggiungere la personalizzazione del file dell'icona e altre custom props per il box del messaggio
 
 export async function unsplashPage(settings) {
 
@@ -87,23 +87,23 @@ export async function unsplashPage(settings) {
 
     container.insertAdjacentElement('afterbegin', canvas);
 
-    const formats = ['avif', 'webp', 'pjpg']; // `fm` parameter, in order of use
+    const formats = ['avif', 'webp', 'pjpg']; // parametro `fm`, in ordine di utilizzo
 
     /*
-      - image dimensions grouped by aspect ratio: each group becomes one <source> tag
-        per format (avif/webp/pjpg)
-      - each aspect ratio is expressed as [w, h] (e.g. [16, 9]); `widths` lists the target
-        render widths for that group, used both as the `w` imgix param and as the `Nw`
-        descriptor in `srcset`. Height is derived per width from the group's ratio and
-        passed to imgix as `h` (see buildImgixUrl), so groups can safely reuse the same
-        `widths` list (e.g. 9/16 and 9/20) while still requesting a different crop height
-      - orientation and the aspect-ratio media feature are derived from the ratio itself:
+      - dimensioni dell'immagine raggruppate per aspect ratio: ogni gruppo diventa un tag <source>
+        per formato (avif/webp/pjpg)
+      - ogni aspect ratio è espresso come [w, h] (es. [16, 9]); `widths` elenca le larghezze
+        di rendering di destinazione per quel gruppo, usate sia come parametro imgix `w` sia come
+        descrittore `Nw` in `srcset`. L'altezza è derivata per ogni larghezza dal ratio del gruppo e
+        passata a imgix come `h` (vedi buildImgixUrl), quindi i gruppi possono riutilizzare senza problemi lo stesso
+        elenco `widths` (es. 9/16 e 9/20) richiedendo comunque un'altezza di crop diversa
+      - l'orientamento e la media feature aspect-ratio sono derivati dal ratio stesso:
         ratio >= 1 -> landscape + min-aspect-ratio, ratio < 1 -> portrait + max-aspect-ratio
-      - NB: order matters. <picture> uses "first matching <source> wins" (unlike the CSS
-        cascade, where the last matching rule wins), so groups must be ordered from most to
-        least restrictive: landscape groups from the widest ratio to the narrowest, portrait
-        groups from the narrowest ratio to the widest. Orientation makes the two families
-        mutually exclusive, so their relative order doesn't matter
+      - NB: l'ordine conta. <picture> usa "vince il primo <source> che corrisponde" (a differenza della
+        cascata CSS, dove vince l'ultima regola corrispondente), quindi i gruppi devono essere ordinati dal più al
+        meno restrittivo: i gruppi landscape dal ratio più largo al più stretto, i gruppi portrait
+        dal ratio più stretto al più largo. L'orientamento rende le due famiglie
+        mutuamente esclusive, quindi il loro ordine relativo non conta
       */
     const sizes = [
       // landscape 16/9
@@ -126,23 +126,23 @@ export async function unsplashPage(settings) {
         ar: [9,16],
         widths: [1080, 960, 768, 570, 400]
       },
-      // portrait 3/4 (tablets)
+      // portrait 3/4 (tablet)
       {
         ar: [3,4],
         widths: [1200, 1024, 840]
       }
     ];
 
-    // `url`/`searchParams` and the static imgix params (fit/crop/q) are set up once here
-    // and reused on every call: `fm`/`w`/`h` are the only parts that change per image, and
-    // the returned string is always consumed synchronously before the next call mutates them
+    // `url`/`searchParams` e i parametri imgix statici (fit/crop/q) vengono impostati una sola volta qui
+    // e riutilizzati a ogni chiamata: `fm`/`w`/`h` sono le uniche parti che cambiano per immagine, e
+    // la stringa restituita viene sempre consumata in modo sincrono prima che la chiamata successiva le modifichi
     /** @type {(w: number, h: number, fmt: string) => string} */
     const buildImgixUrl = (() => {
       const url = new URL(imgData.base_url),
         searchParams = new URLSearchParams(url.search);
 
       searchParams.set('fit', 'crop');
-      searchParams.set('crop', 'faces,entropy,edges'); // top, bottom, left, right, faces, focalpoint, edges, and entropy
+      searchParams.set('crop', 'faces,entropy,edges'); // top, bottom, left, right, faces, focalpoint, edges ed entropy
       searchParams.set('q', '60');
 
       return (w, h, fmt) => {
@@ -155,8 +155,8 @@ export async function unsplashPage(settings) {
       };
     })();
 
-    // smallest width of the widest (most common) group, used as the plain <img> fallback
-    // for browsers without <picture> support: the <source> tags above cover everything else
+    // larghezza minima del gruppo più largo (il più comune), usata come semplice <img> di fallback
+    // per i browser senza supporto a <picture>: i tag <source> qui sopra coprono tutto il resto
     const default_group = sizes[0],
       default_w = default_group.widths[default_group.widths.length - 1],
       default_h = Math.round(default_w * default_group.ar[1] / default_group.ar[0]);
@@ -199,7 +199,7 @@ export async function unsplashPage(settings) {
             });
           }),
 
-          // =>> img and its listener
+          // =>> img e il suo listener
           {
             tag: 'img',
             className: styles.unsplashPhoto,

package/src/components/unsplash-page/unsplash-page.module.css

@@ -1,7 +1,7 @@
 /*! minimo - Unsplash Page */
 /*
 
-custom propeties:
+custom properties:
 
 --uspg-bg-color: hsl(0deg 0% 0% / .7);
 --uspg-credits-font-size: var(--font-size-xs);

package/src/css/alerts.css

@@ -1,9 +1,9 @@
-/* default altert (danger) */
+/* alert di default (danger) */
 
 .alert {
 
   /*
-  symfony message labels:
+  etichette dei messaggi di symfony:
   - success
   - notice
   - error

package/src/css/forms/forms.css

@@ -8,7 +8,7 @@
 
 .form-group:has([required]):not(:has([disabled])) {
 
-  /* `>` excludes labels within form-collections  */
+  /* `>` esclude le label all'interno delle form-collection  */
   > .form-label {
     position: relative;
     padding-inline-start: var(--form-control-required-label-padding-inline-start);
@@ -24,7 +24,7 @@
   }
 }
 
-/* single checkboxes and radios are vertically centered */
+/* le singole checkbox e radio sono centrate verticalmente */
 .form-group:not(.form-collection-fset):has(.form-check:not(.form-check-top-label)) {
   align-self: center;
   .form-check {
@@ -40,8 +40,8 @@
 }
 
 /*
-with implicit label, without id and for.
-Example:
+con label implicita, senza id e for.
+Esempio:
 
 <div class="form-group">
   <label>

package/src/css/forms/validation.css

@@ -1,7 +1,7 @@
 /* da BS5 */
 .was-validated {
 
-  /* includes static field which container has is-valid / is-invalid class */
+  /* include il campo statico il cui contenitore ha la classe is-valid / is-invalid */
   .form-group:has(:valid), .form-group:has(.is-valid), .form-group.is-valid .form-control-static{
     --_status-color: var(--status-success-color);
   }

package/src/css/margin-padding-media.css

@@ -1,10 +1,10 @@
 /* stylelint-disable selector-class-pattern */
 
-/* AUTO-GENERATED FILE — do not edit by hand.
-   Generated by `node scripts/build-margin-padding-css.mjs`.
-   Edit the `sizes` / `classes` / `media` maps there instead.
+/* FILE GENERATO AUTOMATICAMENTE — non modificare a mano.
+   Generato da `node scripts/build-margin-padding-css.mjs`.
+   Modificare invece le mappe `sizes` / `classes` / `media` dello script.
 
-   Responsive companion of `margin-padding.css`, one @media block per breakpoint. */
+   Controparte responsive di `margin-padding.css`, un blocco @media per breakpoint. */
 
 
 @media (--media-xlarge-viewport-up) {

package/src/css/margin-padding.css

@@ -1,10 +1,10 @@
 /* stylelint-disable selector-class-pattern */
 
-/* AUTO-GENERATED FILE — do not edit by hand.
-   Generated by `node scripts/build-margin-padding-css.mjs`.
-   Edit the `sizes` / `classes` / `media` maps there instead.
+/* FILE GENERATO AUTOMATICAMENTE — non modificare a mano.
+   Generato da `node scripts/build-margin-padding-css.mjs`.
+   Modificare invece le mappe `sizes` / `classes` / `media` dello script.
 
-   Responsive variants live in `margin-padding-media.css`. */
+   Le varianti responsive sono in `margin-padding-media.css`. */
 
 
 .m-0 {

package/src/css/reset.css

@@ -1,19 +1,19 @@
 /*
-Josh's Custom CSS Reset
+Reset CSS personalizzato di Josh
 https://www.joshwcomeau.com/css/custom-css-reset/
 */
-/* 1. Use a more-intuitive box-sizing model */
+/* 1. Usa un modello di box-sizing più intuitivo */
 
 *, *::before, *::after {
   box-sizing: border-box;
 }
 
-/* 2. Remove default margin */
+/* 2. Rimuove il margin predefinito */
 * {
   margin: 0;
 }
 
-/* 3. Enable keyword animations */
+/* 3. Abilita le animazioni con keyword */
 @media (prefers-reduced-motion: no-preference) {
   html {
     interpolate-size: allow-keywords;
@@ -21,29 +21,29 @@ https://www.joshwcomeau.com/css/custom-css-reset/
 }
 
 body {
-  /* 4. Add accessible line-height */
+  /* 4. Aggiunge un line-height accessibile */
   line-height: 1.5;
-  /* 5. Improve text rendering */
+  /* 5. Migliora il rendering del testo */
   -webkit-font-smoothing: antialiased;
 }
 
-/* 6. Improve media defaults */
+/* 6. Migliora i default dei media */
 img, picture, video, canvas, svg {
   display: block;
   max-width: 100%;
 }
 
-/* 7. Inherit fonts for form controls */
+/* 7. Eredita i font per i controlli dei form */
 input, button, textarea, select {
   font: inherit;
 }
 
-/* 8. Avoid text overflows */
+/* 8. Evita l'overflow del testo */
 p, h1, h2, h3, h4, h5, h6 {
   overflow-wrap: break-word;
 }
 
-/* 9. Improve line wrapping */
+/* 9. Migliora l'a capo del testo */
 p {
   text-wrap: pretty;
 }
@@ -52,7 +52,7 @@ h1, h2, h3, h4, h5, h6 {
 }
 
 /*
-  10. Create a root stacking context
+  10. Crea uno stacking context alla radice
 */
 /* stylelint-disable-next-line selector-id-pattern, selector-max-id */
 #root, #__next {

package/src/icons/read-me.md

@@ -1 +1 @@
-Quite most icons from <https://phosphoricons.com/>
+Quasi tutte le icone provengono da <https://phosphoricons.com/>

package/src/minimo.css

@@ -1,4 +1,4 @@
-/* decomment if you want to use layers. see https://developer.mozilla.org/en-US/docs/Web/CSS/Reference/At-rules/@layer */
+/* decommentare per usare i layer. Vedi https://developer.mozilla.org/en-US/docs/Web/CSS/Reference/At-rules/@layer */
 /* @layer reset, base, components, utilities, project, overrides; */
 
 @import '@minimoSrc/css/reset.css';
@@ -36,13 +36,13 @@
 @import '@minimoSrc/css/sizes.css';
 @import '@minimoSrc/css/display.css';
 @import '@minimoSrc/css/margin-padding.css';
-/* @import '@minimoSrc/css/margin-padding-media.css';  responsive version */
+/* @import '@minimoSrc/css/margin-padding-media.css';  versione responsive */
 
 @import '@minimoSrc/css/overflow.css';
 @import '@minimoSrc/css/position.css';
 @import '@minimoSrc/css/visibility.css';
 
 
-/* spinner: include the css of the choosen spinner only */
+/* spinner: includere solo il css dello spinner scelto */
 @import '@minimoSrc/components/spinner/spinner-circle-basic.css';
 

package/src/utilities/better-text-with-places.js

@@ -404,7 +404,7 @@ const places = [
 
 
   // --------------------
-  // places not tied to a single country (seas, oceans, regions, polar areas)
+  // luoghi non legati a un singolo paese (mari, oceani, regioni, aree polari)
   'Ande', 'Amazzonia', 'Terra del Fuoco',
   'Artide', 'Polo Nord', 'Antartide', 'Polo Sud',
   'Groenlandia', 'Lapponia', 'Siberia',
@@ -416,20 +416,20 @@ const places = [
 
 
 /**
- * Key used to match a place regardless of case, spacing and apostrophe style
+ * Chiave usata per far corrispondere un luogo indipendentemente da maiuscole/minuscole, spaziatura e stile dell'apostrofo
  * @param {string} str
  * @returns {string}
  */
 const placeKey = str => str.toLowerCase().replace(/[ \u00A0]+/g, ' ').replace(/['‘’]/g, '’');
 
 /**
- * Builds the matcher for a list of places: a single regex (longest places first, so that
- * e.g. "Lago di Como" wins over a shorter overlapping name) and a key → canonical form map.
- * The canonical form uses the typographic apostrophe and non-breaking spaces after particles,
- * consistently with betterText().
+ * Costruisce il matcher per un elenco di luoghi: una singola regex (prima i luoghi più lunghi, così che
+ * ad es. "Lago di Como" prevalga su un nome più corto sovrapposto) e una mappa chiave → forma canonica.
+ * La forma canonica usa l'apostrofo tipografico e gli spazi non separabili dopo le particelle,
+ * in modo coerente con betterText().
  *
- * @param {string[]} list - places list
- * @returns {{regex: RegExp, canonical: Map<string, string>} | null} null if the list is empty
+ * @param {string[]} list - elenco dei luoghi
+ * @returns {{regex: RegExp, canonical: Map<string, string>} | null} null se l'elenco è vuoto
  */
 function buildPlacesMatcher(list) {
   const canonical = new Map();
@@ -459,7 +459,7 @@ function buildPlacesMatcher(list) {
     );
 
   return {
-    // custom boundaries instead of \b, which doesn't work with accented edge letters (e.g. "Perù")
+    // delimitatori personalizzati al posto di \b, che non funziona con lettere accentate ai bordi (es. "Perù")
     regex: new RegExp(`(?<![\\p{L}\\p{N}])(?:${patterns.join('|')})(?![\\p{L}\\p{N}])`, 'giu'),
     canonical
   };
@@ -468,21 +468,21 @@ function buildPlacesMatcher(list) {
 const defaultMatcher = buildPlacesMatcher(places);
 
 /**
- * Version of betterText() that also normalizes the occurrences of known places
- * (countries, cities, rivers, mountains, tourist locations) found in the text:
- * matching is case-insensitive and tolerant to spacing and apostrophe style, and every
- * match is replaced by the canonical form listed in `places` (casing, typographic
- * apostrophe, non-breaking spaces after particles).
- * Places replacement runs after betterText(), so it takes precedence over the casing
- * enforced on particles and custom words.
+ * Versione di betterText() che normalizza anche le occorrenze di luoghi noti
+ * (paesi, città, fiumi, monti, località turistiche) presenti nel testo:
+ * il confronto non distingue maiuscole/minuscole ed è tollerante su spaziatura e stile
+ * dell'apostrofo, e ogni corrispondenza viene sostituita dalla forma canonica elencata in `places`
+ * (capitalizzazione, apostrofo tipografico, spazi non separabili dopo le particelle).
+ * La sostituzione dei luoghi viene eseguita dopo betterText(), quindi ha la precedenza sulla
+ * capitalizzazione imposta a particelle e parole personalizzate.
  *
- * NOTE: places that are also common words (e.g. "Meno", "Po", "Reno") are capitalized
- * wherever they appear.
+ * NOTA: i luoghi che sono anche parole comuni (es. "Meno", "Po", "Reno") vengono messi in maiuscolo
+ * ovunque compaiano.
  *
- * @param {string} str - input string to process
- * @param {string[]} [custom_words] - list of words whose exact casing must be preserved (e.g. `['iPhone', 'macOS']`) (default: [])
- * @param {string[]} [extra_places] - additional places, merged with the built-in list (default: [])
- * @returns {string} processed string, or empty string if input is falsy
+ * @param {string} str - stringa da elaborare
+ * @param {string[]} [custom_words] - elenco di parole di cui va mantenuta la capitalizzazione esatta (es. `['iPhone', 'macOS']`) (default: [])
+ * @param {string[]} [extra_places] - luoghi aggiuntivi, uniti all'elenco predefinito (default: [])
+ * @returns {string} stringa elaborata, oppure stringa vuota se l'input è falsy
  *
  * @example
  * betterTextWithPlaces("vacanza a  new york e  nel lago di como ,l'avana");

package/src/utilities/better-text.js

@@ -2,10 +2,13 @@
 /*! minimo - Better Text */
 
 
-// Italian particles/articles (plus a few English and topographic terms) whose casing is
-// enforced and after which spaces are turned into non-breaking spaces. Hoisted to module
-// scope with the regexes/lookup built from it below, since none of this depends on the
-// function's arguments and was previously rebuilt on every single betterText() call.
+/*
+  Particelle/articoli italiani (più alcuni termini inglesi e toponomastici) di cui viene
+  imposta la capitalizzazione e dopo i quali gli spazi vengono trasformati in spazi non
+  separabili. Portati a livello di modulo insieme alle regex/lookup costruite qui sotto, dato
+  che nulla di tutto ciò dipende dagli argomenti della funzione e in precedenza veniva
+  ricostruito a ogni singola chiamata di betterText().
+*/
 const PARTICELLE = [
   'e', 'ed',
   'di', 'a', 'da', 'in', 'per', 'con', 'su', 'per', 'tra', 'fra',
@@ -18,72 +21,76 @@ const PARTICELLE = [
   'col', 'collo', 'colla', 'con', 'coi', 'cogli', 'colle',
   'sul', 'sullo', 'sulla', 'sui', 'sugli', 'sulle',
 
-  // topographic terms
+  // termini toponomastici
   'C.so', 'Corso', 'Via', 'P.za', 'Piazza', 'L.go', 'Largo', 'V.le', 'Viale',
   'De', 'San', 'c/o', 'Loc.',
 
-  // English
+  // inglese
   'the', 'a', 'an', 'at', 'out', 'of',
 
-  // words used in geonames
+  // parole usate nei geonames
   'isola', 'isole'
 ];
 
-// matches a particle followed by one-or-more spaces, to be turned into non-breaking spaces
+// corrisponde a una particella seguita da uno o più spazi, da trasformare in spazi non separabili
 export const NBSP_AFTER_PARTICLE_REGEX =new RegExp('\\b(' + PARTICELLE.join('|') + ')\\b +', 'gmi');
 
-// matches any particle regardless of case, to enforce its exact casing in a single pass
+// corrisponde a qualsiasi particella indipendentemente dal maiuscolo/minuscolo, per imporne la capitalizzazione esatta in un solo passaggio
 const PARTICLE_CASING_REGEX = new RegExp('\\b(' + PARTICELLE.join('|') + ')\\b', 'gmi');
 
-// lowercased particle → its exact casing, for the replacer used with PARTICLE_CASING_REGEX
+// particella in minuscolo → sua capitalizzazione esatta, per il replacer usato con PARTICLE_CASING_REGEX
 const PARTICLE_CASING_MAP = new Map(PARTICELLE.map(term => [term.toLowerCase(), term]));
 
 /**
- * Improves a text string by fixing punctuation spacing, multiple spaces,
- * typographic quotes, non-breaking spaces after Italian particles/articles,
- * and optionally enforcing the exact casing of custom words.
- * Particles are forced to their listed casing, except at the start of the text
- * where their first letter is capitalized.
+ * Migliora una stringa di testo correggendo la spaziatura della punteggiatura, gli spazi
+ * multipli, le virgolette tipografiche, gli spazi non separabili dopo le particelle/articoli
+ * italiani e, opzionalmente, imponendo la capitalizzazione esatta di parole personalizzate.
+ * Le particelle vengono forzate alla capitalizzazione elencata, tranne all'inizio del testo
+ * dove la prima lettera è maiuscola.
  *
- * @param {string} str - input string to process
- * @param {string[]} [custom_words] - list of words whose exact casing must be preserved (e.g. `['iPhone', 'macOS']`) (default: [])
- * @returns {string} processed string, or empty string if input is falsy
+ * @param {string} str - stringa da elaborare
+ * @param {string[]} [custom_words] - elenco di parole di cui va mantenuta la capitalizzazione esatta (es. `['iPhone', 'macOS']`) (default: [])
+ * @returns {string} stringa elaborata, oppure stringa vuota se l'input è falsy
  */
 export function betterText(str, custom_words = []) {
 
   if(str) {
     str = str.trim();
 
-    // punctuation: remove space before, ensure single space after
-    // NOTE: must run before any HTML entity replacements to avoid conflicts with `;`
-    // (?!$): negative lookahead to skip punctuation at end of string
+    /*
+      punteggiatura: rimuove lo spazio prima, garantisce un solo spazio dopo
+      NOTA: deve essere eseguito prima di qualsiasi sostituzione di entità HTML per evitare conflitti con `;`
+      (?!$): negative lookahead per saltare la punteggiatura a fine stringa
+    */
     str = str.replace(/ +(,|;|\.|:|!|\?)/g, '$1');
     str = str.replace(/(,|;|\.|:|!|\?)(?!$) +/g, '$1 ');
 
-    // add the missing space after , ; ! ? when directly followed by a letter or a quote;
-    // digits are skipped on purpose (decimals like 1,5), as are . and : (abbreviations, times, URLs)
+    /*
+      aggiunge lo spazio mancante dopo , ; ! ? quando seguiti direttamente da una lettera o da una virgoletta;
+      le cifre vengono saltate di proposito (decimali come 1,5), così come . e : (abbreviazioni, orari, URL)
+    */
     str = str.replace(/([,;!?])(?=[\p{L}"'“‘])/gu, '$1 ');
 
-    // collapse multiple spaces and tabs (including non-breaking spaces)
+    // comprime spazi e tabulazioni multipli (inclusi gli spazi non separabili)
     str = str.replace(/[ \t\u00A0]+/g, ' ');
 
-    // typographic quotes
-    str = str.replace(/(^| )"/g, '$1“')   // opening double quotes
-      .replace(/"/g, '”')                  // remaining double quotes → closing
-      .replace(/(^| )'/g, '$1‘')           // opening single quotes
-      .replace(/'/g, '’')                  // remaining single quotes and apostrophes
+    // virgolette tipografiche
+    str = str.replace(/(^| )"/g, '$1“')   // virgolette doppie di apertura
+      .replace(/"/g, '”')                  // virgolette doppie rimanenti → chiusura
+      .replace(/(^| )'/g, '$1‘')           // virgolette singole di apertura
+      .replace(/'/g, '’')                  // virgolette singole rimanenti e apostrofi
     ;
 
-    // remove space after apostrophe preceded by elided articles (l', un', d', all', ...)
+    // rimuove lo spazio dopo l'apostrofo preceduto da articoli elisi (l', un', d', all', ...)
     str = str.replace(/((^| )(l|un|d|all|dell|nell|sull)('|')) /gi, '$1' );
 
-    // replace regular spaces with non-breaking spaces after Italian particles/articles
+    // sostituisce gli spazi normali con spazi non separabili dopo le particelle/articoli italiani
     str = str.replace(NBSP_AFTER_PARTICLE_REGEX, function (match) {
       return match.replace(/ +/g, '\u00A0');
     });
 
-    // enforce exact casing of every particle in a single pass;
-    // a particle at the very start of the text (optionally after an opening quote) is capitalized
+    // impone la capitalizzazione esatta di ogni particella in un solo passaggio;
+    // una particella all'inizio del testo (eventualmente dopo una virgoletta di apertura) viene messa in maiuscolo
     str = str.replace(PARTICLE_CASING_REGEX, (match, _p1, offset, whole) => {
       const exact = PARTICLE_CASING_MAP.get(match.toLowerCase()) ?? match;
       return /^[“‘]?$/.test(whole.slice(0, offset))
@@ -91,8 +98,8 @@ export function betterText(str, custom_words = []) {
         : exact;
     });
 
-    // capitalize the first letter after ! ? and ellipsis (... or …), optionally after an opening quote;
-    // runs after the particle casing so that a capital is not undone for particles like "e" or "di"
+    // mette in maiuscolo la prima lettera dopo ! ? e i puntini di sospensione (... o …), eventualmente dopo una virgoletta di apertura;
+    // viene eseguito dopo la capitalizzazione delle particelle così che una maiuscola non venga annullata per particelle come "e" o "di"
     str = str.replace(/([!?]|\.{3}|…) +([“‘]?)(\p{Ll})/gu, (_match, punct, quote, letter) =>
       `${punct} ${quote}${letter.toUpperCase()}`
     );

package/src/utilities/classnames.js

@@ -1,19 +1,19 @@
 /*! minimo - Classnames */
 
 /**
- * `MinimoClass | any other string`: keeps editor autocomplete for minimo's
- * own class names (see ../../types/classes.d.ts, auto-generated) while still
- * accepting arbitrary consumer-defined class names. The `string & {}` branding
- * is a TS trick that prevents the union from collapsing to plain `string`,
- * which would silently disable the autocomplete.
+ * `MinimoClass | qualsiasi altra stringa`: mantiene l'autocomplete dell'editor per i nomi
+ * di classe di minimo (vedi ../../types/classes.d.ts, generato automaticamente) pur
+ * accettando nomi di classe arbitrari definiti dal consumer. Il branding `string & {}`
+ * è un trucco TS che impedisce all'union di ridursi a semplice `string`,
+ * cosa che disattiverebbe in silenzio l'autocomplete.
  * @typedef {import('../../types/classes.js').MinimoClass | (string & {})} ClassName
  */
 
 /** @typedef {ClassName | null | undefined | false | 0} ClassValue */
 
 /**
- * Joins CSS class names, filtering out falsy and non-string values.
- * Accepts strings, falsy values, and (nested) arrays of the same.
+ * Unisce i nomi di classe CSS, scartando i valori falsy e non stringa.
+ * Accetta stringhe, valori falsy e array (anche annidati) degli stessi.
  * @param {...(ClassValue | ClassValue[])} args
  * @returns {string}
  */
@@ -29,7 +29,7 @@ export function classnames(...args) {
 }
 
 /**
- * Like {@link classnames}, but returns `null` when the result is an empty string.
+ * Come {@link classnames}, ma restituisce `null` quando il risultato è una stringa vuota.
  * @param {...(ClassValue | ClassValue[])} args
  * @returns {string | null}
  */