@massimo-cassandro/minimo 1.32.4 → 1.33.1

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'
@@ -27,6 +34,65 @@ if [ -z "$ZSH_VERSION" ]; then
   exit 1
 fi
 
+# Porta da utilizzare: l'utente inserisce un numero da 0 a 99 (default 0), che
+# viene normalizzato a due cifre e usato come suffisso delle porte 80xx e 57xx.
+# I valori sostituiscono i segnaposto [[port8000]] e [[port5700]] presenti in
+# package-tpl.json, webpack.config.mjs e altri (vedi safe_cat_with_ports).
+read "PORT_INPUT?Porta da utilizzare (0-99) [0]: "
+PORT_INPUT=${PORT_INPUT:-0}
+if [[ ! "$PORT_INPUT" =~ '^[0-9]{1,2}$' ]]; then
+  printf "${RED}Errore: inserire un numero intero tra 0 e 99.${NC}\n" >&2
+  exit 1
+fi
+PORT_SUFFIX=${(l:2::0:)PORT_INPUT}
+PORT_8000="80${PORT_SUFFIX}"
+PORT_5700="57${PORT_SUFFIX}"
+echo -e "${DIM}Porte: ${PORT_8000} (server), ${PORT_5700} (webpack dev server)${NC}"
+
+# Pacchetti opzionali: installati come devDependency solo su conferma
+# esplicita dell'utente (vedi ciclo di domande più sotto). Include sia
+# devDependency "pure" del progetto, sia i peer dependencies opzionali di
+# @massimo-cassandro/minimo (vedi package.json di minimo, campi
+# peerDependencies/peerDependenciesMeta: elenco mantenuto a mano, non letto
+# dinamicamente da minimo — se cambiano va aggiornato manualmente anche qui).
+# In entrambi i casi vengono installati con `npm i -D`: in questo progetto
+# `dependencies` contiene solo @massimo-cassandro/minimo, tutto il resto
+# (tooling di build e librerie usate dai singoli componenti) è devDependency.
+# Ogni voce è "<pacchetto>|<descrizione>" (pacchetto allineato a colonna fissa
+# solo per leggibilità, non richiesto dal parsing).
+optionalPackages=(
+  "dotenv-webpack                               | gestione variabili d'ambiente (.env) nel bundle webpack"
+  "@principalstudio/html-webpack-inject-preload | injection dei tag <link rel=preload> nell'html generato"
+  "postcss-jit-props                            | include nel CSS compilato solo le custom properties effettivamente usate"
+  "@svgdotjs/svg.js                             | richiesto da charts/ di minimo"
+  "blurhash                                     | richiesto da unsplash-page di minimo (create-blurhash-canvas)"
+  "simple-datatables                            | richiesto da s-datatable-component di minimo"
+  "style-dictionary                             | richiesto da design-tokens/utilities di minimo (build-tokens)"
+)
+
+# Chiede conferma per un singolo pacchetto opzionale (default: No).
+ask_optional_pkg() {
+  local pkg="$1"
+  local desc="$2"
+  local reply
+  read "reply?Installare il pacchetto opzionale '$pkg' (${desc})? [y/N]: "
+  [[ "$reply" =~ ^[Yy]$ ]]
+}
+
+selectedOptionalPkgs=()
+
+if [ "$DEBUG" != "TRUE" ]; then
+  echo -e "\n${GREEN}...PACCHETTI OPZIONALI${NC}"
+  for entry in "${optionalPackages[@]}"; do
+    pkg="${entry%%|*}"
+    pkg="${pkg%% *}"
+    desc="${entry#*| }"
+    if ask_optional_pkg "$pkg" "$desc"; then
+      selectedOptionalPkgs+=("$pkg")
+    fi
+  done
+fi
+
 BASE_URL=${0:A:h}
 
 echo "BASE_URL: ${BASE_URL}"
@@ -34,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
@@ -67,11 +131,104 @@ safe_cat() {
   cat "$src" >| "$dest"
 }
 
