@massimo-cassandro/minimo 1.43.3 → 1.44.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@massimo-cassandro/minimo",
-  "version": "1.43.3",
+  "version": "1.44.0",
   "description": "Light css framework & utilities",
   "type": "module",
   "main": "./src/index.js",

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

@@ -1,7 +1,7 @@
 // @ts-check
 /*! minimo - Better Text with places */
 
-import { betterText, NBSP_AFTER_PARTICLE_REGEX } from './better-text.js';
+import { betterText, NBSP_AFTER_PARTICLE_REGEX, PARTICELLE } from './better-text.js';
 
 const places = [
   // EUROPA
@@ -467,6 +467,19 @@ function buildPlacesMatcher(list) {
 
 const defaultMatcher = buildPlacesMatcher(places);
 
+/*
+  Corrisponde agli spazi (normali o non separabili) NON seguiti da una particella:
+  usata con l'opzione `addNbsp` per unire le parole dei nomi composti, lasciando
+  separabile lo spazio prima di una particella (es. "Lago di Como" → spazio normale
+  tra "Lago" e "di", mentre quello tra "di" e "Como" è già gestito da betterText())
+*/
+const SPACE_BEFORE_NON_PARTICLE_REGEX = new RegExp(
+  '[ \\u00A0]+(?!(?:' +
+    PARTICELLE.map(p => p.replace(/[.*+?^${}()|[\]\\/]/g, '\\$&')).join('|') +
+  ')(?![\\p{L}\\p{N}]))',
+  'giu'
+);
+
 /**
  * Versione di betterText() che normalizza anche le occorrenze di luoghi noti
  * (paesi, città, fiumi, monti, località turistiche) presenti nel testo:
@@ -480,18 +493,33 @@ const defaultMatcher = buildPlacesMatcher(places);
  * ovunque compaiano.
  *
  * @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: [])
+ * @param {object} [options] - opzioni (default: {})
+ * @param {string[]} [options.custom_words] - elenco di parole di cui va mantenuta la capitalizzazione esatta (es. `['iPhone', 'macOS']`) (default: [])
+ * @param {string[]} [options.extra_places] - luoghi aggiuntivi, uniti all'elenco predefinito (default: [])
+ * @param {boolean} [options.addNbsp] - se `true`, nei nomi di luogo composti da più parole gli spazi vengono
+ * sostituiti da spazi non separabili, tranne quelli che precedono una particella
+ * (es. in "Monte Bianco" lo spazio diventa non separabile, in "Lago di Como" solo quello dopo "di") (default: false)
  * @returns {string} stringa elaborata, oppure stringa vuota se l'input è falsy
  *
  * @example
  * betterTextWithPlaces("vacanza a  new york e  nel lago di como ,l'avana");
  * // → "vacanza a New York e nel Lago di Como, L’Avana"
  *
- * betterTextWithPlaces('gita a monte cervino', ['iPhone'], ['Monte Cervino']);
+ * betterTextWithPlaces('gita a monte cervino', { custom_words: ['iPhone'], extra_places: ['Monte Cervino'] });
  * // → 'gita a Monte Cervino'
+ *
+ * // opzioni con i valori di default
+ * betterTextWithPlaces('monte bianco e lago di como', {
+ *   custom_words: [],
+ *   extra_places: [],
+ *   addNbsp: false
+ * });
+ * // → 'Monte Bianco e Lago di Como' (spazio non separabile solo dopo "di")
+ *
+ * betterTextWithPlaces('monte bianco e lago di como', { addNbsp: true });
+ * // → 'Monte Bianco e Lago di Como' (spazi non separabili tra "Monte" e "Bianco" e dopo "di")
  */
-export function betterTextWithPlaces(str, custom_words = [], extra_places = []) {
+export function betterTextWithPlaces(str, { custom_words = [], extra_places = [], addNbsp = false } = {}) {
 
   str = betterText(str, custom_words);
 
@@ -503,7 +531,12 @@ export function betterTextWithPlaces(str, custom_words = [], extra_places = [])
     ? buildPlacesMatcher([...places, ...extra_places])
     : defaultMatcher;
 
-  return matcher
-    ? str.replace(matcher.regex, match => matcher.canonical.get(placeKey(match)) ?? match)
-    : str;
+  if (!matcher) {
+    return str;
+  }
+
+  return str.replace(matcher.regex, match => {
+    const place = matcher.canonical.get(placeKey(match)) ?? match;
+    return addNbsp ? place.replace(SPACE_BEFORE_NON_PARTICLE_REGEX, '\u00A0') : place;
+  });
 }

package/src/utilities/better-text.js

@@ -9,7 +9,7 @@
   che nulla di tutto ciò dipende dagli argomenti della funzione e in precedenza veniva
   ricostruito a ogni singola chiamata di betterText().
 */
-const PARTICELLE = [
+export const PARTICELLE = [
   'e', 'ed',
   'di', 'a', 'da', 'in', 'per', 'con', 'su', 'per', 'tra', 'fra',
   'il', 'lo', 'la', 'i', 'gli', 'le',

package/src/utilities/dom-builder-helpers/picture-tag.js

@@ -104,7 +104,7 @@ import { classnames } from '../classnames.js';
  * });
  *
  * @param {Object} args
- * @param {string} args.baseSrc - URL base dell'immagine (endpoint del viewer); i suoi parametri di query vengono conservati. Un URL relativo (es. `/img/abc123`) viene risolto rispetto alla location corrente.
+ * @param {string} args.baseSrc - URL base dell'immagine (endpoint del viewer); i suoi parametri di query vengono conservati. Un URL relativo (es. `/img/abc123`) viene risolto rispetto alla location corrente; se relativo alla root (inizia con `/`, ma non con `//`), resta tale anche negli URL generati.
  * @param {(number | [number, number] | PictureSizeEntry)[]} [args.sizes=[250]] - Dimensioni renderizzate dell'immagine, in qualsiasi ordine. Ogni entry è un oggetto `{from, size}` (vedi {@link PictureSizeEntry}); un numero semplice o una coppia `[width, height]` è la scorciatoia per l'entry predefinita mobile-first (quella senza `from`), attesa esattamente una volta (default: [250])
  * @param {number|null} [args.ratio=null] - Aspect ratio predefinito (larghezza / altezza, come nella proprietà CSS `aspect-ratio`) usato per calcolare l'altezza delle size numeriche. Se null, l'altezza non viene calcolata: gli output legati all'altezza (attributo `height`, altezza nel parametro `bb`) vengono omessi e il viewer mantiene il ratio originale dell'immagine (default: null)
  * @param {number} [args.dpr=2] - Densità di pixel massima (intero): i candidati di `srcset` vengono generati per ogni densità da 1 a `dpr` (default: 2)
@@ -183,6 +183,9 @@ export function buildPictureTag({
   const base_url = new URL(baseSrc, globalThis.location?.href)
     ,searchParams = new URLSearchParams(base_url.search)
 
+    // baseSrc relativo alla root: negli URL generati viene omessa l'origine aggiunta per la risoluzione
+    ,isRootRelative = baseSrc.startsWith('/') && !baseSrc.startsWith('//')
+
     // dimensioni dei candidati srcset (una per ogni densità da 1 a `dpr`),
     // senza duplicati (per larghezza), in ordine crescente
     ,srcsetSizes = sizeEntries
@@ -240,7 +243,7 @@ export function buildPictureTag({
         // TODO senza altezza `bb=<w>x` vale per il viewer di default: prevedere altre convenzioni (es. imgix)
         searchParams.set('bb', `${w}x${h ?? ''}`);
         base_url.search = searchParams.toString();
-        srcsetArray.push(`${base_url.toString()} ${w}w`);
+        srcsetArray.push(`${isRootRelative? base_url.pathname + base_url.search : base_url.toString()} ${w}w`);
       });
 
       if(is_default_fmt) {