@massimo-cassandro/minimo 1.32.4 → 1.33.1

package/README.md

@@ -9,9 +9,10 @@ npm i @massimo-cassandro/minimo
 
 # optional:
 npm i -D @massimo-cassandro/eslint-config
-npm i -D @massimo-cassandro/stylelint-config
 ```
 
+> Note: a stylelint config is bundled with minimo itself (no separate install needed) — see [dev-tools/stylelint-config/README.md](dev-tools/stylelint-config/README.md).
+
 > Note: **minimo** is designed to be used with WebPack using the configuration you can find in the [starter-kit folder](./dev-tools/starter-kit/) of this repository. If changes are made (for example, to how SVG files are imported), things may not work as expected.
 >
 

package/dev-tools/starter-kit/source_files/_private/pwd.md

@@ -0,0 +1,16 @@
+## pwd dev
+* massimo.cassandro@blu-net.it
+* pwd: `devMax`
+* Password hash   `$2y$13$woOLLKqTHGnCqlo8D6Iste50vipaXOn2uKPaxztUK8bfQMYPa2MXu`
+
+```sql
+INSERT INTO `utente` (`id`, `email`, `password`, `nome`, `cognome`, `roles`, `active`, `cr_timestamp`, `last_login`, `cancellato`, `export`, `um_utente_id`, `um_timestamp`)
+VALUES
+	(2, 'massimo.cassandro@blu-net.it', '$2y$13$woOLLKqTHGnCqlo8D6Iste50vipaXOn2uKPaxztUK8bfQMYPa2MXu', 'Massimo', 'Cassandro', '[\"ROLE_DEPLOY\"]', 1, '2026-03-30 00:00:00', '2026-07-22 09:52:57', 0, 1, 1, '2026-07-22 11:52:57')
+  ON DUPLICATE KEY UPDATE
+    password = '$2y$13$woOLLKqTHGnCqlo8D6Iste50vipaXOn2uKPaxztUK8bfQMYPa2MXu';
+```
+
+## genera pwd symfony
+
+`php bin/console security:hash-password`

package/dev-tools/starter-kit/source_files/_private/sf.md

@@ -0,0 +1,12 @@
+# sf
+
+## pagine di errore DEV
+
+* http://localhost:[[port5700]]/_error/500
+
+
+## svuota cache
+```bash
+cd /path/to/project/dir
+sudo php bin/console cache:clear --env=prod
+```

package/dev-tools/starter-kit/source_files/{CLAUDE-frontend.md → app/CLAUDE.md}

@@ -9,6 +9,7 @@
 - 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 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
+- 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
 - 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

package/dev-tools/starter-kit/source_files/app/assets/api_htaccess

@@ -0,0 +1,20 @@
+# Nega l'accesso diretto ai soli file di configurazione (contengono le
+# credenziali OAuth). Gli altri file di questa cartella sono endpoint veri
+# e propri (login.php, callback.php, whoami.php, ecc.) e devono restare
+# raggiungibili normalmente: qui non c'è un "Require all denied" sull'intera
+# cartella come quando cfg/ era isolata.
+# I file restano comunque leggibili da PHP tramite require (accesso da
+# filesystem, non passa da Apache), quindi l'app continua a funzionare.
+
+<FilesMatch "^config(-template|-prod)?\.php$">
+    # Apache 2.4+ (praticamente tutti gli hosting attuali)
+    <IfModule mod_authz_core.c>
+        Require all denied
+    </IfModule>
+
+    # Fallback per Apache 2.2 (hosting più vecchi)
+    <IfModule !mod_authz_core.c>
+        Order deny,allow
+        Deny from all
+    </IfModule>
+</FilesMatch>

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

@@ -3,7 +3,7 @@
   Per ulteriori entry critical specifiche di pagina, copiare e rinominare.
 
   Le entry con suffisso `.critical` generano asset destinati a essere
-  INLINATI nei template html: devono restare AUTOSUFFICIENTI e minimi.
+  inseriti inline nei template html: devono restare AUTOSUFFICIENTI e minimi.
   Il suffisso attiva l'istanza PurgeCSS dedicata con purge stretto, in dev
   e in prod (vedi purgeCSSPluginCritical in webpack.config.mjs), e la regola
   dedicata in css-rules.mjs.

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

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

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

@@ -28,7 +28,7 @@
     "launchChrome": "open -n -a 'Google Chrome' --args --profile-directory='Profile 3'",
     "python server": "python3 -m http.server 8000 # --directory __dirname__ # 8000 = default port",
     "php server": "php -S localhost:8000 # -t root_dir/",
-    "symfony server": "symfony serve --port=810X --listen-ip=0.0.0.0 # http://192.168.1.135:810X # -d (deamon): rimane aperto anche dopo la chiusura del terminale, terminare con `symfony server:stop`",
+    "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`",
     "node server": "node serve # richiede ‘npm i serve’",
     "build tokens": "npx buildTokens --config ./app/css/tokens-config.mjs",
     "check unresolved props": "npx checkUnresolvedProps --config ./app/css/tokens-config.mjs",

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

