@massimo-cassandro/minimo 1.33.0 → 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/{CLAUDE-frontend.md → app/CLAUDE.md}

@@ -9,7 +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/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,10 +32,10 @@ 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 = [[port5700]]
@@ -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
     }),
 

package/dev-tools/starter-kit/starter-install.sh

@@ -2,15 +2,22 @@
 
 # IMPORTANTE: questo script è idempotente e deve restare tale.
 # Può essere rilanciato più volte sullo stesso progetto (anche via `npx starter-kit`
-# per aggiornare un setup esistente) senza sovrascrivere nulla né creare duplicati:
-# per i singoli file, se il contenuto esistente è identico al sorgente la copia
-# viene saltata; se è diverso e non esiste ancora un OLD- corrispondente, il
-# file esistente viene rinominato con prefisso OLD- (preservato da quel momento
-# in poi, non viene più toccato nelle esecuzioni successive) e il nuovo file
-# prende il nome originale; se l'OLD- corrispondente esiste già, viene invece
-# sovrascritto direttamente il file "nuovo", senza aggiungere ulteriori prefissi.
-# Stessa logica, a livello di intera cartella e senza diff sui singoli file
-# contenuti, per le cartelle installate (./app, ./webpack-config-modules).
+# per aggiornare un setup esistente) senza sovrascrivere nulla né creare duplicati.
+# Per i singoli file installati sulla root del progetto e dentro
+# ./webpack-config-modules: se il contenuto esistente è identico al sorgente la
+# copia viene saltata; se è diverso e non esiste ancora un OLD- corrispondente,
+# il file esistente viene rinominato con prefisso OLD- (preservato da quel
+# momento in poi, non viene più toccato nelle esecuzioni successive) e il nuovo
+# file prende il nome originale; se l'OLD- corrispondente esiste già, viene
+# invece sovrascritto direttamente il file "nuovo", senza aggiungere ulteriori
+# prefissi. Stessa logica, a livello di intera cartella (senza diff sui
+# singoli file contenuti al suo interno prima della prima installazione), per
+# ./webpack-config-modules.
+# ./app segue invece una logica più semplice: viene rinominata per intero in
+# OLD-app solo la prima volta che esiste già (preservata da quel momento in
+# poi, mai più toccata); i file al suo interno vengono sempre sovrascritti
+# senza controllo né backup individuale (force_cat), dato che l'intera
+# cartella precedente resta comunque disponibile in OLD-app.
 # Ogni modifica futura deve conservare questa proprietà.
 
 RED='\033[0;31m'
@@ -93,8 +100,6 @@ echo "BASE_URL: ${BASE_URL}"
 SOURCE_FILES_DIR="${BASE_URL}/source_files"
 
 # webpack
-WEBPACK_CONFIG_SOURCE_PATH="$BASE_URL"
-WEBPACK_MODULES_SOURCE_PATH="${BASE_URL}/webpack-config-modules"
 WEBPACK_MODULES_INSTALL_PATH="./webpack-config-modules"
 
 # protezione contro la sovrascrittura
@@ -147,11 +152,83 @@ safe_cat_with_ports() {
   return $rc
 }
 
