@massimo-cassandro/minimo 1.41.3 → 1.41.5

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

@@ -93,45 +93,45 @@ const places = [
   // località
   'Zermatt', 'St. Moritz', 'Grindelwald', 'Cascate del Reno', 'Interlaken', 'Davos', 'Alpi Svizzere',
 
-  'Portogallo', 'Lisbona', 'Oporto', 'Madeira', 'Azzorre', 'Sintra', 'Algarve',
-  'Paesi Bassi', 'Amsterdam', 'Rotterdam', 'L’Aia', 'Utrecht',
-  'Belgio', 'Bruxelles', 'Anversa', 'Bruges',
+  'Albania', 'Tirana',
+  'Armenia', 'Erevan',
   'Austria', 'Vienna', 'Salisburgo', 'Innsbruck', 'Graz', 'Hallstatt',
-  'Polonia', 'Varsavia', 'Cracovia', 'Danzica', 'Breslavia',
-  'Svezia', 'Stoccolma', 'Göteborg', 'Malmö',
-  'Norvegia', 'Oslo', 'Bergen', 'Tromsø', 'Fiordi Norvegesi',
+  'Azerbaigian', 'Baku',
+  'Belgio', 'Bruxelles', 'Anversa', 'Bruges',
+  'Bielorussia', 'Minsk',
+  'Bosnia ed Erzegovina', 'Sarajevo',
+  'Bulgaria', 'Sofia',
+  'Cipro', 'Nicosia',
+  'Croazia', 'Zagabria', 'Spalato', 'Dubrovnik', 'Zara', 'Plitvice Lakes',
   'Danimarca', 'Copenaghen',
+  'Estonia', 'Tallinn',
   'Finlandia', 'Helsinki',
+  'Georgia', 'Tbilisi',
   'Irlanda', 'Dublino', 'Galway',
-  'Repubblica Ceca', 'Praga', 'Brno',
-  'Ungheria', 'Budapest',
-  'Romania', 'Bucarest', 'Transilvania',
-  'Croazia', 'Zagabria', 'Spalato', 'Dubrovnik', 'Zara', 'Plitvice Lakes',
-  'Turchia', 'Ankara', 'Istanbul', 'Smirne', 'Antalya', 'Cappadocia',
-  'Ucraina', 'Kiev', 'Kyiv', 'Odessa', 'Leopoli',
-  'Islanda', 'Reykjavik',
-  'Lussemburgo', 'Liechtenstein', 'Principato di Monaco',
-  'Malta', 'La Valletta',
-  'Cipro', 'Nicosia',
-  'Estonia', 'Tallinn',
+  'Islanda', 'Reykjavik', 'Jökulsárlón',
+  'Kosovo', 'Pristina',
   'Lettonia', 'Riga',
   'Lituania', 'Vilnius',
-  'Bielorussia', 'Minsk',
+  'Lussemburgo', 'Liechtenstein', 'Principato di Monaco',
+  'Macedonia del Nord', 'Skopje',
+  'Malta', 'La Valletta',
   'Moldavia', 'Chisinau',
-  'Serbia', 'Belgrado',
-  'Bosnia ed Erzegovina', 'Sarajevo',
   'Montenegro', 'Podgorica',
-  'Albania', 'Tirana',
-  'Macedonia del Nord', 'Skopje',
-  'Kosovo', 'Pristina',
-  'Slovenia', 'Lubiana', 'Bled',
-  'Slovacchia', 'Bratislava',
-  'Bulgaria', 'Sofia',
-  'San Marino', 'Città del Vaticano', 'Andorra',
+  'Norvegia', 'Oslo', 'Bergen', 'Tromsø', 'Fiordi Norvegesi',
+  'Paesi Bassi', 'Amsterdam', 'Rotterdam', 'L’Aia', 'Utrecht',
+  'Polonia', 'Varsavia', 'Cracovia', 'Danzica', 'Breslavia',
+  'Portogallo', 'Lisbona', 'Oporto', 'Madeira', 'Azzorre', 'Sintra', 'Algarve',
+  'Repubblica Ceca', 'Praga', 'Brno',
+  'Romania', 'Bucarest', 'Transilvania',
   'Russia', 'Mosca', 'San Pietroburgo',
-  'Georgia', 'Tbilisi',
-  'Armenia', 'Erevan',
-  'Azerbaigian', 'Baku',
+  'San Marino', 'Città del Vaticano', 'Andorra',
+  'Serbia', 'Belgrado',
+  'Slovacchia', 'Bratislava',
+  'Slovenia', 'Lubiana', 'Bled',
+  'Svezia', 'Stoccolma', 'Göteborg', 'Malmö',
+  'Turchia', 'Ankara', 'Istanbul', 'Smirne', 'Antalya', 'Cappadocia',
+  'Ucraina', 'Kiev', 'Kyiv', 'Odessa', 'Leopoli',
+  'Ungheria', 'Budapest',
 
 
   // AMERICA DEL NORD
@@ -218,14 +218,14 @@ const places = [
   'Machu Picchu', 'Valle Sacra degli Inca', 'Lago Titicaca', 'Linee di Nazca', 'Vinicunca',
 
   // altri paesi dell'America del Sud
+  'Bolivia', 'La Paz', 'Cochabamba', 'Sucre', 'Salar de Uyuni',
   'Cile', 'Santiago del Cile', 'Valparaíso', 'Isola di Pasqua', 'Torres del Paine', 'Atacama Desert',
   'Colombia', 'Bogotà', 'Medellín', 'Cartagena Old Town',
   'Ecuador', 'Quito', 'Guayaquil', 'Galapagos Islands',
+  'Guyana', 'Suriname',
+  'Paraguay', 'Asunción',
   'Uruguay', 'Montevideo',
-  'Bolivia', 'La Paz', 'Cochabamba', 'Sucre', 'Salar de Uyuni',
   'Venezuela', 'Caracas',
-  'Paraguay', 'Asunción',
-  'Guyana', 'Suriname',
 
 
   // ASIA
@@ -272,39 +272,39 @@ const places = [
   'Piazza Durbar', 'Campo Base dell\'Everest', 'Lago Phewa', 'Parco di Chitwan',
 
   // altri paesi asiatici
-  'Corea del Sud', 'Seoul', 'Busan', 'Jeju Island',
-  'Thailandia', 'Bangkok', 'Phuket', 'Chiang Mai',
-  'Vietnam', 'Hanoi', 'Ho Chi Minh', 'Halong Bay',
-  'Indonesia', 'Giacarta', 'Bali', 'Borobudur',
-  'Filippine', 'Manila',
-  'Malaysia', 'Kuala Lumpur',
-  'Singapour', 'Singapore',
-  'Emirati Arabi Uniti', 'Abu Dhabi', 'Dubai',
+  'Afghanistan', 'Kabul',
   'Arabia Saudita', 'Riad',
-  'Israele', 'Gerusalemme',
-  'Giordania', 'Amman', 'Petra',
-  'Kazakistan', 'Astana',
-  'Uzbekistan', 'Tashkent', 'Samarcanda',
-  'Mongolia', 'Ulan Bator',
-  'Corea del Nord', 'Pyongyang',
-  'Taiwan', 'Taipei',
-  'Cambogia', 'Phnom Penh', 'Angkor Wat',
-  'Laos', 'Vientiane',
-  'Myanmar', 'Bagan',
-  'Sri Lanka', 'Colombo',
+  'Bahrein', 'Yemen',
   'Bangladesh', 'Dacca',
-  'Pakistan', 'Islamabad', 'Karachi',
-  'Afghanistan', 'Kabul',
   'Bhutan', 'Thimphu',
-  'Maldive', 'Maldivian Atolls',
   'Brunei',
+  'Cambogia', 'Phnom Penh', 'Angkor Wat',
+  'Corea del Nord', 'Pyongyang',
+  'Corea del Sud', 'Seoul', 'Busan', 'Jeju Island',
+  'Emirati Arabi Uniti', 'Abu Dhabi', 'Dubai',
+  'Filippine', 'Manila',
+  'Giordania', 'Amman', 'Petra',
+  'Indonesia', 'Giacarta', 'Bali', 'Borobudur',
   'Iran', 'Teheran',
   'Iraq', 'Baghdad',
-  'Siria', 'Damasco',
-  'Libano', 'Beirut',
+  'Israele', 'Gerusalemme',
+  'Kazakistan', 'Astana',
   'Kuwait', 'Qatar', 'Doha',
+  'Laos', 'Vientiane',
+  'Libano', 'Beirut',
+  'Malaysia', 'Kuala Lumpur',
+  'Maldive', 'Maldivian Atolls',
+  'Mongolia', 'Ulan Bator',
+  'Myanmar', 'Bagan',
   'Oman', 'Mascate',
-  'Bahrein', 'Yemen',
+  'Pakistan', 'Islamabad', 'Karachi',
+  'Singapour', 'Singapore',
+  'Siria', 'Damasco',
+  'Sri Lanka', 'Colombo',
+  'Taiwan', 'Taipei',
+  'Thailandia', 'Bangkok', 'Phuket', 'Chiang Mai',
+  'Uzbekistan', 'Tashkent', 'Samarcanda',
+  'Vietnam', 'Hanoi', 'Ho Chi Minh', 'Halong Bay',
 
 
   // AFRICA
@@ -341,34 +341,34 @@ const places = [
   'Parco Nazionale Kruger', 'Capo di Buona Speranza', 'Garden Route', 'Robben Island',
 
   // altri paesi africani
-  'Marocco', 'Rabat', 'Marrakech', 'Casablanca', 'Fes', 'Tangeri', 'Chefchaouen',
-  'Tunisia', 'Tunisi',
+  'Algeria', 'Algeri',
+  'Angola', 'Luanda',
+  'Botswana', 'Gaborone', 'Okavango Delta',
+  'Burkina Faso', 'Sierra Leone', 'Liberia', 'Guinea', 'Gibuti',
+  'Capo Verde',
+  'Congo', 'Kinshasa',
+  'Costa d’Avorio', 'Camerun',
+  'Eritrea', 'Asmara',
+  'Etiopia', 'Addis Abeba',
+  'Gambia', 'Niger', 'Ciad', 'Mauritania', 'Malawi', 'Lesotho', 'Eswatini', 'Gabon', 'Togo', 'Benin',
+  'Ghana', 'Accra',
   'Kenya', 'Nairobi',
-  'Senegal', 'Dakar',
+  'Libia', 'Tripoli',
   'Madagascar', 'Antananarivo',
+  'Marocco', 'Rabat', 'Marrakech', 'Casablanca', 'Fes', 'Tangeri', 'Chefchaouen',
   'Mauritius', 'Port Louis', 'Le Morne Brabant',
-  'Etiopia', 'Addis Abeba',
-  'Algeria', 'Algeri',
-  'Libia', 'Tripoli',
-  'Nigeria', 'Abuja', 'Lagos',
-  'Ghana', 'Accra',
-  'Costa d’Avorio', 'Camerun',
-  'Uganda', 'Kampala',
-  'Ruanda', 'Kigali',
   'Mozambico', 'Maputo',
-  'Zimbabwe', 'Harare', 'Victoria Falls',
-  'Zambia', 'Lusaka',
   'Namibia', 'Windhoek',
-  'Botswana', 'Gaborone', 'Okavango Delta',
-  'Angola', 'Luanda',
-  'Sudan', 'Khartum',
+  'Nigeria', 'Abuja', 'Lagos',
+  'Ruanda', 'Kigali',
+  'Senegal', 'Dakar',
   'Seychelles', 'Praslin Island',
-  'Capo Verde',
-  'Congo', 'Kinshasa',
   'Somalia', 'Mogadiscio',
-  'Eritrea', 'Asmara',
-  'Gambia', 'Niger', 'Ciad', 'Mauritania', 'Malawi', 'Lesotho', 'Eswatini', 'Gabon', 'Togo', 'Benin',
-  'Burkina Faso', 'Sierra Leone', 'Liberia', 'Guinea', 'Gibuti',
+  'Sudan', 'Khartum',
+  'Tunisia', 'Tunisi',
+  'Uganda', 'Kampala',
+  'Zambia', 'Lusaka',
+  'Zimbabwe', 'Harare', 'Victoria Falls',
 
 
   // OCEANIA
@@ -398,38 +398,38 @@ const places = [
 
   // altri paesi dell'Oceania
   'Fiji', 'Suva',
-  'Polinesia Francese', 'Papeete', 'Tahiti', 'Bora Bora',
   'Papua Nuova Guinea', 'Port Moresby',
+  'Polinesia Francese', 'Papeete', 'Tahiti', 'Bora Bora',
   'Samoa', 'Tonga', 'Vanuatu', 'Nuova Caledonia', 'Isole Cook', 'Isole Salomone',
 
 
   // --------------------
-  // 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',
   'Mar Mediterraneo', 'Mediterraneo', 'Mar Adriatico', 'Mar Tirreno', 'Mar Ionio', 'Mar Ligure',
   'Mar Nero', 'Mar Baltico', 'Mare del Nord', 'Mar Rosso', 'Mar Morto', 'Mar dei Caraibi', 'Caraibi',
   'Oceano Atlantico', 'Oceano Pacifico', 'Oceano Indiano',
-  'Artide', 'Polo Nord', 'Antartide', 'Polo Sud',
-  'Groenlandia', 'Lapponia', 'Siberia',
   'Sahara', 'Kalahari', 'Namib',
-  'Ande', 'Amazzonia', 'Terra del Fuoco'
 ];
 
 
 /**
- * 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}
  */

package/src/utilities/cookies.js

@@ -2,10 +2,10 @@
 /*! minimo - Cookies */
 
 /**
- * Returns the value of a cookie by name.
+ * Restituisce il valore di un cookie dal nome.
  * @param {string} name
  * @param {object} [options]
- * @param {boolean} [options.parseJson=false] - If true, JSON-parses the value and returns an object instead of a string. (default: false)
+ * @param {boolean} [options.parseJson=false] - Se true, esegue il parsing JSON del valore e restituisce un oggetto invece di una stringa (default: false)
  * @returns {string | object | null}
  */
 export function getCookie(name, {parseJson = false} = {}) {
@@ -21,19 +21,19 @@ export function getCookie(name, {parseJson = false} = {}) {
 
 
 /**
- * Sets a cookie.
+ * Imposta un cookie.
  * @param {object} params
  * @param {string} params.name
  * @param {string} params.value
  * @param {string|null} [params.path=null] (default: null)
- * @param {number|null} [params.expire=null] - Max-Age in seconds (default: null)
+ * @param {number|null} [params.expire=null] - Max-Age in secondi (default: null)
  * @example
- * // Cookie scoped to the current page only, lasting 15 days
+ * // Cookie limitato alla sola pagina corrente, con durata di 15 giorni
  * setCookie({
  *   name: 'cookieName',
  *   value: 'cookieValue',
  *   path: window.location.pathname,
- *   expire: 15 * 24 * 60 * 60 // 15 days
+ *   expire: 15 * 24 * 60 * 60 // 15 giorni
  * });
  */
 export function setCookie({name, value, path = null, expire = null}) {

package/src/utilities/create-id.js

@@ -2,8 +2,8 @@
 import { stripTags } from './strip-tags.js';
 
 /**
- * Creates an id from a string (useful for generating automatic anchors from tag content).
- * Strips HTML tags, normalizes accented characters, punctuation, and whitespace.
+ * Crea un id a partire da una stringa (utile per generare ancore automatiche dal contenuto di un tag).
+ * Rimuove i tag HTML e normalizza caratteri accentati, punteggiatura e spazi.
  * @param {string | null | undefined} str
  * @returns {string}
  */
@@ -12,7 +12,7 @@ export function createId(str) {
     .toLowerCase()
     .normalize('NFD')
     .replace(/[\u0300-\u036f]/g, '')
-    .replace(/[\p{P}\p{S}]+/gu, '') // strips all Unicode punctuation and symbols
+    .replace(/[\p{P}\p{S}]+/gu, '') // rimuove tutta la punteggiatura e i simboli Unicode
     .replace(/\s+/g, '-')
     .replace(/^-+|-+$/g, '')
     .replace(/-+/g, '-')

package/src/utilities/disable-btns-on-submit.js

@@ -1,8 +1,8 @@
 /*! minimo - Disable Buttons On Submit */
 /**
- * Disables all `[type=submit]` and `[type=button]` buttons on form submit.
+ * Disabilita tutti i pulsanti `[type=submit]` e `[type=button]` al submit del form.
  *
- * Applies to all `<form>` elements in the document except those with
+ * Si applica a tutti gli elementi `<form>` del documento, tranne quelli con
  * `data-disable-submit="false"`.
  *
  * @returns {void}