@@ -1,6 +1,6 @@
 export default {
   extends: [
-    '@massimo-cassandro/stylelint-config',
+    '@massimo-cassandro/minimo/stylelint-config',
   ],
 
   // File da ignorare durante l'analisi

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

@@ -0,0 +1,41 @@
+/* plugins/inline-critical-css.mjs */
+import HtmlWebpackPlugin from 'html-webpack-plugin';
+
+export class InlineCriticalCssPlugin {
+  constructor({ match }) {
+    this.match = match;
+  }
+
+  apply(compiler) {
+    compiler.hooks.compilation.tap('InlineCriticalCssPlugin', (compilation) => {
+      HtmlWebpackPlugin.getHooks(compilation).alterAssetTagGroups.tapAsync(
+        'InlineCriticalCssPlugin',
+        (data, callback) => {
+          const isTarget = (tag) =>
+            tag.tagName === 'link' && this.match(tag.attributes.href);
+
+          const linkTag = [...data.headTags, ...data.bodyTags].find(isTarget);
+
+          if (linkTag) {
+            const publicPath = compilation.outputOptions.publicPath || '';
+            const assetName = linkTag.attributes.href.replace(publicPath, '');
+            const source = compilation.assets[assetName]?.source();
+
+            if (source) {
+              const styleTag = {
+                tagName: 'style',
+                voidTag: false,
+                innerHTML: source,
+                attributes: {},
+              };
+              data.headTags = data.headTags.filter((t) => !isTarget(t)).concat(styleTag);
+              data.bodyTags = data.bodyTags.filter((t) => !isTarget(t));
+            }
+          }
+
+          callback(null, data);
+        }
+      );
+    });
+  }
+}

package/dev-tools/starter-kit/{webpack-config-modules → source_files/root/webpack-config-modules}/purgecss-setup.mjs

@@ -5,7 +5,7 @@ import { purgecssVariablesSafelist } from './purgecss-variables-safelist.mjs';
 
 /*
   Istanzia i plugin PurgeCSS del progetto: un passaggio stretto sui css
-  `.critical` (inlinati nei template, devono restare autosufficienti) e un
+  `.critical` (inline nei template, devono restare autosufficienti) e un
   passaggio generale su tutti gli altri asset (il purge è idempotente: il
   secondo passaggio sui critical non rimuove altro).
 

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

@@ -22,6 +22,8 @@ import { cssRules } from './webpack-config-modules/css-rules.mjs';
 import { createPurgeCSSPlugins } from './webpack-config-modules/purgecss-setup.mjs';
 import { getJsConfigAliases } from './webpack-config-modules/get-jsConfig-aliases.mjs';
 import { svgRules } from './webpack-config-modules/svg-rules.mjs';
+// import { InlineCriticalCssPlugin } from './webpack-config-modules/inline-critical-css.mjs';
+
 
 // --- config ---
 const __filename = fileURLToPath(import.meta.url)
@@ -30,14 +32,14 @@ const __filename = fileURLToPath(import.meta.url)
 // Risolve un percorso a partire dalla root del progetto, che coincide con la dir
 // di questo file solo se il frontend NON è in una sottodirectory (es. ./app):
 // vengono provate entrambe le posizioni, in fallback la prima
-const fromProjectRoot = (relPath) => {
-  const candidates = ['./', '../'].map(p => path.resolve(__dirname, p, relPath));
-  return candidates.find(p => fs.existsSync(p)) ?? candidates[0];
-};
+// const fromProjectRoot = (relPath) => {
+//   const candidates = ['./', '../'].map(p => path.resolve(__dirname, p, relPath));
+//   return candidates.find(p => fs.existsSync(p)) ?? candidates[0];
+// };
 
 const isDevelopment = process.env.NODE_ENV === 'development'
-  ,devServerPort = 570x
-  // ,apiPort = 800x
+  ,devServerPort = [[port5700]]
+  // ,apiPort = [[port8000]]
   ,useSass = false
   ,inlineCssInDevMode = true
   ,useSvgo = true
@@ -60,11 +62,11 @@ const isDevelopment = process.env.NODE_ENV === 'development'
   // NB: jsconfig.json va tenuto in questa stessa dir (gli alias sono risolti
   // a partire dalla sua posizione)
   ,jsConfigAliases = getJsConfigAliases(path.resolve(__dirname, './jsconfig.json'))
-  ,packageJson = JSON.parse(fs.readFileSync(fromProjectRoot('package.json'), 'utf-8'))
+  ,packageJson = JSON.parse(fs.readFileSync('./package.json', 'utf-8')) //JSON.parse(fs.readFileSync(fromProjectRoot('package.json'), 'utf-8'))
 
   // path del pacchetto minimo (il suo js genera markup con classi proprie e il
   // suo css dichiara custom properties: entrambi vanno visti da PurgeCSS)
-  ,minimo_path = fromProjectRoot('node_modules/@massimo-cassandro/minimo')
+  ,minimo_path = './node_modules/@massimo-cassandro/minimo' // fromProjectRoot('node_modules/@massimo-cassandro/minimo')
 
   ,usePurgeCss = true // false per disattivare PurgeCSS (debug rapido di problemi legati al purge)
   ,purgeCSSOptions = {
@@ -78,7 +80,7 @@ const isDevelopment = process.env.NODE_ENV === 'development'
 // test del cacheGroup `shared` (splitChunks): i css restano SEMPRE FUORI dal
 // chunk condiviso e nel chunk della entry che li importa, così ogni asset css
 // resta autosufficiente (`variables: true` funziona per singolo asset, e i
-// critical css inlinati nei template devono restare autosufficienti). I
+// critical css inline nei template devono restare autosufficienti). I
 // template (twig/altro) linkano solo il css della propria entry (e gli
 // eventuali `.critical.css`), MAI uno shared.css: se i css finissero nel
 // chunk condiviso, quella parte di stili sparirebbe silenziosamente dalla
@@ -120,24 +122,41 @@ const shared_chunk_paths = (module) => {
 const CopyWebpackPluginPatterns = [
 
   // {
-  //   from: '*.webp',
-  //   to: 'imgs/[name].[contenthash].[ext]',
-  //   context: './source/path/', // viene rimosso nella copia
+  //   from: 'app/api',
+  //   to: 'api',
   //   globOptions: {
   //     dot: true,
   //     gitignore: true,
-  //     ignore: [ '**/.DS_Store' ]
+  //     ignore: [
+  //       '**/.DS_Store',
+  //       // config.php e config-prod.php sono
+  //       // gestiti a parte nei pattern successivi (config.php è sempre
+  //       // scritto a mano per ambiente, mai copiato dalla build)
+  //       // '**/config.php',
+  //       // '**/config-prod.php',
+  //     ]
   //   }
   // },
   // {
-  //   from: 'app/php',
-  //   to: 'php',
-  //   globOptions: {
-  //     dot: true,
-  //     gitignore: true,
-  //     ignore: [ '**/.DS_Store', ...(isDevelopment ? [] : [ '**/init-dev.php' ]) ]
-  //   }
-  // }
+  //   from: 'app/api/config-prod.php',
+  //   to: 'api/config.php'
+  // },
+  // {
+  //   from: './app/assets/root_htaccess',
+  //   to: '.htaccess',
+  //   toType: 'file'
+  // },
+  // {
+  //   from: './app/assets/robots.txt',
+  //   to: 'robots.txt',
+  //   toType: 'file'
+  // },
+  // {
+  //   from: './app/assets/api_htaccess',
+  //   to: 'api/.htaccess',
+  //   toType: 'file',
+  //   // context: 'app/api'
+  // },
 ];
 
 // =>> PurgeCSS
