@massimo-cassandro/minimo 1.32.3 → 1.33.0

package/dev-tools/starter-kit/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/CLAUDE-frontend.md

@@ -12,3 +12,4 @@
 - 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
 - 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/_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/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/starter-install.sh

@@ -27,6 +27,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}"
@@ -67,6 +126,27 @@ 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
+}
+
 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
@@ -85,8 +165,8 @@ 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_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
@@ -134,7 +214,6 @@ dependencies=(
 
 devDependencies=(
   @massimo-cassandro/eslint-config
-  @massimo-cassandro/stylelint-config
 
   @babel/core
   @babel/preset-env
@@ -157,7 +236,6 @@ devDependencies=(
   process
   purgecss-webpack-plugin
   responsive-loader
-  style-dictionary
   style-loader
   svg-url-loader
   svgo
@@ -169,12 +247,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=()
@@ -232,6 +310,22 @@ safe_cat "${SOURCE_FILES_DIR}/app_index.js" "${FRONTEND_INSTALL_PATH}/index.js"
 safe_cat "${SOURCE_FILES_DIR}/layout-critical.css" "${FRONTEND_INSTALL_PATH}/css/layout-critical.css"
 
 
+# copia tutti i file presenti in ${SOURCE_FILES_DIR}/_private,
+echo -e "${GREEN}..._PRIVATE FILES${NC}"
+mkdir -p "_private"
+for FILE in "${SOURCE_FILES_DIR}/_private"/*; do
+  [ -f "$FILE" ] || continue
+  safe_cat_with_ports "$FILE" "_private/$(basename "$FILE")"
+done
+
+
+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/starter-kit/webpack.config.mjs

@@ -36,8 +36,8 @@ const fromProjectRoot = (relPath) => {
 };
 
 const isDevelopment = process.env.NODE_ENV === 'development'
-  ,devServerPort = 570x
-  // ,apiPort = 800x
+  ,devServerPort = [[port5700]]
+  // ,apiPort = [[port8000]]
   ,useSass = false
   ,inlineCssInDevMode = true
   ,useSvgo = true
@@ -643,18 +643,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

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/package.json

@@ -1,12 +1,13 @@
 {
   "name": "@massimo-cassandro/minimo",
-  "version": "1.32.3",
+  "version": "1.33.0",
   "description": "Light css framework & utilities",
   "type": "module",
   "main": "./index.js",
   "exports": {
     ".": "./index.js",
     "./charts": "./charts/index.js",
+    "./stylelint-config": "./dev-tools/stylelint-config/index.js",
     "./css/*": "./src/css/*.css",
     "./tokens/*": "./design-tokens/tokens/*",
     "./*": "./*"
@@ -94,7 +95,6 @@
   },
   "devDependencies": {
     "@massimo-cassandro/eslint-config": "^3.0.16",
-    "@massimo-cassandro/stylelint-config": "^2.3.15",
     "@types/node": "^26.2.0",
     "jsdom": "^30.0.1",
     "style-dictionary": "^5.5.1"
@@ -102,9 +102,18 @@
   "dependencies": {
     "@inquirer/input": "^5.1.2",
     "@inquirer/select": "^5.2.1",
+    "@stylistic/stylelint-config": "^5.0.0",
+    "@stylistic/stylelint-plugin": "^5.3.0",
     "clipboardy": "^5.3.2",
     "sharp": "^0.35.3",
     "sharp-ico": "^0.1.5",
+    "stylelint": "^17.15.0",
+    "stylelint-config-css-modules": "^4.6.0",
+    "stylelint-config-recess-order": "^7.8.0",
+    "stylelint-config-standard": "^40.0.0",
+    "stylelint-config-standard-scss": "^17.0.0",
+    "stylelint-order": "^8.1.1",
+    "stylelint-scss": "^7.2.0",
     "svgo": "^4.0.2"
   },
   "directories": {

package/src/custom-properties.css

@@ -222,6 +222,13 @@
   --inner-nav-gap: var(--size-lg);
   --inner-nav-margin-block: var(--size-base);
 
+  --jt-info-color: var(--text-muted);
+  --jt-info-font-size: var(--font-size-sm);
+  --jt-info-gap: var(--size-sm);
+  --jt-info-outer-padding-block-end: var(--size-xs);
+  --jt-search-max-width: 20rem;
+  --jt-wrapper-margin-block: var(--size-md);
+
   --line-height-base: 1.5;
   --line-height-sm: 1.4;
   --line-height-xs: 1.25;