@massimo-cassandro/minimo 1.29.3 → 1.29.5

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

@@ -17,21 +17,21 @@
     "*.avif"
   ],
   "scripts": {
-    "progetto JS webpack DEV": "npm 'launchChrome' && NODE_ENV=development webpack serve --config ./webpack.config.mjs #--open-app-name 'Google Chrome'",
-    "progetto sf webpack DEV": "rm -rf ./public/_dev && NODE_ENV=development webpack --config ./frontend/webpack.config.mjs",
+    "progetto JS webpack DEV": "npm run 'launchChrome' && NODE_ENV=development webpack serve --config ./webpack.config.mjs #--open-app-name 'Google Chrome'",
+    "progetto sf webpack DEV": "rm -rf ./public/_dev && NODE_ENV=development webpack --config ./webpack.config.mjs",
     "webpack PROD": "npm run 'UPD-version' && NODE_ENV=production webpack --config ./webpack.config.mjs --stats minimal",
-    "eslint-check": "npx eslint app/ # or src/, frontend/src/ ...",
+    "eslint-check": "npx eslint app/",
     "create-favicons INIT": "npx create-favicons init",
-    "create-favicons": "npx create-favicons --dir=./favicons # o ./frontend/favicons",
-    "UPD-version": "npx update-version --no-log-v0 # --log-file=./frontend/changelog.md --log-patch --pkg=alt/path/to/package.json",
+    "create-favicons": "npx create-favicons --dir=./app/favicons",
+    "UPD-version": "npx update-version --no-log-v0 --log-file=./changelog.md # --log-patch --pkg=alt/path/to/package.json",
     "upd@m": "npx upd@m",
     "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`",
     "node server": "node serve # richiede ‘npm i serve’",
-    "build tokens": "npx buildTokens --config ./src/css/tokens-config.mjs # o ./frontend/src/css/tokens-config.mjs",
-    "check unresolved props": "npx checkUnresolvedProps --config ./src/css/tokens-config.mjs # o ./frontend/src/css/tokens-config.mjs",
+    "build tokens": "npx buildTokens --config ./app/css/tokens-config.mjs",
+    "check unresolved props": "npx checkUnresolvedProps --config ./app/css/tokens-config.mjs",
     "npm-outdated": "npm outdated",
     "npm-upd": "npm update --save"
   },

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

@@ -0,0 +1,50 @@
+{
+	"folders": [
+		{
+			"path": "."
+		}
+  ],
+  "settings": {
+
+    "cssvar.files": [
+      "app/css/custom-properties.css",
+
+      // OPEN PROPS
+      // "./node_modules/open-props/open-props.min.css", // all open-props
+
+    ],
+    // Do not ignore node_modules css files, which is ignored by default
+    // "cssvar.ignore": [], // decomment if you are using open props
+
+    // add support for autocomplete in JS or JS like files
+    "cssvar.extensions": [
+      "css", "postcss", "jsx", "tsx", "scss"
+    ],
+
+    "favorites.resources": [
+      {
+        "filePath": "node_modules/@fontsource-variable",
+        "group": "Default"
+      },
+      {
+        "filePath": "node_modules/@fontsource",
+        "group": "Default"
+      },
+      {
+        "filePath": "node_modules/@massimo-cassandro",
+        "group": "Default"
+      },
+      {
+        "filePath": "node_modules/open-props",
+        "group": "Default"
+      }
+    ],
+
+    "bootstrapIntelliSense": {
+      "enable": false,
+      "bsVersion": "5.3.7",
+      "showSuggestions": false,
+      "autoComplete": false
+    }
+  }
+}

package/dev-tools/starter-kit/source_files/favicons-readme.md

@@ -0,0 +1,5 @@
+Eseguire (dalla root del progetto):
+
+```
+npx create-favicons --dir=./app/favicons
+```

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

@@ -18,285 +18,182 @@ if [ -z "$ZSH_VERSION" ]; then
   exit 1
 fi
 
-# --no-npm: salta le installazioni npm (utile per testare rapidamente lo script)
-# --root / --frontend / --app: posizione della configurazione frontend (salta
-#   il prompt, utile per esecuzioni non interattive)
-SKIP_NPM=0
-FRONTEND_CHOICE=""
-for ARG in "$@"; do
-  case "$ARG" in
-    --no-npm) SKIP_NPM=1 ;;
-    --root) FRONTEND_CHOICE=1 ;;
-    --frontend) FRONTEND_CHOICE=2 ;;
-    --app) FRONTEND_CHOICE=3 ;;
-  esac
-done
-
-# Wrapper: esegue "npm i ..." a meno che SKIP_NPM sia attivo
-npm_i() {
-  if [ "$SKIP_NPM" = "1" ]; then
-    echo "(--no-npm) skip: npm i $*"
-  else
-    npm i "$@"
-  fi
-}
-
-# Configurazione variabili
-# BASE_URL="https://raw.githubusercontent.com/massimo-cassandro/minimo/refs/heads/main"
-
-# in locale: cat ....
-# da remoto curl -s
-
-# %:A risolve il percorso assoluto (anche con link simbolici)
-# %:h estrae l'header (ovvero la directory, come 'dirname')
 BASE_URL=${0:A:h}
 
 echo "BASE_URL: ${BASE_URL}"
 