+# A differenza di safe_cat, sovrascrive sempre senza confrontare né
+# backuppare (nessun OLD- a livello di singolo file). Usata per i file
+# installati dentro FRONTEND_INSTALL_PATH (./app), la cui idempotenza è già
+# garantita a livello di intera cartella (OLD-app, vedi più sotto): non ha
+# senso ripetere il controllo su ogni singolo file al suo interno.
+force_cat() {
+  local src="$1"
+  local dest="$2"
+  if [ ! -f "$src" ]; then
+    echo -e "${RED}Sorgente mancante: $src${NC}"
+    return 1
+  fi
+  cat "$src" >| "$dest"
+}
+
+# Copia ricorsivamente tutti i file di una struttura sorgente (source_files/root
+# o source_files/app) in una destinazione, preservando la struttura delle
+# sotto-cartelle così com'è in source_files: aggiungere, spostare o rinominare
+# file lì non richiede modifiche a questo script.
+# Il terzo argomento (opzionale) è il nome di una funzione di rename invocata
+# su ogni singolo basename, per i casi in cui il nome del file sorgente non
+# coincide con quello di destinazione (vedi rename_root_file).
+# Il quarto argomento (opzionale, default: safe_cat_with_ports) è la funzione
+# di copia da usare per ogni file: safe_cat_with_ports confronta e backuppa
+# il singolo file (sostituzione porte no-op se non contiene placeholder);
+# force_cat sovrascrive sempre senza controlli (vedi sopra, usata per ./app).
+install_tree() {
+  local src_root="$1"
+  local dest_root="$2"
+  local rename_fn="$3"
+  local copy_fn="${4:-safe_cat_with_ports}"
+  local file rel dir base new_base dest
+  while IFS= read -r file; do
+    rel="${file#"$src_root"/}"
+    dir="$(dirname "$rel")"
+    base="$(basename "$rel")"
+    if [ -n "$rename_fn" ]; then
+      new_base="$("$rename_fn" "$base")"
+    else
+      new_base="$base"
+    fi
+    if [ "$dir" = "." ]; then
+      dest="${dest_root}/${new_base}"
+    else
+      mkdir -p "${dest_root}/${dir}"
+      dest="${dest_root}/${dir}/${new_base}"
+    fi
+    "$copy_fn" "$file" "$dest"
+  done < <(find "$src_root" -type f)
+}
+
+# Rename applicato ai file di source_files/root/ in fase di copia:
+# - prefisso singolo underscore -> dotfile (es. _gitignore -> .gitignore);
+#   il doppio underscore (__project__.code-workspace) non viene toccato,
+#   il nome resta invariato
+# - suffisso -tpl prima dell'estensione -> rimosso (es. package-tpl.json ->
+#   package.json), usato per i file template che altrimenti confliggerebbero
+#   con l'omonimo file dello starter-kit stesso
+rename_root_file() {
+  local name="$1"
+  if [[ "$name" == _* && "$name" != __* ]]; then
+    echo ".${name#_}"
+    return
+  fi
+  if [[ "$name" == *-tpl.* ]]; then
+    echo "${name/-tpl./.}"
+    return
+  fi
+  echo "$name"
+}
+
 FRONTEND_INSTALL_PATH="./app"
 # se la cartella esiste già: la prima volta viene rinominata per intero in
 # OLD-app (preservata, mai più toccata); se OLD-app esiste già, la cartella
-# esistente non viene rinominata e i file al suo interno vengono gestiti
-# singolarmente dalla stessa logica di safe_cat.
+# esistente non viene rinominata. In entrambi i casi i file al suo interno
+# vengono poi sempre sovrascritti senza controlli individuali (force_cat):
+# l'idempotenza è garantita a livello di intera cartella, non di singolo file.
 if [ -d "$FRONTEND_INSTALL_PATH" ]; then
   OLD_FRONTEND_INSTALL_PATH="$(dirname "$FRONTEND_INSTALL_PATH")/OLD-$(basename "$FRONTEND_INSTALL_PATH")"
   if [ ! -e "$OLD_FRONTEND_INSTALL_PATH" ]; then
@@ -160,50 +237,6 @@ if [ -d "$FRONTEND_INSTALL_PATH" ]; then
 fi
 
 echo -e "${GREEN}Files will be installed in: '${FRONTEND_INSTALL_PATH}'${NC}"