+# Come safe_cat, ma sostituisce i segnaposto [[port8000]] e [[port5700]] con
+# le porte scelte all'avvio. La sostituzione viene fatta su un file temporaneo
+# che è poi passato a safe_cat: il confronto per l'idempotenza avviene quindi
+# sul contenuto già sostituito (stessa porta => copia saltata).
+safe_cat_with_ports() {
+  local src="$1"
+  local dest="$2"
+  if [ ! -f "$src" ]; then
+    echo -e "${RED}Sorgente mancante: $src${NC}"
+    return 1
+  fi
+  local tmp="$(mktemp)"
+  sed -e "s/\[\[port8000\]\]/${PORT_8000}/g" \
+      -e "s/\[\[port5700\]\]/${PORT_5700}/g" \
+      "$src" >| "$tmp"
+  safe_cat "$tmp" "$dest"
+  local rc=$?
+  rm -f "$tmp"
+  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
@@ -80,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 "${BASE_URL}/package-tpl.json"  package.json
-safe_cat "${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}"
@@ -134,7 +247,6 @@ dependencies=(
 
 devDependencies=(
   @massimo-cassandro/eslint-config
-  @massimo-cassandro/stylelint-config
 
   @babel/core
   @babel/preset-env
@@ -157,7 +269,6 @@ devDependencies=(
   process
   purgecss-webpack-plugin
   responsive-loader
-  style-dictionary
   style-loader
   svg-url-loader
   svgo
@@ -169,12 +280,12 @@ devDependencies=(
   webpack-dev-server
   webpack-manifest-plugin
   webpack-remove-empty-scripts
-
-  # da installare solo se necessari
-  # dotenv-webpack
-  # @principalstudio/html-webpack-inject-preload file-loader
 )
 
+# pacchetti opzionali selezionati dall'utente (vedi ciclo di domande a inizio
+# script), aggiunti all'array di installazione già definito sopra
+devDependencies+=("${selectedOptionalPkgs[@]}")
+
 if [ "$DEBUG" = "TRUE" ]; then
   dependencies=( @massimo-cassandro/minimo )
   devDependencies=()
@@ -193,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" \
@@ -202,36 +316,74 @@ mkdir -p \
   "${FRONTEND_INSTALL_PATH}/error-pages"
 
 
-echo -e "${GREEN}...MINIMO FILES${NC}"
+
+
+echo -e "${GREEN}...FILES${NC}"
+
+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
+
+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 "${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
 
-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"
+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
-# index.css e collocato sulla root di installazione (non in /src)
-safe_cat "${MINIMO_PKG_DIR}/src/minimo.css" "${FRONTEND_INSTALL_PATH}/index.css"
+force_cat "${MINIMO_PKG_DIR}/src/minimo.css" "${FRONTEND_INSTALL_PATH}/css/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"
+# 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"
 
 
-# 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"
 
-# layout critical css
-safe_cat "${SOURCE_FILES_DIR}/layout-critical.css" "${FRONTEND_INSTALL_PATH}/css/layout-critical.css"
+# 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}"
+  for pkg in "${selectedOptionalPkgs[@]}"; do
+    echo -e "${YELLOW}  - $pkg${NC}"
+  done
+  echo -e "${YELLOW}Potrebbe essere necessaria una modifica alla configurazione webpack e/o postcss per utilizzare questi pacchetti.${NC}"
+fi
 
 set +C
 echo -e "\n\n${GREEN}*** END ***${NC}"

package/dev-tools/stylelint-config/README.md

@@ -0,0 +1,45 @@
+# Stylelint config
+
+My [stylelint](https://stylelint.io/) config,
+
+
+## Use
+
+Install package:
+
+```bash
+npm install @massimo-cassandro/minimo
+```
+
+Create a `stylelint.config.mjs` file and add:
+
+```javascript
+export default {
+  extends: [
+    '@massimo-cassandro/minimo/stylelint-config',
+  ],
+
+  // Files to be ignored
+  ignoreFiles: [
+    'node_modules/**/*.{css,scss}',
+    'vendor/**/*.{css,scss}',
+    'templates/**/*.{css,scss}',
+    'dist/**/*.css',
+    'build/**/*.css',
+    'public/**/*.css',
+    'test/**/*.css'
+  ],
+
+  // Overrides
+  rules: {
+    //********************** optionally for tailwind:
+    // 'at-rule-no-unknown': [
+    //   true,
+    //   'value-keyword-case': null,
+    //   '@stylistic/number-no-trailing-zeros': null
+    // ],
+    //********************** /tailwind
+  }
+};
+```
+

package/dev-tools/stylelint-config/index.js

@@ -0,0 +1,184 @@
+/** @type {import('stylelint').Config} */
+
+const tailwindAtRules = ['tailwind', 'apply', 'layer', 'variants', 'responsive', 'screen', 'config'],
+  postCSSRules = ['define-mixin', 'mixin'];
+
+export default {
+  extends: [
+    'stylelint-config-standard',
+    'stylelint-config-recess-order',
+    '@stylistic/stylelint-config'
+  ],
+  plugins: [
+    '@stylistic/stylelint-plugin'
+  ],
+  ignoreFiles: [
+    'node_modules/**/*.*',
+    'vendor/**/*.*',
+    'build/**/*.*',
+    'public/**/*.*',
+    'templates/**/*.*',
+    'dist/**/*.*'
+  ],
+  rules: {
+
+    'alpha-value-notation': null,
+    'at-rule-empty-line-before': null,
+    'at-rule-no-vendor-prefix': true,
+    'at-rule-no-unknown': [ true, { ignoreAtRules: [ ...tailwindAtRules, ...postCSSRules ] } ],
+    'color-function-notation': 'modern',
+    'color-named': 'never',
+    'comment-empty-line-before': null,
+    'custom-property-empty-line-before': null,
+    'custom-property-pattern': null,
+    'declaration-block-no-redundant-longhand-properties': null,
+    'declaration-empty-line-before': null,
+    'declaration-no-important': true,
+    'font-family-name-quotes': 'always-where-recommended',
+    'font-weight-notation': ['numeric', { ignore: ['relative'] }],
+    'function-no-unknown': [true, { ignoreFunctions: ['theme'] }],
+    'function-url-no-scheme-relative': true,
+    'function-url-quotes': 'always',
+    'hue-degree-notation': null,
+    'import-notation': null,
+    'max-nesting-depth': [3, {
+      ignore: ['pseudo-classes', 'blockless-at-rules'],
+      ignoreAtRules: [/media/, /include/],
+      ignorePseudoClasses: ['before', 'after']
+    }],
+    'media-feature-range-notation': null,
+    'media-query-no-invalid': null,
+    'no-descending-specificity': null,
+    'number-max-precision': null,
+    'property-no-vendor-prefix': true,
+    'rule-empty-line-before': null,
+    'selector-attribute-quotes': 'always',
+    'selector-class-pattern': ['^[a-z][a-z0-9\\-]*[a-z0-9]$', { resolveNestedSelectors: true }],
+    'selector-max-attribute': 2,
+    'selector-max-class': 4,
+    'selector-max-combinators': 4,
+    'selector-max-compound-selectors': 4,
+    'selector-max-id': 0,
+    'selector-max-specificity': null,
+    'selector-max-type': [3, { ignore: ['child', 'compounded', 'descendant', 'next-sibling'] }],
+    'selector-max-universal': 1,
+    'selector-no-qualifying-type': null, // https://stylelint.io/user-guide/rules/selector-no-qualifying-type/
+    'selector-no-vendor-prefix': true,
+    'selector-not-notation': null,
+    'selector-pseudo-class-no-unknown': [true, { ignorePseudoClasses: ['global'] }],
+    'shorthand-property-no-redundant-values': true,
+    'value-keyword-case': ['lower', { ignoreKeywords: ['currentColor'] }],
+    'value-no-vendor-prefix': true,
+
+    // --- Stylistic ---
+    '@stylistic/at-rule-name-space-after': 'always',
+    '@stylistic/at-rule-semicolon-space-before': 'never',
+    '@stylistic/block-closing-brace-empty-line-before': null,
+    '@stylistic/block-closing-brace-newline-after': null,
+    '@stylistic/block-opening-brace-space-before': null,
+    '@stylistic/declaration-block-semicolon-newline-before': 'never-multi-line',
+    '@stylistic/function-max-empty-lines': 2,
+    '@stylistic/function-parentheses-space-inside': 'never-single-line',
+    '@stylistic/max-empty-lines': 2,
+    '@stylistic/max-line-length': null,
+    '@stylistic/no-empty-first-line': null,
+    '@stylistic/no-missing-end-of-source-newline': null,
+    '@stylistic/number-leading-zero': 'never',
+    '@stylistic/selector-list-comma-newline-after': 'always-multi-line',
+    '@stylistic/selector-list-comma-newline-before': 'never-multi-line',
+    '@stylistic/selector-list-comma-space-after': 'always-single-line',
+    '@stylistic/selector-list-comma-space-before': 'never-single-line',
+    '@stylistic/string-quotes': 'single',
+    '@stylistic/unicode-bom': 'never',
+    '@stylistic/value-list-comma-newline-after': 'always-multi-line',
+    '@stylistic/value-list-comma-newline-before': 'never-multi-line',
+    '@stylistic/value-list-comma-space-after': null,
+    '@stylistic/value-list-max-empty-lines': 3
+  },
+  overrides: [
+    {
+      files: ['**/*.scss'],
+      plugins: ['stylelint-scss'],
+      extends: [
+        'stylelint-config-standard-scss',
+        'stylelint-config-recess-order'
+      ],
+      rules: {
+        'no-invalid-position-at-import-rule': null,
+        'scss/at-extend-no-missing-placeholder': null,
+        'scss/at-function-named-arguments': 'never',
+        'scss/at-function-parentheses-space-before': 'never',
+        'scss/at-function-pattern': '^[a-z][a-z-]*$',
+        'scss/at-if-closing-brace-newline-after': null,
+        'scss/at-if-closing-brace-space-after': null,
+        'scss/at-if-no-null': null,
+        'scss/at-mixin-argumentless-call-parentheses': 'always',
+        'scss/at-mixin-named-arguments': null,
+        'scss/at-mixin-parentheses-space-before': 'never',
+        'scss/at-mixin-pattern': null,
+        'scss/at-rule-conditional-no-parentheses': null,
+        'scss/load-no-partial-leading-underscore': true,
+        'scss/load-partial-extension': 'never',
+
+        'at-rule-no-unknown': null, // disabilita regola base per evitare conflitti
+        'scss/at-rule-no-unknown': [
+          true,
+          {
+            ignoreAtRules: [
+              ...tailwindAtRules,
+              ...postCSSRules,
+              // SCSS
+              'extend', 'include', 'if', 'else', 'function', 'at-root',
+              'use', 'forward', 'each', 'while', 'for', 'error', 'warn', 'debug', 'return'
+            ]
+          }
+        ],
+        'scss/comment-no-empty': null,
+        'scss/dimension-no-non-numeric-values': true,
+        'scss/dollar-variable-colon-space-after': 'at-least-one-space',
+        'scss/dollar-variable-colon-space-before': 'never',
+        'scss/dollar-variable-empty-line-before': null,
+        'scss/dollar-variable-no-missing-interpolation': true,
+        'scss/dollar-variable-pattern': '^[a-z][a-z-\\d]*$',
+        'scss/double-slash-comment-empty-line-before': null,
+        'scss/double-slash-comment-whitespace-inside': null,
+        'scss/no-duplicate-dollar-variables': [
+          null,
+          { ignoreInsideAtRules: ['extend', 'if', 'mixin'] }
+        ],
+        'scss/no-duplicate-mixins': true,
+        'scss/operator-no-newline-after': true,
+        'scss/operator-no-newline-before': true,
+        'scss/operator-no-unspaced': true
+      }
+    },
+    {
+      files: ['**/*.module.scss', '**/*.module.css'],
+      extends: ['stylelint-config-css-modules'],
+      rules: {
+        'selector-class-pattern': [
+          '^[a-z]+(_?[A-Z]?[a-z0-9]*)*$',
+          {
+            ignoreSelectors: [/:global/], // non funziona
+            resolveNestedSelectors: true
+          }
+        ]
+      }
+    }
+    // da testare
+    // {
+    //   files: ['**/*.module.scss', '**/*.module.css'],
+    //   extends: ['stylelint-config-css-modules'],
+    //   rules: {
+    //     'selector-class-pattern': [
+    //       '^([a-z][a-z0-9]*([A-Z][a-z0-9]*)*|[a-z][a-z0-9-]*)$',
+    //       { resolveNestedSelectors: true }
+    //     ],
+    //     'selector-pseudo-class-no-unknown': [
+    //       true,
+    //       { ignorePseudoClasses: ['global', 'local'] }
+    //     ]
+    //   }
+    // }
+  ]
+};

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;
+}