@massimo-cassandro/minimo 1.41.4 → 1.41.6

package/dev-tools/find-orphan-css-classes/find-orphan-css-classes.mjs

@@ -376,7 +376,7 @@ for (const file of cssFiles) {
 const fallbackClasses = new Set([...globalClasses, ...allModuleClasses]);
 
 function isDefined(usage) {
-  /* usages of an excluded CSS module are not checked */
+  /* gli usi di un CSS module escluso non vengono controllati */
   if (usage.module && cfg.excludeCssFiles.has(usage.module)) return true;
   if (!usage.isModule) return globalClasses.has(usage.cls);
   const set = usage.module ? getModuleClasses(usage.module) : fallbackClasses;
@@ -425,7 +425,7 @@ if (values.json) {
   const reportPath = path.resolve(cfg.baseDir, REPORT_FILE);
 
   if (sorted.length) {
-    /* flat list sorted by file and line, with a clickable link to each occurrence */
+    /* elenco piatto ordinato per file e riga, con un link cliccabile a ogni occorrenza */
     const items = sorted
       .flatMap(([cls, locations]) => locations.map(loc => ({ cls, ...loc })))
       .sort((a, b) => a.file.localeCompare(b.file) || a.line - b.line);

package/dev-tools/starter-kit/source_files/app/CLAUDE.md

@@ -9,7 +9,9 @@
 - Conferma la comprensione prima di agire su richieste ambigue
 - Il progetto usa ES modules (import/export), evitare soluzioni che utilizzano commonJs
 - In linea di massima non proporre soluzioni che richiedano modifiche alla parte back-end, se presente, a meno che non sia esplicitamente richiesto
-- nella chat evitare neologismi come inlinare, parsare, committare ecc., usare i termini corrispondenti in italiano o il termine originale in inglese dove non sia possibile un equivalente in italiano. Non coniugare mai secondo le regole dell'italiano verbi di altre lingue
-- nei commenti su più righe preferire `/* ... */` piuttosto che ripetere `//` ad igni inizio riga
+- evitare SEMPRE neologismi come 'inlinare', 'parsare', 'committare' ecc., usare i termini corrispondenti in italiano o il termine originale in inglese dove non sia possibile un equivalente in italiano. Non coniugare mai secondo le regole dell'italiano verbi di altre lingue
+- nei commenti di 3 o più righe preferire `/* ... */` piuttosto che ripetere `//` ad igni inizio riga
 - a meno che non sia esplicitamente richiesto di eseguire subito una modifica, NON ESEGUIRE MAI nulla autonomamente ma mostra sempre un piano d'azione prima di procedere
 - nei commenti jsDoc aggiungere sempre dove possibile una sezione example che riepiloghi i vari parametri mostrando i valori di default
+- commenti nel codice (inclusi TODO/FIX e jsDoc) e file README vanno scritti sempre in italiano; gli identificatori restano in inglese
+- nei documenti markdown generati non andare a capo forzatamente alla fine di ogni riga: un paragrafo è una sola riga, così si usa il soft wrap dell'editor ed è più semplice fare correzioni

package/dev-tools/starter-kit/source_files/app/{css/index.css → index.css}

@@ -1,8 +1,8 @@
-/* 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 '@css/fonts.css';
-/* @import '@css/custom-media.css'; */ /* managed by postcss */
+/* @import '@css/custom-media.css'; */ /* gestito da postcss */
 @import '@css/custom-properties.css';  /* layer('base'); */
 
 @import '@css/minimo.css';

package/dev-tools/starter-kit/source_files/app/index.js

@@ -1 +1 @@
-import '@css/index.css';
+import './index.css';

package/dev-tools/starter-kit/source_files/root/_sf/controller/ImgViewerController.php

@@ -23,7 +23,7 @@ class ImgViewerController extends AbstractController
    *              es: crop=10,10,100,100 -> ritaglia un quadrato di 100px a partire dal punto 10,10
    * @param bb: bounding box dell'area che deve contenere l'immagine ridimensionata
    * @param fd: (bool) forza dimensioni (utilizzato in coppia con bb)
-   * @param q: compression quality
+   * @param q: qualità di compressione
    * @param alpha: mantiene la trasparenza nelle png (default 0)
    * @param bg: in combinazione con alpha=1 definisce il bg color della png
    * @param refresh: (bool) forza la rigenerazione dell'immagine
@@ -76,7 +76,7 @@ class ImgViewerController extends AbstractController
     // formati accettati dal browser
     $accept = $request->server->get('HTTP_ACCEPT');
 
-    // format 'auto' default
+    // formato 'auto' di default
     if(!isset($get['f'])) $get['f'] = 'auto';
 
     // format 'auto' -> sceglie il formato migliore per il browser, se disponibile
@@ -164,7 +164,7 @@ class ImgViewerController extends AbstractController
         $img = new \Imagick();
         $img->readImage($filePath);
 
-        $img->stripImage(); // Strips an image of all profiles and comments
+        $img->stripImage(); // Rimuove dall'immagine tutti i profili e i commenti
 
         if(isset($params['crop']) or isset($params['bb'])) {
           // dimensioni originali

package/dev-tools/starter-kit/source_files/root/_sf/controller/ViewerController.php

@@ -129,7 +129,7 @@ class ViewerController extends AbstractController
    *              es: crop=10,10,100,100 -> ritaglia un quadrato di 100px a partire dal punto 10,10
    * @param bb: bounding box dell'area che deve contenere l'immagine ridimensionata (image magick)
    * @param fd: forza dimensioni (utilizzato in coppia con bb)
-   * @param q: compression quality (ex jq)
+   * @param q: qualità di compressione (ex jq)
    * @param alpha: mantiene la trasparenza nelle png (default 0)
    * @param bg: in combinazione con alpha=1 definisce il bkg color della png
    * @param refresh: forza la rigenerazione dell'immagine
@@ -177,7 +177,7 @@ class ViewerController extends AbstractController
     // formati accettati dal browser
     $accept = $request->server->get('HTTP_ACCEPT');
 
-    // format 'auto' default
+    // formato 'auto' di default
     if(!isset($get['f'])) {
       $get['f'] ='auto';
     } else {

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

@@ -21,7 +21,7 @@ export default {
 
     // 'color-function-notation': null,
 
-    //********************** optionally for tailwind:
+    //********************** opzionale per tailwind:
     // 'at-rule-no-unknown': [
     //   true,
     //   'value-keyword-case': null,

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

@@ -60,7 +60,7 @@ export function cssRules({
       oneOf: [
 
         {
-          // `import url from './file.css?as_url'`: the file is emitted as is and its URL is returned
+          // `import url from './file.css?as_url'`: il file viene emesso così com'è e ne viene restituito l'URL
           resourceQuery: /as_url/,
           type: 'asset/resource',
           generator: {

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/stylelint-config/README.md

@@ -1,17 +1,17 @@
 # Stylelint config
 
-My [stylelint](https://stylelint.io/) config,
+La mia configurazione di [stylelint](https://stylelint.io/),
 
 
-## Use
+## Utilizzo
 
-Install package:
+Installare il pacchetto:
 
 ```bash
 npm install @massimo-cassandro/minimo
 ```
 
-Create a `stylelint.config.mjs` file and add:
+Creare un file `stylelint.config.mjs` e aggiungere:
 
 ```javascript
 export default {
@@ -19,7 +19,7 @@ export default {
     '@massimo-cassandro/minimo/stylelint-config',
   ],
 
-  // Files to be ignored
+  // File da ignorare
   ignoreFiles: [
     'node_modules/**/*.{css,scss}',
     'vendor/**/*.{css,scss}',
@@ -30,9 +30,9 @@ export default {
     'test/**/*.css'
   ],
 
-  // Overrides
+  // Override
   rules: {
-    //********************** optionally for tailwind:
+    //********************** opzionale per tailwind:
     // 'at-rule-no-unknown': [
     //   true,
     //   'value-keyword-case': null,

package/dev-tools/svg-icons-tools/README.md

@@ -1,22 +1,22 @@
 # Svg Icons Tools
 
-Svg Icons Tools provides some utilities for manage and optimize SVG icons:
+Svg Icons Tools fornisce alcune utilità per gestire e ottimizzare le icone SVG:
 
-* optimize all files with [SVGO](https://svgo.dev/)
-* combine svg files into a single file, where each icon is wrapped within a `<symbol>` element (inspired from [svgstore](https://github.com/svgstore/svgstore)) 
-* convert svg files to JSX
-* copy optimized svg files to target directory
-* removes *pallets* from the icon markups (see config file for more details).
-* create a scss file with svg icons converted to sass variables
-* jsx and optimized icons only: ability to manage both icons with `fill` and `stroke` adding optional classes to apply different css properties
+* ottimizza tutti i file con [SVGO](https://svgo.dev/)
+* combina i file svg in un unico file, in cui ogni icona è racchiusa in un elemento `<symbol>` (ispirato a [svgstore](https://github.com/svgstore/svgstore))
+* converte i file svg in JSX
+* copia i file svg ottimizzati nella directory di destinazione
+* rimuove i *pallet* dal markup delle icone (vedi il file di configurazione per maggiori dettagli).
+* crea un file scss con le icone svg convertite in variabili sass
+* solo per jsx e icone ottimizzate: possibilità di gestire sia icone con `fill` sia con `stroke`, aggiungendo classi opzionali per applicare proprietà css diverse
 
-These tools are pretty useless if you download your icons from one of the libraries you can find on the web, but if you design them yourself, *svg-icons-tools* can save you a lot of time in cleaning up and optimizing icons drawn with Illustrator, Figma, Sketch etc.
+Questi strumenti sono poco utili se le icone vengono scaricate da una delle librerie disponibili sul web, ma se le si disegna da sé, *svg-icons-tools* può far risparmiare molto tempo nella pulizia e nell'ottimizzazione delle icone disegnate con Illustrator, Figma, Sketch ecc.
 
-Also, most (or all) libraries only allow you to download icons with a fixed thickness, but you can often download "working" versions where thickness is defined by the stroke attribute. In these cases there is often a *pallet* that you can easily remove.
+Inoltre, la maggior parte (o la totalità) delle librerie permette di scaricare solo icone con spessore fisso, ma spesso si possono scaricare versioni "di lavoro" in cui lo spessore è definito dall'attributo stroke. In questi casi è spesso presente un *pallet* che si può rimuovere facilmente.
 
-Read more in my [Building an Icon System in React](https://medium.com/better-programming/building-an-icon-system-in-react-16757d73cc35) article.
+Maggiori informazioni nel mio articolo [Building an Icon System in React](https://medium.com/better-programming/building-an-icon-system-in-react-16757d73cc35).
 
-## Installation
+## Installazione
 
 ```bash
 npm i -D @massimo-cassandro/svg-icons-tools
@@ -24,52 +24,52 @@ npm i -D @massimo-cassandro/svg-icons-tools
 
 ## Setup
 
-First, create a config file for you project, you can run:
+Per prima cosa creare un file di configurazione per il progetto, eseguendo:
 
 ```bash
 npx iconsTools init
 ```
 
-This creates a `svg-icons-tools` directory which contains the `svg-icons-tools.config.mjs` configuration file.
+Viene creata una directory `svg-icons-tools` che contiene il file di configurazione `svg-icons-tools.config.mjs`.
 
-Rename the folder as you like and move it where you need. Then open and customize the `svg-icons-tools.config.mjs` file.
+Rinominare la cartella a piacere e spostarla dove serve. Poi aprire e personalizzare il file `svg-icons-tools.config.mjs`.
 
-## Run
+## Esecuzione
 
-To launch the script, open your terminal and use the command:
+Per lanciare lo script, aprire il terminale e usare il comando:
 
 ```bash
 npx iconsTools --config ./path/to/svg-icons-tools.config.mjs
 ```
 
-where `--config` must contain the path, relative to the current dir, to the config file.
+dove `--config` deve contenere il percorso, relativo alla directory corrente, del file di configurazione.
 
-If the `--config` parameter is not set, the script will look for the configuration file in the current directory; if the file is not found, an error will be thrown.
+Se il parametro `--config` non è impostato, lo script cerca il file di configurazione nella directory corrente; se il file non viene trovato, viene generato un errore.
 
 
-## Configuration details
+## Dettagli di configurazione
 
-See [src/default-config.mjs](src/default-config.mjs) for more info.
+Vedi [src/default-config.mjs](src/default-config.mjs) per maggiori informazioni.
 
 ## Demo
 
-See [demo/readme](demo/readme.md).
+Vedi [demo/readme](demo/readme.md).
 
 ## TODO
-* documentation to jsdoc
-* prettify the jsx output (update docs)
-* SVG attributes to jsx (upd doc)
-* option to clean-up dest folder for jsx and optimized (?)
-* auto changelog
+* documentazione in jsdoc
+* formattare meglio l'output jsx (aggiornare la documentazione)
+* attributi SVG in jsx (aggiornare la documentazione)
+* opzione per ripulire la cartella di destinazione per jsx e ottimizzati (?)
+* changelog automatico
 
 
-## Changelog / Breaking Changes
+## Changelog / Breaking change
 
 ### 1.1
-* added default jsx icon builder function
+* aggiunta la funzione predefinita per la creazione delle icone jsx
 
-#### Breaking Changes
-* in config file, `config.jsx.icon_builder` becomes `config.jsx.custom_icon_builder`, if not defined the default icon builder is used for jsx files.
+#### Breaking change
+* nel file di configurazione, `config.jsx.icon_builder` diventa `config.jsx.custom_icon_builder`; se non definita, per i file jsx viene usata la funzione predefinita.
 
 ### 1.0
-* First production release
+* Prima release di produzione

package/dev-tools/svg-icons-tools/src/config-manager.mjs

@@ -8,7 +8,7 @@ export const configManager = {
   updCfg: function(cfg) {
     this.cfgObj = { ...this.cfgObj, ...cfg };
 
-    // deep merge of cfg objects
+    // deep merge degli oggetti cfg
     Object.keys(default_config).forEach((key) => {
       if (default_config[key] && typeof default_config[key] === 'object' && !Array.isArray(default_config[key])) {
         this.cfgObj[key] = { ...default_config[key], ...this.cfgObj[key] };