@massimo-cassandro/minimo 1.41.5 → 1.41.7

package/dev-tools/starter-kit/source_files/root/__project__.code-workspace

@@ -45,6 +45,10 @@
       {
         "filePath": "node_modules/@massimo-cassandro/minimo/src/css",
         "group": "Default"
+      },
+      {
+        "filePath": "node_modules/@massimo-cassandro/minimo/src/web-components/json-table/jt-docs.md",
+        "group": "Default"
       }
     ],
 

package/dev-tools/starter-kit/source_files/root/package-tpl.json

@@ -23,7 +23,7 @@
     "symfony server": "symfony serve --port=[[port8000]] --listen-ip=0.0.0.0 # http://192.168.1.135:[[port8000]] # -d (deamon): rimane aperto anche dopo la chiusura del terminale, terminare con `symfony server:stop`",
     "launchChrome": "open -n -a 'Google Chrome' --args --profile-directory='Profile 3' # mbn: 1 / mg2: 3",
     "webpack PROD": "npm run 'UPD-version' && NODE_ENV=production webpack --config ./webpack.config.mjs --stats minimal",
-    "UPD-version": "npx update-version --no-log-v0 --log-file=./changelog.md # --log-patch --pkg=alt/path/to/package.json",
+    "UPD-version": "npx update-version --no-log-v0 --log-file=./changelog.md # --log-patch --pkg=alt/path/to/package.json --default-patch-log=__log_text__",
     "email sass": "npx sass ./app/email:./templates/email/css --no-source-map --style=compressed --watch",
     "postcss email": "postcss ./app/email/[!_]*.css --dir ./templates/email/css --no-map --verbose --config ./app/email --watch",
     "eslint-check": "npx eslint app/",

package/dev-tools/starter-kit/source_files/root/webpack.config.mjs

@@ -161,6 +161,9 @@ const { CustomPropsPurgeCssPlugin } = runCustomPropsPlugin
 // - `enforce: true` garantisce che `shared.js` e `shared.css` siano sempre
 //   generati (senza, splitChunks non crea il chunk se i moduli sono sotto la
 //   soglia `minSize`, e il link nel template punterebbe a un file inesistente)
+// - i moduli di `unsplash-page` (js e css module) e la sua dipendenza `blurhash`
+//   sono esclusi dal chunk condiviso (`excluded_paths` in `shared_chunk_paths`):
+//   restano nel js/css della entry che li importa
 // - i template (twig/altro) devono linkare (preload + link) sia `shared.css` che il
 //   css della propria entry, con `shared.css` PRIMA del css della entry per
 //   rispettare l'ordine della cascata (vedi _sf/templates/_main-tpl.html.twig)
@@ -181,7 +184,18 @@ const shared_chunk_paths = (module) => {
     'app/src/components',
   ].map(p => `${sep}${p.replace(/\//g, sep)}${sep}`).join('|'));
 
-  return pathsRegexp.test(module.nameForCondition?.() ?? '');
+  // path dei moduli esclusi dal chunk `shared` (restano nella entry che li importa)
+  const excluded_paths = [
+    'minimo/src/components/unsplash-page',
+    'node_modules/blurhash', // peer dep usata solo da unsplash-page
+  ];
+  const excludedRegexp = new RegExp(
+    excluded_paths.map(p => `${sep}${p.replace(/\//g, sep)}${sep}`).join('|')
+  );
+
+  const modulePath = module.nameForCondition?.() ?? '';
+
+  return !excludedRegexp.test(modulePath) && pathsRegexp.test(modulePath);
 };
 
 

package/dev-tools/starter-kit/webpack-config-upg.md

@@ -10,6 +10,18 @@ Le versioni precedenti sono conservate in `archived/webpack-config-v2/` del repo
 
 ## Fix e upg da verificare e applicare a tutte le versioni
 * WebpackManifestPlugin: impostare `removeKeyHash: /\?.*$/, // /([a-f0-9]{32}\.?)/gi, // /(\?as_asset)$/,`, sostituendo eventuali impostazione `removeKeyHash: true` se presente