-TEMPLATES_DIR="${BASE_URL}/templates"
-# WEBPACK_SOURCE_DIR="$BASE_URL/starter-kit"
-WEBPACK_SOURCE_DIR="$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
 set -C
 
-# Array per tracciare i file già esistenti
-BLOCKED_FILES=()
 
-# Wrapper: copia solo se il file non esiste, altrimenti registra il blocco.
-# Con terzo argomento "new", se la destinazione esiste già la copia viene
-# comunque creata con prefisso NEW- (da integrare manualmente o rimuovere).
-# Con terzo argomento "underscore", stesso comportamento ma con prefisso _
-# (usato per package.json e *.code-workspace: il file esistente non viene
-# toccato, il template arriva accanto con un _ davanti al nome, da integrare
-# o rimuovere manualmente)
+# Wrapper: copia il file, se esiste viene copiato con prefisso NEW- (da integrare manualmente o rimuovere).
 safe_cat() {
   local src="$1"
   local dest="$2"
-  local mode="$3"
   if [ ! -f "$src" ]; then
     echo -e "${RED}Sorgente mancante: $src${NC}"
     return 1
   fi
   if [ -e "$dest" ]; then
-    case "$mode" in
-      new)
-        local new_dest="$(dirname "$dest")/NEW-$(basename "$dest")"
-        cat "$src" >| "$new_dest"
-        BLOCKED_FILES+=("$dest → copiato come $new_dest")
-        ;;
-      underscore)
-        local new_dest="$(dirname "$dest")/_$(basename "$dest")"
-        cat "$src" >| "$new_dest"
-        BLOCKED_FILES+=("$dest → copiato come $new_dest")
-        ;;
-      *)
-        BLOCKED_FILES+=("$dest")
-        ;;
-    esac
+    local new_dest="$(dirname "$dest")/NEW-$(basename "$dest")"
+    cat "$src" >| "$new_dest"
   else
     cat "$src" > "$dest"
   fi
 }
 