-mkdir -p "${FRONTEND_INSTALL_PATH}"
-
-
-
-echo -e "${GREEN}...ROOT FILES${NC}"
-safe_cat_with_ports "${BASE_URL}/package-tpl.json"  package.json
-safe_cat_with_ports "${WEBPACK_CONFIG_SOURCE_PATH}/webpack.config.mjs"  webpack.config.mjs
-
-safe_cat "${SOURCE_FILES_DIR}/_gitignore" .gitignore
-safe_cat "${SOURCE_FILES_DIR}/_browserslistrc" .browserslistrc
-safe_cat "${SOURCE_FILES_DIR}/_editorconfig" .editorconfig
-safe_cat "${SOURCE_FILES_DIR}/_prettierrc" .prettierrc
-safe_cat "${SOURCE_FILES_DIR}/jsconfig.json" jsconfig.json
-safe_cat "${SOURCE_FILES_DIR}/__project__.code-workspace" __project__.code-workspace
-safe_cat "${SOURCE_FILES_DIR}/eslint.config.mjs" eslint.config.mjs
-safe_cat "${SOURCE_FILES_DIR}/stylelint.config.mjs" stylelint.config.mjs
-
-echo -e "${GREEN}...APP FILES${NC}"
-safe_cat "${SOURCE_FILES_DIR}/_root_htaccess"             "${FRONTEND_INSTALL_PATH}/_root_htaccess"
-safe_cat "${SOURCE_FILES_DIR}/_root_robots.txt"           "${FRONTEND_INSTALL_PATH}/_root_robots.txt"
-safe_cat "${SOURCE_FILES_DIR}/CLAUDE-frontend.md"         "${FRONTEND_INSTALL_PATH}/CLAUDE.md"
-safe_cat "${WEBPACK_CONFIG_SOURCE_PATH}/webpack-template.ejs" "${FRONTEND_INSTALL_PATH}/tpl/index.ejs"
-
-
-echo -e "${GREEN}..WEBPACK CONFIG MODULES${NC}"
-# se la cartella esiste già: la prima volta viene rinominata per intero in
-# OLD-webpack-config-modules (preservata, mai più toccata); se l'OLD-
-# corrispondente esiste già, la cartella esistente non viene rinominata e i
-# file al suo interno vengono gestiti singolarmente dalla stessa logica di
-# safe_cat.
-if [ -d "$WEBPACK_MODULES_INSTALL_PATH" ]; then
-  OLD_WEBPACK_MODULES_INSTALL_PATH="$(dirname "$WEBPACK_MODULES_INSTALL_PATH")/OLD-$(basename "$WEBPACK_MODULES_INSTALL_PATH")"
-  if [ ! -e "$OLD_WEBPACK_MODULES_INSTALL_PATH" ]; then
-    mv "$WEBPACK_MODULES_INSTALL_PATH" "$OLD_WEBPACK_MODULES_INSTALL_PATH"
-  fi
-fi
-
-mkdir -p "$WEBPACK_MODULES_INSTALL_PATH"
-
-# copia tutti i file presenti in webpack-modules,
-for FILE in "${WEBPACK_MODULES_SOURCE_PATH}"/*; do
-  [ -f "$FILE" ] || continue
-  safe_cat "$FILE" "${WEBPACK_MODULES_INSTALL_PATH}/$(basename "$FILE")"
-done
 
 
 echo -e "\n${GREEN}...NODE MODULES${NC}"
@@ -271,6 +304,9 @@ done
 
 echo -e "\n${GREEN}...creating default folders${NC}"
 mkdir -p \
+  "_private" \
+  "${FRONTEND_INSTALL_PATH}" \
+  "${FRONTEND_INSTALL_PATH}/assets" \
   "${FRONTEND_INSTALL_PATH}/src" \
   "${FRONTEND_INSTALL_PATH}/css" \
   "${FRONTEND_INSTALL_PATH}/tpl" \
@@ -280,44 +316,66 @@ mkdir -p \
   "${FRONTEND_INSTALL_PATH}/error-pages"
 
 
-echo -e "${GREEN}...MINIMO FILES${NC}"
-# Sorgenti di minimo da copiare nel progetto: si usa il pacchetto appena
-# installato in node_modules (stessa versione che userà il progetto)
-MINIMO_PKG_DIR=./node_modules/@massimo-cassandro/minimo
-
-safe_cat "${MINIMO_PKG_DIR}/src/custom-properties.css" "${FRONTEND_INSTALL_PATH}/css/custom-properties.css"
-safe_cat "${MINIMO_PKG_DIR}/src/custom-media.css" "${FRONTEND_INSTALL_PATH}/css/custom-media.css"
-safe_cat "${MINIMO_PKG_DIR}/src/fonts.css" "${FRONTEND_INSTALL_PATH}/css/fonts.css"
-
-# config di build-tokens: collocato accanto al css generato (custom-properties.css).
-safe_cat "${MINIMO_PKG_DIR}/design-tokens/tokens-config-sample.mjs" "${FRONTEND_INSTALL_PATH}/css/tokens-config.mjs"
-
-# entry css principale del progetto: copia diretta di minimo.css, rinominato
-# index.css e collocato sulla root di installazione (non in /src)
-safe_cat "${MINIMO_PKG_DIR}/src/minimo.css" "${FRONTEND_INSTALL_PATH}/index.css"
 
-# favicons: config di default per `npx create-favicons`
-safe_cat "${MINIMO_PKG_DIR}/dev-tools/create-favicons/src/default-params.mjs" "${FRONTEND_INSTALL_PATH}/favicons/create-favicons-cfg.mjs"
-# favicons: istruzioni d'uso di `npx create-favicons`
-safe_cat "${SOURCE_FILES_DIR}/favicons-readme.md" "${FRONTEND_INSTALL_PATH}/favicons/readme.md"
 
+echo -e "${GREEN}...FILES${NC}"
 
-# entry css critical (inline nei template html) e entry js, sulla root di
-# installazione accanto a index.css
-safe_cat "${SOURCE_FILES_DIR}/app_index.js" "${FRONTEND_INSTALL_PATH}/index.js"
+echo -e "${DIM}...webpack config modules${NC}"
+# se la cartella esiste già: la prima volta viene rinominata per intero in
+# OLD-webpack-config-modules (preservata, mai più toccata); se l'OLD-
+# corrispondente esiste già, la cartella esistente non viene rinominata e i
+# file al suo interno vengono gestiti singolarmente dalla stessa logica di
+# safe_cat (via install_tree, più sotto).
+if [ -d "$WEBPACK_MODULES_INSTALL_PATH" ]; then
+  OLD_WEBPACK_MODULES_INSTALL_PATH="$(dirname "$WEBPACK_MODULES_INSTALL_PATH")/OLD-$(basename "$WEBPACK_MODULES_INSTALL_PATH")"
+  if [ ! -e "$OLD_WEBPACK_MODULES_INSTALL_PATH" ]; then
+    mv "$WEBPACK_MODULES_INSTALL_PATH" "$OLD_WEBPACK_MODULES_INSTALL_PATH"
+  fi
+fi
 
-# layout critical css
-safe_cat "${SOURCE_FILES_DIR}/layout-critical.css" "${FRONTEND_INSTALL_PATH}/css/layout-critical.css"
+mkdir -p "$WEBPACK_MODULES_INSTALL_PATH"
 
+# copia tutti i file di source_files/root/ nella root del progetto (inclusa
+# webpack-config-modules/, gestita sopra a livello di cartella) e tutti i
+# file di source_files/app/ dentro FRONTEND_INSTALL_PATH: struttura e nomi
+# di destinazione sono già quelli definiti in source_files (per root/ con
+# l'unica eccezione del rename dei dotfile e dei template "-tpl", vedi
+# rename_root_file), quindi aggiungere/spostare/rinominare file lì non
+# richiede modifiche a questo script. Per app/ si usa force_cat (nessun
+# controllo/backup per singolo file, vedi commento su FRONTEND_INSTALL_PATH).
+echo -e "${DIM}...root${NC}"
+install_tree "${SOURCE_FILES_DIR}/root" "." rename_root_file
+echo -e "${DIM}...app${NC}"
+install_tree "${SOURCE_FILES_DIR}/app" "${FRONTEND_INSTALL_PATH}" "" force_cat
 
 # copia tutti i file presenti in ${SOURCE_FILES_DIR}/_private,
-echo -e "${GREEN}..._PRIVATE FILES${NC}"
-mkdir -p "_private"
+echo -e "${DIM}..._private${NC}"
 for FILE in "${SOURCE_FILES_DIR}/_private"/*; do
   [ -f "$FILE" ] || continue
   safe_cat_with_ports "$FILE" "_private/$(basename "$FILE")"
 done
 
+#----------------------------------------------
+# copia altri file dai sorgenti minimo
+#----------------------------------------------
+# Sorgenti di minimo da copiare nel progetto: si usa il pacchetto appena
+# installato in node_modules (stessa versione che userà il progetto)
+MINIMO_PKG_DIR=./node_modules/@massimo-cassandro/minimo
+
+force_cat "${MINIMO_PKG_DIR}/src/custom-properties.css" "${FRONTEND_INSTALL_PATH}/css/custom-properties.css"
+force_cat "${MINIMO_PKG_DIR}/src/custom-media.css" "${FRONTEND_INSTALL_PATH}/css/custom-media.css"
+
+# entry css principale del progetto: copia diretta di minimo.css, rinominato
+force_cat "${MINIMO_PKG_DIR}/src/minimo.css" "${FRONTEND_INSTALL_PATH}/css/index.css"
+
+# config di build-tokens: collocato accanto al css generato (custom-properties.css).
+force_cat "${MINIMO_PKG_DIR}/design-tokens/tokens-config-sample.mjs" "${FRONTEND_INSTALL_PATH}/css/tokens-config.mjs"
+
+
+
+# favicons: config di default per `npx create-favicons`
+force_cat "${MINIMO_PKG_DIR}/dev-tools/create-favicons/src/default-params.mjs" "${FRONTEND_INSTALL_PATH}/favicons/create-favicons-cfg.mjs"
+
 
 if [ ${#selectedOptionalPkgs[@]} -gt 0 ]; then
   echo -e "\n${YELLOW}Pacchetti opzionali installati:${NC}"

package/dev-tools/stylelint-config/test/test.module.scss

@@ -0,0 +1,9 @@
+.moduleCss { // comment
+  color: #000;
+  // comment
+
+}
+
+:global(.non-module-class) {
+  font-weight: 500;
+}

package/package.json

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