+* cacheGroup `shared` (solo con `useSharedChunk: true`): escludere `unsplash-page` e `blurhash` dal chunk condiviso, in modo che js e css restino nella entry che li importa. In `webpack.config.mjs`, nella funzione `shared_chunk_paths`, prima del `return` aggiungere:
+  ```js
+  const excluded_paths = [
+    'minimo/src/components/unsplash-page',
+    'node_modules/blurhash', // peer dep usata solo da unsplash-page
+  ];
+  const excludedRegexp = new RegExp(
+    excluded_paths.map(p => `${sep}${p.replace(/\//g, sep)}${sep}`).join('|')
+  );
+  const modulePath = module.nameForCondition?.() ?? '';
+  ```
+  e sostituire il `return` con `return !excludedRegexp.test(modulePath) && pathsRegexp.test(modulePath);`. Aggiungere anche al commento sopra il cacheGroup la nota sull'esclusione.
 
 
 ## Da v2 a v3

package/dev-tools/update-version/README.md

@@ -17,4 +17,5 @@ Opzioni:
 * `--pkg`: Percorso del file `package.json` relativo alla directory corrente (default: `./package.json`)
 * `--log-file`: Percorso del file di log relativo alla directory corrente (default: `./changelog.md`). Se il nome del file termina con `.txt`, si assume il formato di log della versione precedente di `update-version`, in cui ogni riga ha la forma `timestamp | version | description`
 * `--log-patch`: Se presente, vengono registrate nel log anche le modifiche di tipo patch.
+* `--default-patch-log="testo"`: Testo di default usato per il log delle patch (default: `Fix / Upd`).
 * `--no-log-v0`: Se `true` (default), il log non viene scritto quando la versione major è `0`, tranne per la voce iniziale creata alla prima inizializzazione del file changelog. Passare `--no-log-v0` per abilitarlo esplicitamente, oppure `--no-log-v0=false` per disabilitarlo da riga di comando.

package/dev-tools/update-version/index.mjs

@@ -79,7 +79,7 @@ async function run() {
       (params.logRow.descr
         ? ' - ' + params.logRow.descr
         : params.updateMode === 'patch' && !(params.noLogV0 && params.semverArray[0] === 0)
-          ? ' - Fix / Dependencies upd'
+          ? ` - ${params.defaultPatchLog}`
           : '')
     );
 

package/dev-tools/update-version/src/chooser-inquirer.mjs

@@ -39,7 +39,7 @@ export async function chooser() {
       default: answer === 'init'
         ? 'Setup'
         : answer === 'patch'
-          ? 'Fix / Dependencies upd'
+          ? params.defaultPatchLog
           : ''
     });
     params.logRow.descr = descr.trim() || null;

package/dev-tools/update-version/src/get-cli-params.mjs

@@ -24,6 +24,13 @@ export function getCliParams() {
       if (!params.toLog.includes('patch')) params.toLog.push('patch');
     }
 
+    // testo default per i log patch
+    if (arg.startsWith('--default-patch-log=')) {
+      // slice, non split: il testo può contenere a sua volta il carattere '='
+      const value = arg.slice('--default-patch-log='.length).trim();
+      if (value) params.defaultPatchLog = value;
+    }
+
     // Disabilita il log per major version 0
     if (arg === '--no-log-v0') {
       params.noLogV0 = true;

package/dev-tools/update-version/src/params.mjs

@@ -1,16 +1,29 @@
 export const params = {
   // Valori di default
 
+  // percorso package.json
+  // corrisponde al parametro cli `--pkg`
   packageJsonFile: './package.json',
+
+  // percorso log file
+  // corrisponde al parametro cli `--log-file`
   logFile: './changelog.md',
+
   markdownLog: true,
   toLog: ['major', 'minor'], // opzionale 'patch'
   locale: 'it-IT',
 
   debug: false, // solo sviluppo, non aggiorna nulla ma mostra l'output finale
 
-  addLog: true, // modificato in base alla scelta del tipo di aggironamento e del valore di toLog
-  noLogV0: true, // se true e la major version è 0 il log non viene registrato (ad esclusione dell'inizializzazione del file)
+  addLog: true, // modificato in base alla scelta del tipo di aggiornamento e del valore di toLog
+
+  // se true e la major version è 0 il log non viene registrato (ad esclusione dell'inizializzazione del file)
+  // corrisponde al parametro cli `--no-log-v0`
+  noLogV0: true,
+
+  // testo di default per il log delle patch
+  // corrisponde al parametro cli `--default-patch-log`
+  defaultPatchLog: 'Fix / Upd',
 
   // preRealeaseTags: ['alpha', 'beta', 'rc'],
   logRow: {

package/package.json

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

package/src/web-components/json-table/jt-docs/parametri.md

@@ -0,0 +1,124 @@
+# Parametri
+
+[Torna alla pagina iniziale](../jt-docs.md)
+
+Tutti i parametri sono impostabili sia da attributo HTML che come oggetto in `init({...})`. I valori di tipo funzione solo da `init()`.
+
+| Parametro | Tipo / default | Descrizione |
+|---|---|---|
+| `debug` | boolean (`false`) | Log in console di parametri, colonne, dati, stato ed elementi generati |
+| `jsonUrl` | string (`null`) | URL del JSON da caricare. Ignorato se `data` è presente |
+| `jqDatatableMode` | boolean (`false`) | Se `true` imposta come default i valori compatibili con il formato server-side di jQuery DataTables: `jsonDataField: 'data'`, `totRecField: 'recordsTotal'`, `filteredRecField: 'recordsFiltered'`, `serverSide: true` e i `serverParams` indicati in "Modalità jQuery DataTables". Ogni valore resta sovrascrivibile |
+| `jsonDataField` | string o null (`'data'`) | Chiave del JSON che contiene l'array delle righe (es. `'data'` per `{ data: [...] }`); `null` o `''` = la root del JSON è l'array stesso |
+| `totRecField` | string (`'totRec'`) | Chiave del JSON con il totale dei record (numerico); se assente o non numerico il totale è la lunghezza dell'array |
+| `filteredRecField` | string (`'filteredRec'`) | Solo server-side: chiave del JSON con il numero di record che soddisfano la ricerca corrente; se assente vale `totRecField` |
+| `data` | Array<Object> (`null`) | Righe inline; prevale su `jsonUrl`. Da attributo va passato come stringa JSON ed è sempre inteso come array delle righe (`jsonDataField` ignorato) |
+| `cols` | ColDefinition[] | **OBBLIGATORIO**: definizione delle colonne (vedi sotto). Se assente o vuoto viene segnalato un errore in console e la tabella non viene generata |
+| `dataTypes` | Object (`{}`) | Tipi di dato personalizzati, uniti a quelli predefiniti (vedi sotto) |
+| `caption` | string o Function (`null`) | Caption della tabella (testo o HTML), oppure funzione che restituisce stringa o Node. Mostrata sotto la tabella (vedi "Caption e paginazione") |
+| `search` | boolean (`true`) | Genera l'input di ricerca |
+| `searchDebounce` | number (`300`) | Millisecondi di attesa dopo l'ultimo tasto prima di eseguire la ricerca |
+| `perPage` | number (`25`) | Righe per pagina; `0` = nessuna paginazione (tutte le righe, nessuna navigazione) |
+| `paginationDelta` | number (`2`) | Pulsanti pagina mostrati a ciascun lato della pagina corrente |
+| `serverSide` | boolean (`false`) | Paginazione, ordinamento e ricerca delegati al server (vedi "Modalità server-side"). Richiede `jsonUrl` |
+| `serverParams` | Object | Nomi dei parametri di query string in modalità server-side, uniti ai default (vedi sotto) |
+| `initialSort` | { key, dir } o null (`null`) | Ordinamento applicato al caricamento, es. `{ key: 'name', dir: 'asc' }` |
+| `tfoot` | boolean (`false`) | Genera il tfoot (vedi `tfootRender` delle colonne). Non disponibile in modalità server-side |
+| `updateFooterOnPageChange` | boolean (`false`) | Se `true` `tfootRender` riceve solo i record della pagina corrente (subtotali di pagina) e il footer si aggiorna a ogni cambio pagina; se `false` riceve l'intero set filtrato e si aggiorna solo al cambio filtro |
+| `infoText` | string, Function o null (`null`) | Contenuto dell'area info: stringa mustache-like con i segnaposto `{start}`, `{end}`, `{totRec}`, `{filteredRec}`, `{page}`, `{totPages}`, oppure funzione `(start, end, totRec, filteredRec, page, totPages) => string\|Node`. `null` = viene usato `labels.info` |
+| `template` | Array (`[{ slot: 'infoSection' }, { slot: 'table' }]`) | Layout del contenitore principale (vedi "Template") |
+| `locale` | string (`'it-IT'`) | Locale per numeri, date e confronto stringhe nell'ordinamento |
+| `currency` | string (`'EUR'`) | Codice ISO 4217 usato dal tipo `currency` |
+| `datesLocaleOpts` | Intl.DateTimeFormatOptions (`{ year: 'numeric', month: 'short', day: 'numeric' }`) | Parte data dei tipi date/datetime |
+| `timesLocaleOpts` | Intl.DateTimeFormatOptions (`{ hour12: false, hour: '2-digit', minute: '2-digit' }`) | Parte ora del tipo datetime |
+| `numbersLocaleOpts` | Intl.NumberFormatOptions (`{ maximumFractionDigits: 2 }`) | Tipo `num` |
+| `currPercLocaleOpts` | Intl.NumberFormatOptions (`{ minimumFractionDigits: 2, maximumFractionDigits: 2 }`) | Tipi currency/euro/perc/percDecimal |
+| `renderNullAs` | string o null (`'—'`) | Contenuto per i valori null/undefined |
+| `renderZeroAs` | string o null (`null`) | Se non null, contenuto per i valori numerici pari a zero |
+| `renderNaNAs` | string o null (`'—'`) | Contenuto per i valori non numerici nei tipi numerici |
+| `boolTrueIcon` | icona, vedi nota (icona `check-bold` di minimo (Phosphor)) | Icona per i valori `true` (tipo bool) |
+| `boolFalseIcon` | icona, vedi nota (icona `x-bold`) | Icona per i valori `false` |
+| `sortAscArrowIcon` | icona, vedi nota (icona `arrow-up`) | Icona del pulsante di ordinamento, ordinamento asc attivo |
+| `sortDescArrowIcon` | icona, vedi nota (icona `arrow-down`) | Icona del pulsante di ordinamento, ordinamento desc attivo |
+| `sortNoneArrowIcon` | icona, vedi nota (icona `arrows-down-up`) | Icona del pulsante di ordinamento, nessun ordinamento |
+| `paginationPrevIcon` | icona, vedi nota (icona `caret-left`) | Icona del pulsante "pagina precedente" |
+| `paginationNextIcon` | icona, vedi nota (icona `caret-right`) | Icona del pulsante "pagina successiva" |
+| `trCallback` | (tr, row, params) => void (`null`) | Callback invocata dopo il rendering di ogni riga del body |
+| `tableId` | string (`null`) | Id del tag `<table>` |
+| `classes` | Object | Classi consumer (vedi sotto), unite ai default |
+| `labels` | Object | Testi (vedi sotto), uniti ai default |
+
+**Nota sulle icone**: ogni icona può essere una stringa SVG/HTML (es. import `?inline`), un Node, un oggetto domBuilder o una funzione che restituisce uno di questi valori.
+
+## `classes`
+
+Nomi delle classi assegnate agli elementi generati. Le classi interne di layout (CSS module)
+vengono **sempre** applicate in aggiunta a queste; ogni valore sostituisce interamente il
+default della stessa chiave.
+
+```javascript
+classes: {
+  wrapper: null,                    // contenitore principale (<section>: info + tabella)
+  infoOuter: null,                  // contenitore esterno della sezione info
+  info: null,                       // sezione info (testo + ricerca)
+  resultInfo: null,                 // contenitore del testo info
+  search: null,                     // wrapper dell'input di ricerca
+  searchInput: 'form-control form-control-sm', // input di ricerca
+  tableWrapper: 'table-responsive', // div che racchiude la tabella
+  table: 'table table-bordered',    // tag <table>
+  tableFooter: null,                // barra sotto la tabella (caption + paginazione)
+  caption: null,                    // contenitore della caption
+  pagination: null,                 // <nav> della paginazione
+  paginationBtn: 'btn-reset',       // pulsanti della paginazione
+  sortBtn: 'btn-reset',             // pulsanti di ordinamento nei <th>
+  empty: null,                      // cella unica mostrata in assenza di righe
+  textStart: null,                  // allineamento inline-start (le celle minimo lo sono già)
+  textCenter: 'text-center',        // allineamento al centro
+  textEnd: 'text-end',              // allineamento inline-end
+  nowrap: 'text-nowrap',            // no-wrap
+  numeric: 'text-numeric',          // cifre tabulari (tipi numerici)
+  boolCell: null,                   // classe aggiuntiva per tutte le celle di tipo bool
+  boolTrue: null,                   // classe aggiuntiva per le celle bool con valore true
+  boolFalse: null                   // classe aggiuntiva per le celle bool con valore false
+}
+```
+
+Le classi di allineamento (`textEnd`, `textCenter`, `nowrap`, `numeric`) sono quelle usate dai
+tipi di dato predefiniti: modificandole si cambiano le classi di tutte le colonne di quel tipo.
+
+## `labels`
+
+```javascript
+labels: {
+  loading: 'Caricamento dati…',            // segnaposto di caricamento (visually hidden)
+  searchPlaceholder: 'Cerca...',           // placeholder dell'input di ricerca
+  searchTitle: 'Cerca nella tabella',      // attributo title dell'input
+  searchAriaLabel: 'Filtra risultati',     // aria-label dell'input
+  info: 'Stai visualizzando le righe da {start} a {end}, su un totale di {filteredRec} record trovati',
+                                           // template del testo info (vedi `infoText`)
+  noRows: 'Nessun record trovato',         // testo info e cella unica con set di dati vuoto
+  noResults: 'Nessun risultato per la ricerca', // idem, con ricerca senza risultati
+  sortAsc: 'Ordina questa colonna in senso ascendente (A → Z)',   // title/aria-label del
+  sortDesc: 'Ordina questa colonna in senso discendente (Z → A)', // pulsante di ordinamento:
+  sortNone: 'Rimuovi l’ordinamento a questa colonna',             // descrivono l'azione del
+                                                                  // prossimo click
+  paginationAriaLabel: 'Navigazione pagine', // aria-label del <nav>
+  prevPage: 'Pagina precedente',           // title/aria-label del pulsante precedente
+  nextPage: 'Pagina successiva',           // idem, successivo
+  pageTitle: 'Vai a pagina {page}',        // idem, pulsanti pagina
+  currentPage: 'Pagina {page}, corrente'   // idem, pagina corrente
+}
+```
+
+I segnaposto di `labels.info` / `infoText`:
+
+| Segnaposto | Valore |
+|---|---|
+| `{start}` | indice (da 1) del primo record della pagina corrente, nel set filtrato |
+| `{end}` | indice dell'ultimo record della pagina corrente |
+| `{totRec}` | totale dei record non filtrati (dal JSON, vedi `totRecField`, o lunghezza dei dati) |
+| `{filteredRec}` | totale dei record dopo il filtro |
+| `{page}` | pagina corrente |
+| `{totPages}` | numero di pagine |
+
+I numeri vengono formattati secondo `locale`.