-echo -e "${GREEN}...package.json${NC}"
-safe_cat "${BASE_URL}/package-tpl.json" package.json underscore
-
-echo -e "${GREEN}...gitignore${NC}"
-safe_cat "${TEMPLATES_DIR}/_gitignore" .gitignore new
-
-if [ -n "$FRONTEND_CHOICE" ]; then
-  choice="$FRONTEND_CHOICE"
-else
-  echo -e "\n${GREEN}Where do you want to install the frontend configuration?${NC}"
-  echo "1) Root directory"
-  echo "2) 'frontend' Directory"
-  echo "3) 'app' Directory"
-  read "?Choose (1, 2 or 3) [default: 2]: " choice < /dev/tty
-  choice=${choice:-2}
-fi
-
-if [ "$choice" = "1" ]; then
-  FRONTEND_INSTALL_PATH="."
-  echo -e "${GREEN}Files will be installed in: root directory${NC}"
-elif [ "$choice" = "3" ]; then
-  FRONTEND_INSTALL_PATH="./app"
-  echo -e "${GREEN}Files will be installed in: ./app${NC}"
-else
-  FRONTEND_INSTALL_PATH="./frontend"
-  echo -e "${GREEN}Files will be installed in: ./frontend${NC}"
-fi
-
-if [ "$FRONTEND_INSTALL_PATH" != "." ]; then
-  mkdir -p "$FRONTEND_INSTALL_PATH"
-fi
-
-
-echo -e "\n${GREEN}...config files & utilities${NC}"
-
-safe_cat "${TEMPLATES_DIR}/_browserslistrc"            .browserslistrc new
-safe_cat "${TEMPLATES_DIR}/_editorconfig"              .editorconfig new
-safe_cat "${TEMPLATES_DIR}/_prettierrc"                .prettierrc new
-safe_cat "${TEMPLATES_DIR}/_root_htaccess"             "${FRONTEND_INSTALL_PATH}/_root_htaccess"
-safe_cat "${TEMPLATES_DIR}/_root_robots.txt"           "${FRONTEND_INSTALL_PATH}/_root_robots.txt"
-safe_cat "${TEMPLATES_DIR}/CLAUDE-frontend.md"         "${FRONTEND_INSTALL_PATH}/CLAUDE.md"
-
-# jsconfig.json: sta SEMPRE nella root del progetto (è anche il file di
-# riferimento di vscode). I suoi path sono quindi relativi alla root: il
-# placeholder __FRONTEND__ viene risolto in base alla posizione scelta.
-# NB: webpack.config.mjs lo cerca in root anche quando è in una sottodirectory
-if [ "$FRONTEND_INSTALL_PATH" = "." ]; then
-  FRONTEND_REL="./"
-else
-  FRONTEND_REL="${FRONTEND_INSTALL_PATH}/"
-fi
-JSCONFIG_TPL="${TEMPLATES_DIR}/jsconfig.json"
-if [ ! -f "$JSCONFIG_TPL" ]; then
-  echo -e "${RED}Sorgente mancante: ${JSCONFIG_TPL}${NC}"
-else
-  JSCONFIG_TMP="$(mktemp)"
-  sed "s|__FRONTEND__|${FRONTEND_REL}|g" "$JSCONFIG_TPL" >| "$JSCONFIG_TMP"
-  safe_cat "$JSCONFIG_TMP" jsconfig.json new
-  rm -f "$JSCONFIG_TMP"
-fi
-
-# code-workspace: se un file .code-workspace esiste già (qualunque sia il nome),
-# il template viene copiato accanto con un _ davanti al nome esistente
-WORKSPACE_TPL="${TEMPLATES_DIR}/__project__.code-workspace"
-WORKSPACE_FILES=( *.code-workspace(N) )
-if [ ${#WORKSPACE_FILES[@]} -gt 1 ]; then
-  echo -e "${RED}Trovati più file .code-workspace (${WORKSPACE_FILES[*]}): copia saltata${NC}"
-elif [ ${#WORKSPACE_FILES[@]} -eq 0 ]; then
-  safe_cat "$WORKSPACE_TPL" __project__.code-workspace
-else
-  safe_cat "$WORKSPACE_TPL" "${WORKSPACE_FILES[1]}" underscore
+FRONTEND_INSTALL_PATH="./app"
+# se la cartella esiste già, i moduli vengono copiati in NEW-webpack-modules
+# (da integrare manualmente o rimuovere)
+if [ -d "$FRONTEND_INSTALL_PATH" ]; then
+  FRONTEND_INSTALL_PATH="./NEW-$(basename "$FRONTEND_INSTALL_PATH")"
 fi
 
+echo -e "${GREEN}Files will be installed in: '${FRONTEND_INSTALL_PATH}'${NC}"
+mkdir -p "${FRONTEND_INSTALL_PATH}"
 
-echo -e "\n${GREEN}...minimo${NC}"
-npm_i -S @massimo-cassandro/minimo
 
-echo -e "\n${GREEN}...eslint${NC}"
-npm_i -D @massimo-cassandro/eslint-config
-safe_cat "${TEMPLATES_DIR}/eslint.config.mjs" eslint.config.mjs new
 
-echo -e "\n${GREEN}...stylelint${NC}"
-npm_i -D @massimo-cassandro/stylelint-config
-safe_cat "${TEMPLATES_DIR}/stylelint.config.mjs" stylelint.config.mjs new
+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
 
-echo -e "\n${GREEN}...webpack${NC}"
-npm_i -D webpack-cli webpack-dev-server webpack-manifest-plugin webpack
-npm_i -D @babel/core @babel/preset-env babel-loader terser-webpack-plugin
-npm_i -D webpack-remove-empty-scripts copy-webpack-plugin html-loader html-webpack-plugin
-# npm_i -D @principalstudio/html-webpack-inject-preload file-loader # da installare solo se necessario
-npm_i -D postcss autoprefixer postcss-custom-media @csstools/postcss-global-data postcss-loader postcss-preset-env
-# NB: niente cssnano: la minificazione è di css-minimizer-webpack-plugin e cssnano
-# nel loader postcss eliminerebbe i commenti `purgecss ignore` prima di PurgeCSS
-npm_i -D mini-css-extract-plugin style-loader css-loader css-minimizer-webpack-plugin
-npm_i -D responsive-loader
-npm_i -D process dotenv-webpack
-npm_i -D svgo svg-url-loader svgo-loader svgo-add-viewbox mini-svg-data-uri
-npm_i -D ejs-loader
-npm_i -D purgecss-webpack-plugin glob
+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
 
-npm_i -D style-dictionary
+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"
 
-safe_cat "${WEBPACK_SOURCE_DIR}/webpack.config.mjs"   "${FRONTEND_INSTALL_PATH}/webpack.config.mjs"
-
-# cartella webpack
-WEBPACK_LOCAL_DIR="${FRONTEND_INSTALL_PATH}/webpack-modules"
-WEBPACK_MODULES_REMOTE_URL="${WEBPACK_SOURCE_DIR}/webpack-modules"
 
+echo -e "${GREEN}..WEBPACK CONFIG MODULES${NC}"
 # se la cartella esiste già, i moduli vengono copiati in NEW-webpack-modules
 # (da integrare manualmente o rimuovere)
-if [ -d "$WEBPACK_LOCAL_DIR" ]; then
-  NEW_WEBPACK_LOCAL_DIR="$(dirname "$WEBPACK_LOCAL_DIR")/NEW-$(basename "$WEBPACK_LOCAL_DIR")"
-  BLOCKED_FILES+=("$WEBPACK_LOCAL_DIR → copiata come $NEW_WEBPACK_LOCAL_DIR")
-  WEBPACK_LOCAL_DIR="$NEW_WEBPACK_LOCAL_DIR"
+if [ -d "$WEBPACK_MODULES_INSTALL_PATH" ]; then
+  WEBPACK_MODULES_INSTALL_PATH="./NEW-$(basename "$WEBPACK_MODULES_INSTALL_PATH")"
 fi
 
-mkdir -p "$WEBPACK_LOCAL_DIR"
+mkdir -p "$WEBPACK_MODULES_INSTALL_PATH"
 
 # copia tutti i file presenti in webpack-modules,
-for FILE in "${WEBPACK_MODULES_REMOTE_URL}"/*; do
+for FILE in "${WEBPACK_MODULES_SOURCE_PATH}"/*; do
   [ -f "$FILE" ] || continue
-  safe_cat "$FILE" "${WEBPACK_LOCAL_DIR}/$(basename "$FILE")"
+  safe_cat "$FILE" "${WEBPACK_MODULES_INSTALL_PATH}/$(basename "$FILE")"
+done
+
+
+echo -e "\n${GREEN}...NODE MODULES${NC}"
+
+dependencies=(
+  @massimo-cassandro/minimo
+)
+
+devDependencies=(
+  @massimo-cassandro/eslint-config
+  @massimo-cassandro/stylelint-config
+
+  @babel/core
+  @babel/preset-env
+  @csstools/postcss-global-data
+  autoprefixer
+  babel-loader
+  copy-webpack-plugin
+  css-loader
+  css-minimizer-webpack-plugin
+  ejs-loader
+  glob
+  html-loader
+  html-webpack-plugin
+  mini-css-extract-plugin
+  mini-svg-data-uri
+  postcss
+  postcss-custom-media
+  postcss-loader
+  postcss-preset-env
+  process
+  purgecss-webpack-plugin
+  responsive-loader
+  style-dictionary
+  style-loader
+  svg-url-loader
+  svgo
+  svgo-add-viewbox
+  svgo-loader
+  terser-webpack-plugin
+  webpack
+  webpack-cli
+  webpack-dev-server
+  webpack-manifest-plugin
+  webpack-remove-empty-scripts
+
+  # da installare solo se necessari
+  # dotenv-webpack
+  # @principalstudio/html-webpack-inject-preload file-loader
+)
+
+for pkg in "${dependencies[@]}"; do
+  npm i -S "$pkg"
 done
 
-echo -e "\n${GREEN}Creating your frontend application's folder structure${NC}"
+for pkg in "${devDependencies[@]}"; do
+  npm i -S "$pkg"
+done
 
-# La struttura viene creata nella posizione scelta a inizio script, coerente con
-# i percorsi attesi da webpack.config.mjs (`./src/...`, `./favicons/output`,
-# `./error-pages/...`), da jsconfig.json (@css, @src, @icons, @imgs) e da
-# postcss.config.mjs (`../src/css/custom-media.css`)
+echo -e "\n${GREEN}...creating default folders${NC}"
 mkdir -p \
-  "${FRONTEND_INSTALL_PATH}/src/css" \
-  "${FRONTEND_INSTALL_PATH}/src/tpl" \
+  "${FRONTEND_INSTALL_PATH}/src" \
+  "${FRONTEND_INSTALL_PATH}/css" \
+  "${FRONTEND_INSTALL_PATH}/tpl" \
   "${FRONTEND_INSTALL_PATH}/icons" \
   "${FRONTEND_INSTALL_PATH}/imgs" \
   "${FRONTEND_INSTALL_PATH}/favicons" \
   "${FRONTEND_INSTALL_PATH}/error-pages"
 
-# template html di webpack (HtmlWebpackPlugin: `./src/tpl/index.ejs`)
-safe_cat "${WEBPACK_SOURCE_DIR}/webpack-template.ejs" "${FRONTEND_INSTALL_PATH}/src/tpl/index.ejs"
 
+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) e, in
-# fallback, la dir da cui è lanciato questo script (repo o pacchetto estratto)
-MINIMO_PKG_DIR=""
-for CANDIDATE in "./node_modules/@massimo-cassandro/minimo" "${BASE_URL}/../.."; do
-  if [ -f "${CANDIDATE}/src/custom-properties.css" ]; then
-    MINIMO_PKG_DIR="$CANDIDATE"
-    break
-  fi
-done
+# installato in node_modules (stessa versione che userà il progetto)
+MINIMO_PKG_DIR=./node_modules/@massimo-cassandro/minimo
 
-if [ -z "$MINIMO_PKG_DIR" ]; then
-  if [ "$SKIP_NPM" = "1" ]; then
-    echo -e "${YELLOW}(--no-npm) css di base, index.css, tokens-config e config favicons non copiati: npm i è stato saltato, quindi @massimo-cassandro/minimo non è ancora installato in node_modules (rilancia lo script senza --no-npm per completare la copia)${NC}"
-    BLOCKED_FILES+=("css di base + index.css + tokens-config.mjs + create-favicons-cfg.mjs → saltati (--no-npm)")
-  else
-    echo -e "${RED}Sorgenti di minimo non trovati (né in ./node_modules/@massimo-cassandro/minimo né in ${BASE_URL}/../..): css di base, index.css, tokens-config e config favicons non copiati${NC}"
-    BLOCKED_FILES+=("css di base + index.css + tokens-config.mjs + create-favicons-cfg.mjs → sorgenti minimo non trovati")
-  fi
-else
-  echo "sorgenti minimo: ${MINIMO_PKG_DIR}"
+safe_cat "${MINIMO_PKG_DIR}/src/custom-properties.css" "${FRONTEND_INSTALL_PATH}/css/${FILE}"
+safe_cat "${MINIMO_PKG_DIR}/src/custom-media.css" "${FRONTEND_INSTALL_PATH}/css/${FILE}"
+safe_cat "${MINIMO_PKG_DIR}/src/fonts.css" "${FRONTEND_INSTALL_PATH}/css/${FILE}"
 
-  # css di partenza del progetto: solo i file destinati a essere personalizzati
-  for FILE in custom-properties.css custom-media.css fonts.css; do
-    safe_cat "${MINIMO_PKG_DIR}/src/${FILE}" "${FRONTEND_INSTALL_PATH}/src/css/${FILE}"
-  done
+# 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"
 
-  # config di build-tokens: collocato accanto al css generato (custom-properties.css).
-  # NB: i percorsi relativi nel file vanno adattati alla sua posizione effettiva
-  safe_cat "${MINIMO_PKG_DIR}/design-tokens/tokens-config-sample.mjs" "${FRONTEND_INSTALL_PATH}/src/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"
 
-  # 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"
 
-  # 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"
-fi
 
 # entry css critical (inline nei template html) e entry js, sulla root di
 # installazione accanto a index.css
-safe_cat "${TEMPLATES_DIR}/layout-critical.css" "${FRONTEND_INSTALL_PATH}/src/css/layout-critical.css"
-safe_cat "${TEMPLATES_DIR}/app_index.js"       "${FRONTEND_INSTALL_PATH}/index.js"
+safe_cat "${SOURCE_FILES_DIR}/app_index.js" "${FRONTEND_INSTALL_PATH}/index.js"
 
-# favicons: istruzioni d'uso di `npx create-favicons`
-safe_cat "${TEMPLATES_DIR}/favicons-readme.md" "${FRONTEND_INSTALL_PATH}/favicons/readme.md"
+# layout critical css
+safe_cat "${SOURCE_FILES_DIR}/layout-critical.css" "${FRONTEND_INSTALL_PATH}/css/layout-critical.css"
 
-set +C
-
-# Riepilogo finale dei file già esistenti
-if [ ${#BLOCKED_FILES[@]} -gt 0 ]; then
-  echo -e "\n${YELLOW}*** File già esistenti (non copiati o copiati con prefisso NEW-/_): ***${NC}"
-  for F in "${BLOCKED_FILES[@]}"; do
-    echo -e "${YELLOW}  ✗ $F${NC}"
-  done
-else
-  echo -e "\n${GREEN}Nessun file bloccato.${NC}"
-fi
 
+set +C
 echo -e "\n\n${GREEN}*** END ***${NC}"

package/dev-tools/starter-kit/{webpack-modules → webpack-config-modules}/postcss.config.mjs

@@ -29,13 +29,13 @@ export default (loaderContext) => {
     // in ogni asset e interferirebbe con il purge, vedi sopra)
     globalData({
       files: [
-        path.resolve(__dirname, '../src/css/custom-media.css'),
+        path.resolve(__dirname, '../app/css/custom-media.css'),
       ]
     }),
 
     // jitProps({
     //   files: [
-    //     path.resolve(__dirname, '../src/css/custom-properties.css'),
+    //     path.resolve(__dirname, '../app/css/custom-properties.css'),
     //   ]
     // }),
 

package/dev-tools/starter-kit/webpack-template.ejs

@@ -1,5 +1,5 @@
 <!DOCTYPE html>
-<!-- template html di webpack: installato in <frontend>/src/tpl/index.ejs
+<!-- template html di webpack: installato in app/tpl/index.ejs
      (vedi HtmlWebpackPlugin in webpack.config.mjs).
      I require sono relativi a QUESTO file. -->
 <html lang="it">
@@ -9,7 +9,7 @@
     <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
 
     <!-- favicons (generate da `npx create-favicons`, vedi package.json) -->
-    <%= require('../../favicons/output/favicons.incl.ejs')({}) %>
+    <%= require('../favicons/output/favicons.incl.ejs')({}) %>
 
     <title><%= htmlWebpackPlugin.options.title %></title>
     <!-- <base href="<%= htmlWebpackPlugin.options.base %>"> -->

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

@@ -13,22 +13,22 @@ import TerserPlugin from 'terser-webpack-plugin';
 import CssMinimizerPlugin from 'css-minimizer-webpack-plugin';
 import MiniCssExtractPlugin from 'mini-css-extract-plugin';
 import CopyWebpackPlugin from 'copy-webpack-plugin';
-import Dotenv from 'dotenv-webpack';
+// import Dotenv from 'dotenv-webpack';
 import RemoveEmptyScriptsPlugin from 'webpack-remove-empty-scripts';
 // import { WebpackManifestPlugin } from 'webpack-manifest-plugin';
 // import HtmlWebpackInjectAttributesPlugin from 'html-webpack-inject-attributes-plugin';
 
-import { cssRules } from './webpack-modules/css-rules.mjs';
-import { createPurgeCSSPlugins } from './webpack-modules/purgecss-setup.mjs';
-import { getJsConfigAliases } from './webpack-modules/get-jsConfig-aliases.mjs';
-import { svgRules } from './webpack-modules/svg-rules.mjs';
+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';
 
 // --- config ---
 const __filename = fileURLToPath(import.meta.url)
   ,__dirname = path.dirname(__filename);
 
 // 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. ./frontend):
+// 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));
@@ -36,21 +36,23 @@ const fromProjectRoot = (relPath) => {
 };
 
 const isDevelopment = process.env.NODE_ENV === 'development'
+  ,devServerPort = 5704
+  // ,apiPort = 8104
   ,useSass = false
   ,inlineCssInDevMode = true
   ,useSvgo = true
   ,useSvgr = false // svg per react
-  ,svgoConfig = useSvgo? (await import('./webpack-modules/svgo.config.mjs')).default : null
-  ,postcssConfig_path = path.resolve(__dirname, './webpack-modules/postcss.config.mjs')
+  ,svgoConfig = useSvgo? (await import('./webpack-config-modules/svgo.config.mjs')).default : null
+  ,postcssConfig_path = path.resolve(__dirname, './webpack-config-modules/postcss.config.mjs')
   // dir di output: relativa a QUESTO file ('../build' se il frontend è in una
   // sottodirectory, './build' se webpack.config.mjs è nella root del progetto)
-  ,output_dir = path.resolve(__dirname, '../build')
+  ,output_dir = path.resolve(__dirname, './build')
   // ,output_dir = isDevelopment? '_dev' : 'build' // symfony
   // dir delle favicons generate da `npx create-favicons` (vedi package.json):
   // il path assoluto serve a CopyWebpackPlugin/HtmlWebpackPlugin (i path
   // relativi sarebbero risolti dal cwd, non da questo file), mentre la regexp
   // resta relativa perché viene confrontata con i path dei moduli
-  ,favicons_path = path.resolve(__dirname, './favicons/output')
+  ,favicons_path = path.resolve(__dirname, './app/favicons/output')
   ,favicons_path_regexp = /favicons\/output/ // source pattern per le favicons (regexp o null)
   // NB: jsconfig.json va tenuto in questa stessa dir (gli alias sono risolti
   // a partire dalla sua posizione)
@@ -95,9 +97,10 @@ const shared_chunk_paths = (module) => {
   const sep = '[\\\\/]'; // stringa che produce [\\/] nel pattern
   const pathsRegexp = new RegExp([
     'node_modules',
-    'frontend/src/js',
-    'frontend/src/web-components',
-    'frontend/src/components',
+    'app/js',
+    'app/src',
+    'app/src/web-components',
+    'app/src/components',
   ].map(p => `${sep}${p.replace(/\//g, sep)}${sep}`).join('|'));
 
   return pathsRegexp.test(module.nameForCondition?.() ?? '');
@@ -136,7 +139,7 @@ const CopyWebpackPluginPatterns = [
 ];
 
 // =>> PurgeCSS
-// Istanze e opzioni sono in webpack-modules/purgecss-setup.mjs: qui restano
+// Istanze e opzioni sono in webpack-config-modules/purgecss-setup.mjs: qui restano
 // solo i flag e i dati di progetto (vedi createPurgeCSSPlugins nei `plugins`).
 
 // recupero metadata immagini
@@ -176,11 +179,11 @@ const config = {
   },
 
   // https://webpack.js.org/configuration/dotenv/
-  dotenv: {
-    prefix: 'APP_',
-    dir: '/',
-    template: ['.env', '.env.development'] //, '.env.local', '.env.[mode]', '.env.[mode].local'],
-  },
+  // dotenv: {
+  //   prefix: 'APP_',
+  //   dir: '/',
+  //   template: ['.env', '.env.development'] //, '.env.local', '.env.[mode]', '.env.[mode].local'],
+  // },
 
   devtool: isDevelopment ? 'inline-source-map' : false,
 
@@ -252,34 +255,30 @@ const config = {
       directory: path.join(__dirname, '/'),
       serveIndex: true
     },
+    open: { app: { name: 'Google Chrome' } },
+    compress: true,
+    hot: true,
+    port: devServerPort,
     /*
     proxy: [
       {
-        // /login, /logout (redirect Google) e /api/... (fetch AJAX) vanno
-        // inoltrati al server PHP reale (npm run "php server", vedi
-        // package.json e app/router.php), che webpack-dev-server non può
-        // eseguire da solo.
-        context: ['/api', '/login', '/logout'],
-        target: process.env.PHP_BASE_URL || 'http://localhost:8000'
+        context: ['/api'],
+        target: process.env.API_URL || `http://localhost:${apiPort}`
       }
     ],
     static: false,
     */
-    open: { app: { name: 'Google Chrome' } },
-    compress: true,
-    hot: true,
-    port: 5700
   },
 
   // =>> plugins
   plugins: [
     // =>> plugins: Dotenv
-    new Dotenv({
-      path: isDevelopment ? './.env.development' : './.env',
-      expand: true,
-      ignoreStub: true,
-      allowEmptyValues: true
-    }),
+    // new Dotenv({
+    //   path: isDevelopment ? './.env.development' : './.env',
+    //   expand: true,
+    //   ignoreStub: true,
+    //   allowEmptyValues: true
+    // }),
     new webpack.ProvidePlugin({
       process: 'process/browser.js'
     }),
@@ -404,7 +403,7 @@ const config = {
     // =>> plugins: PurgeCSSPlugin (per ultimo, attivo anche in dev)
     // https://github.com/FullHuman/purgecss/tree/main/packages/purgecss-webpack-plugin
     // https://purgecss.com/configuration.html
-    // istanze e opzioni in webpack-modules/purgecss-setup.mjs (qui solo flag/dati progetto)
+    // istanze e opzioni in webpack-config-modules/purgecss-setup.mjs (qui solo flag/dati progetto)
     // `usePurgeCss: false` disattiva il purge per intero (utile per isolare rapidamente
     // eventuali problemi legati ad esso); `purgeCSSOptions` (variables/keyframes/debug,
     // vedi sopra) si applica solo quando è attivo
@@ -460,7 +459,7 @@ const config = {
 
         // elenco generato: usi di var() nei blocchi `purgecss ignore` e nei css
         // shadow-DOM/`?raw`, override cross-asset (seeds), con chiusura transitiva
-        // delle dipendenze (vedi webpack-modules/purgecss-variables-safelist.mjs)
+        // delle dipendenze (vedi webpack-config-modules/purgecss-variables-safelist.mjs)
         variablesSafelist: {
           declarationGlobs: [
             path.resolve(__dirname, './index.css'), // entry css di default (vedi starter-install.sh)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@massimo-cassandro/minimo",
-  "version": "1.29.3",
+  "version": "1.29.5",
   "description": "Light css framework & utilities",
   "type": "module",
   "main": "./index.js",
@@ -96,7 +96,7 @@
     "@massimo-cassandro/eslint-config": "^3.0.16",
     "@massimo-cassandro/stylelint-config": "^2.3.15",
     "@types/node": "^26.2.0",
-    "jsdom": "^29.1.1",
+    "jsdom": "^30.0.1",
     "style-dictionary": "^5.5.1"
   },
   "dependencies": {

package/src/components/modal-popup/modal-popup.js

@@ -40,7 +40,7 @@ function closeDialog(el) {
  *
  * @param {Object} params
  * @param {string | null} [params.dialogExtraClassName=null] - Extra class added to the dialog element. (default: null)
- * @param {string | DomBuilderItem[] | null} [params.content=null] - Plain text, HTML, or a domBuilder array. (default: null)
+ * @param {string | DomBuilderItem | DomBuilderItem[] | null} [params.content=null] - Plain text, HTML, a domBuilder object, or a domBuilder array. (default: null)
  * @param {string | null} [params.contentExtraClassName=null] - Extra class added to the content wrapper. (default: null)
  * @param {HTMLElement | null} [params.triggerElement=null] - Optional element that triggered the popup; when set, `aria-haspopup`, `aria-controls` and `aria-expanded` are managed on it. (default: null)
  * @param {boolean} [params.addFocus=true] - if true, dialog receives focus after opening (default: true)
@@ -58,8 +58,8 @@ function closeDialog(el) {
  * @param {((el: HTMLDialogElement) => void) | null} [params.closeCallback=null] - Called with the dialog element just before it is removed, receives the dialog element (`closeCallback(dialogEl)`). NB: `dialogEl` is removed immediately after closing. (default: null)
  * @param {((data: *, el: Element) => void) | null} [params.ajaxCallback=null] - Called with the Ajax response and the content element. (default: null)
  * @param {boolean} [params.addScrollbarPadding=false] - Adds right padding to compensate for the scrollbar. (default: false)
- * @param {string | DomBuilderItem[] | null} [params.headerContent=null] - Header content: plain text, HTML, or a domBuilder array. (default: null)
- * @param {string | DomBuilderItem[] | null} [params.footerContent=null] - Footer content: plain text, HTML, or a domBuilder array. (default: null)
+ * @param {string | DomBuilderItem | DomBuilderItem[] | null} [params.headerContent=null] - Header content: plain text, HTML, a domBuilder object, or a domBuilder array. (default: null)
+ * @param {string | DomBuilderItem | DomBuilderItem[] | null} [params.footerContent=null] - Footer content: plain text, HTML, a domBuilder object, or a domBuilder array. (default: null)
  * @returns {HTMLDialogElement} The dialog element.
  */
 
@@ -84,7 +84,7 @@ export function modalPopup({
   /** iframe url */
   iframeUrl = null,
 
-  /** content: plain text, html or domBuilder array */
+  /** content: plain text, html, domBuilder object or domBuilder array */
   content = null,
 
   /** Ajax url and callback.
@@ -98,13 +98,13 @@ export function modalPopup({
   closeCallback = null,
   addScrollbarPadding = false, // adds extra right padding to compensate for the scrollbar
 
-  /** header content: plain text, HTML or domBuilder array */
+  /** header content: plain text, HTML, domBuilder object or domBuilder array */
   headerContent = null,
 
   /** extra classname added to header */
   headerExtraClassName = null,
 
-  /** footer content: plain text, HTML or domBuilder array */
+  /** footer content: plain text, HTML, domBuilder object or domBuilder array */
   footerContent = null,
 
   /** extra classname added to footer */
@@ -120,6 +120,17 @@ export function modalPopup({
     throw '[modalContent] parametri `content`, `ajaxUrl`/ `ajaxCallback` e `iframeUrl` mancanti';
   }
 
+  // allow a single domBuilder object (in addition to a domBuilder array) by wrapping it in an array
+  if(content != null && typeof content === 'object' && !Array.isArray(content)) {
+    content = [content];
+  }
+  if(headerContent != null && typeof headerContent === 'object' && !Array.isArray(headerContent)) {
+    headerContent = [headerContent];
+  }
+  if(footerContent != null && typeof footerContent === 'object' && !Array.isArray(footerContent)) {
+    footerContent = [footerContent];
+  }
+
   let mode;
   if(content != null && Array.isArray(content)) {
     mode = 'domBuilder';

package/src/components/modal-popup/modal-popup.minimo.tokens.mjs

@@ -52,7 +52,7 @@ export default {
     border: {
       radius: {
         $type: 'dimension',
-        $value: '{size.base}',
+        $value: '{radius.base}',
       }
     },
 

package/src/custom-properties.css

@@ -278,7 +278,7 @@
 
   --mpopup-backdrop-color: rgb(0 0 0 / .6);
   --mpopup-background-color: var(--body-background-color);
-  --mpopup-border-radius: var(--size-base);
+  --mpopup-border-radius: var(--radius-base);
   --mpopup-btn-close-size: 1.6rem;
   --mpopup-content-padding: var(--size-base) var(--size-sm) var(--size-sm);
   --mpopup-content-scrollbar-padding-i-end: var(--size-md);

package/src/minimo.css

@@ -1,9 +1,9 @@
 /* decomment if you want to use layers. see https://developer.mozilla.org/en-US/docs/Web/CSS/Reference/At-rules/@layer */
 /* @layer reset, base, components, utilities, project, overrides; */
 
-/* @import '@src/fonts.css'; */
-/* @import '@src/css/custom-media.css'; */ /* managed by postcss */
-/* @import '@src/custom-properties.css' layer('base'); */ /* managed by postcss-jit-props */
+/* @import '@css/fonts.css'; */
+/* @import '@css/custom-media.css'; */ /* managed by postcss */
+/* @import '@css/custom-properties.css' layer('base'); */ /* managed by postcss-jit-props */
 
 @import '@minimo/css/reset.css';
 @import '@minimo/css/layout-base.css';

package/dev-tools/starter-kit/templates/__project__.code-workspace

@@ -1,94 +0,0 @@
-{
-	"folders": [
-		{
-			"path": "."
-		}
-  ],
-  "settings": {
-
-    "cssvar.files": [
-      "frontend/src/css/custom-properties.css", // project props (frontend in sottodirectory)
-      // "src/css/custom-properties.css", // project props (frontend nella root)
-
-      // OPEN PROPS
-      // "./node_modules/open-props/open-props.min.css", // all open-props
-
-      // "./node_modules/open-props/animations.min.css",
-      // "./node_modules/open-props/aspects.min.css",
-      // "./node_modules/open-props/borders.min.css",
-      // "./node_modules/open-props/buttons.dark.min.css",
-      // "./node_modules/open-props/buttons.light.min.css",
-      // "./node_modules/open-props/buttons.min.css",
-      // "./node_modules/open-props/durations.min.css",
-      // "./node_modules/open-props/easings.min.css",
-      // "./node_modules/open-props/fonts.min.css",
-      // "./node_modules/open-props/gradients.min.css",
-      // "./node_modules/open-props/masks.corner-cuts.min.css",
-      // "./node_modules/open-props/masks.edges.min.css",
-      // "./node_modules/open-props/media.min.css",
-      // "./node_modules/open-props/normalize.dark.min.css",
-      // "./node_modules/open-props/normalize.light.min.css",
-      // "./node_modules/open-props/normalize.min.css",
-      // "./node_modules/open-props/sizes.min.css",
-      // "./node_modules/open-props/supports.min.css",
-      // "./node_modules/open-props/theme.dark.switch.min.css",
-      // "./node_modules/open-props/theme.light.switch.min.css",
-      // "./node_modules/open-props/zindex.min.css",
-
-      // "./node_modules/open-props/colors.min.css",
-      // "./node_modules/open-props/colors-hsl.min.css",
-      // "./node_modules/open-props/colors-hsl.shadow.min.css",
-      // "./node_modules/open-props/colors-oklch.min.css",
-      // "./node_modules/open-props/colors-oklch.shadow.min.css",
-      // "./node_modules/open-props/oklch-hues.min.css",
-      // "./node_modules/open-props/oklch-hues.shadow.min.css",
-
-      // "./node_modules/open-props/shadows.min.css",
-      // "./node_modules/open-props/animations.shadow.min.css",
-      // "./node_modules/open-props/aspects.shadow.min.css",
-      // "./node_modules/open-props/borders.shadow.min.css",
-      // "./node_modules/open-props/colors.shadow.min.css",
-      // "./node_modules/open-props/easings.shadow.min.css",
-      // "./node_modules/open-props/fonts.shadow.min.css",
-      // "./node_modules/open-props/gradients.shadow.min.css",
-      // "./node_modules/open-props/normalize.shadow.min.css",
-      // "./node_modules/open-props/shadows.shadow.min.css",
-      // "./node_modules/open-props/sizes.shadow.min.css",
-      // "./node_modules/open-props/zindex.shadow.min.css",
-
-    ],
-    // Do not ignore node_modules css files, which is ignored by default
-    // "cssvar.ignore": [], // decomment if you are using open props
-
-    // add support for autocomplete in JS or JS like files
-    "cssvar.extensions": [
-      "css", "postcss", "jsx", "tsx", "scss"
-    ],
-
-    "favorites.resources": [
-      {
-        "filePath": "node_modules/@fontsource-variable",
-        "group": "Default"
-      },
-      {
-        "filePath": "node_modules/@fontsource",
-        "group": "Default"
-      },
-      {
-        "filePath": "node_modules/@massimo-cassandro",
-        "group": "Default"
-      },
-      {
-        "filePath": "node_modules/open-props",
-        "group": "Default"
-      }
-    ],
-
-    "bootstrapIntelliSense": {
-      "enable": false,
-      "bsVersion": "5.3.7",
-      "showSuggestions": false,
-      "autoComplete": false
-    }
-  }
-}

package/dev-tools/starter-kit/templates/favicons-readme.md

@@ -1,5 +0,0 @@
-Eseguire (dalla root del progetto):
-
-```
-npx create-favicons --dir=./favicons # o ./frontend/favicons, ./app/favicons
-```