@@ -155,12 +174,13 @@ const CopyWebpackPluginPatterns = [
 // =>> entries
 // NB: percorsi dalla root del progetto
 const entries = {
-  'xxxxxx': './index.js'
+  'index': './app/index.js',
 
-  // css critici inlinati nei template html: il suffisso `.critical` nel nome
+  // css critici da includere inline nei template html: il suffisso `.critical` nel nome
   // della entry attiva l'istanza PurgeCSS dedicata con purge stretto
   // (vedi purgecss-setup.mjs) e la regola dedicata in css-rules.mjs
-  // ,'xxxxxx.critical': './index-critical.css'
+  'layout.critical': './app/css/layout.critical.css'
+
 };
 
 
@@ -195,7 +215,7 @@ const config = {
     path: output_dir,
     filename: '[name].[contenthash].js',
     publicPath: '/',
-    // publicPath: isDevelopment? '/' : './', // per devServer, nel caso in cui l'output di produzione non sia sulla root
+    // publicPath: isDevelopment? '/' : './', // nel caso in cui l'output di produzione non sia sulla root
     clean: !isDevelopment
   },
 
@@ -350,6 +370,12 @@ const config = {
       ignoreOrder: true
     }),
 
+    // =>> plugins: InlineCriticalCssPlugin (solo prod)
+    // ...(isDevelopment
+    //   ? []
+    //   : [new InlineCriticalCssPlugin({ match: (href) => href?.includes('.critical') })]
+    // ),
+
     // =>> plugins: HtmlWebpackPlugin (manifest)
     new HtmlWebpackPlugin({
       filename: 'manifest.webmanifest',
@@ -425,7 +451,7 @@ const config = {
 
       },
       raw: true,
-      // niente banner nei critical css: vengono inlinati nei template html
+      // niente banner nei critical css: vengono inseriti inline nei template html
       exclude: /\.critical/ // chunk name
     }),
 
@@ -643,18 +669,10 @@ const config = {
       // =>> Video
       // {
       //   test: /\.(?:mp4|webm)$/i,
-      //   // type: 'asset/resource',
-      //   type: 'javascript/auto',
-      //   use: [
-      //     {
-      //       loader: 'file-loader',
-      //       options: {
-      //         name: '[name].[contenthash][ext]',
-      //         outputPath: 'video/',
-      //         esModule: false,
-      //       }
-      //     }
-      //   ]
+      //   type: 'asset/resource',
+      //   generator: {
+      //     filename: 'video/[name].[contenthash][ext]'
+      //   }
       // },
 
       // =>> rules: Fonts