@massimo-cassandro/minimo 1.24.11 → 1.25.0

package/design-tokens/tokens-config-sample.mjs

@@ -81,6 +81,10 @@ const config = {
       name: 'LAYOUT',
       prefixes: ['body', 'layout'],
     },
+    {
+      name: 'UI',
+      prefixes: ['ui'],
+    },
   ],
 
 

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

@@ -3,8 +3,8 @@
 # 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:
-# i file esistenti vengono saltati o copiati con prefisso NEW-, i merge di
-# package.json e *.code-workspace non duplicano le chiavi già presenti.
+# i file esistenti vengono saltati o copiati con prefisso NEW- (o _ per
+# package.json e *.code-workspace).
 # Ogni modifica futura deve conservare questa proprietà.
 
 RED='\033[0;31m'
@@ -19,8 +19,8 @@ if [ -z "$ZSH_VERSION" ]; then
 fi
 
 # --no-npm: salta le installazioni npm (utile per testare rapidamente lo script)
-# --root / --frontend: posizione della configurazione frontend (salta il prompt,
-#   utile per esecuzioni non interattive)
+# --root / --frontend / --app: posizione della configurazione frontend (salta
+#   il prompt, utile per esecuzioni non interattive)
 SKIP_NPM=0
 FRONTEND_CHOICE=""
 for ARG in "$@"; do
@@ -28,6 +28,7 @@ for ARG in "$@"; do
     --no-npm) SKIP_NPM=1 ;;
     --root) FRONTEND_CHOICE=1 ;;
     --frontend) FRONTEND_CHOICE=2 ;;
+    --app) FRONTEND_CHOICE=3 ;;
   esac
 done
 
@@ -64,7 +65,11 @@ 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)
+# 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)
 safe_cat() {
   local src="$1"
   local dest="$2"
@@ -74,38 +79,28 @@ safe_cat() {
     return 1
   fi
   if [ -e "$dest" ]; then
-    if [ "$mode" = "new" ]; then
-      local new_dest="$(dirname "$dest")/NEW-$(basename "$dest")"
-      cat "$src" >| "$new_dest"
-      BLOCKED_FILES+=("$dest → copiato come $new_dest")
-    else
-      BLOCKED_FILES+=("$dest")
-    fi
+    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
   else
     cat "$src" > "$dest"
   fi
 }
 
 echo -e "${GREEN}...package.json${NC}"
-if [ ! -f package.json ]; then
-  safe_cat "${TEMPLATES_DIR}/package-tpl.json" package.json
-elif [ ! -f "${TEMPLATES_DIR}/package-tpl.json" ]; then
-  echo -e "${RED}Sorgente mancante: ${TEMPLATES_DIR}/package-tpl.json${NC}"
-else
-  # package.json esistente: merge con il template, aggiungendo in fondo
-  # le chiavi del template prefissate con '_' (ordine originale preservato)
-  node -e '
-    const fs = require("fs");
-    const existing = JSON.parse(fs.readFileSync("package.json", "utf8"));
-    const tpl = JSON.parse(fs.readFileSync(process.argv[1], "utf8"));
-    for (const [key, value] of Object.entries(tpl)) {
-      existing["_" + key] = value;
-    }
-    fs.writeFileSync("package.json", JSON.stringify(existing, null, 2) + "\n");
-  ' "${TEMPLATES_DIR}/package-tpl.json"
-  echo -e "${YELLOW}package.json esistente: chiavi del template aggiunte in fondo con prefisso '_' (da integrare o rimuovere)${NC}"
-  BLOCKED_FILES+=("package.json → merge: chiavi template aggiunte con prefisso \`_\`")
-fi
+safe_cat "${BASE_URL}/package-tpl.json" package.json underscore
 
 echo -e "${GREEN}...gitignore${NC}"
 safe_cat "${TEMPLATES_DIR}/_gitignore" .gitignore new
@@ -116,20 +111,24 @@ else
   echo -e "\n${GREEN}Where do you want to install the frontend configuration?${NC}"
   echo "1) Root directory"
   echo "2) 'frontend' Directory"
-  read "?Choose (1 or 2) [default: 1]: " choice < /dev/tty
-  choice=${choice:-1}
+  echo "3) 'app' Directory"
+  read "?Choose (1, 2 or 3) [default: 2]: " choice < /dev/tty
+  choice=${choice:-2}
 fi
 
-if [ "$choice" = "2" ]; then
-  FRONTEND_INSTALL_PATH="./frontend"
-  echo -e "${GREEN}Files will be installed in: ./frontend${NC}"
-else
+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" = "./frontend" ]; then
-  mkdir -p frontend
+if [ "$FRONTEND_INSTALL_PATH" != "." ]; then
+  mkdir -p "$FRONTEND_INSTALL_PATH"
 fi
 
 
@@ -138,8 +137,8 @@ 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"             _root_htaccess
-safe_cat "${TEMPLATES_DIR}/_root_robots.txt"           _root_robots.txt
+safe_cat "${TEMPLATES_DIR}/_root_htaccess"             "${FRONTEND_INSTALL_PATH}/_root_htaccess"
+safe_cat "${TEMPLATES_DIR}/_root_robots.txt"           "${FRONTEND_INSTALL_PATH}/_root_robots.txt"
 
 # jsconfig.json: sta SEMPRE nella root del progetto (è anche il file di
 # riferimento di vscode). I suoi path sono quindi relativi alla root: il
@@ -148,7 +147,7 @@ safe_cat "${TEMPLATES_DIR}/_root_robots.txt"           _root_robots.txt
 if [ "$FRONTEND_INSTALL_PATH" = "." ]; then
   FRONTEND_REL="./"
 else
-  FRONTEND_REL="./frontend/"
+  FRONTEND_REL="${FRONTEND_INSTALL_PATH}/"
 fi
 JSCONFIG_TPL="${TEMPLATES_DIR}/jsconfig.json"
 if [ ! -f "$JSCONFIG_TPL" ]; then
@@ -161,23 +160,15 @@ else
 fi
 
 # code-workspace: se un file .code-workspace esiste già (qualunque sia il nome),
-# le chiavi del template vengono aggiunte in fondo con prefisso '_'
+# 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[*]}): merge non eseguito${NC}"
+  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
-elif [ ! -f "$WORKSPACE_TPL" ]; then
-  echo -e "${RED}Sorgente mancante: ${WORKSPACE_TPL}${NC}"
 else
-  WORKSPACE_FILE="${WORKSPACE_FILES[1]}"
-  if node "${BASE_URL}/src/merge-jsonc.mjs" "$WORKSPACE_TPL" "$WORKSPACE_FILE"; then
-    echo -e "${YELLOW}${WORKSPACE_FILE} esistente: chiavi del template aggiunte in fondo con prefisso '_' (da integrare o rimuovere)${NC}"
-    BLOCKED_FILES+=("${WORKSPACE_FILE} → merge: chiavi template aggiunte con prefisso \`_\`")
-  else
-    echo -e "${RED}Merge di ${WORKSPACE_FILE} non riuscito${NC}"
-  fi
+  safe_cat "$WORKSPACE_TPL" "${WORKSPACE_FILES[1]}" underscore
 fi
 
 
@@ -260,14 +251,17 @@ for CANDIDATE in "./node_modules/@massimo-cassandro/minimo" "${BASE_URL}/../..";
 done
 
 if [ -z "$MINIMO_PKG_DIR" ]; then
-  echo -e "${RED}Sorgenti di minimo non trovati (né in ./node_modules/@massimo-cassandro/minimo né in ${BASE_URL}/../..): css di base e tokens-config non copiati${NC}"
-  BLOCKED_FILES+=("css di base + tokens-config.mjs → sorgenti minimo non trovati")
+  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}"
 
-  # css di partenza del progetto: solo i file destinati a essere personalizzati.
-  # minimo.css NON viene copiato: i moduli css del framework vanno importati dal
-  # pacchetto (`@import '@minimo/css/...'`, vedi entry-tpl.css)
+  # 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
@@ -275,18 +269,28 @@ else
   # 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"
+
+  # 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
 
-# template delle entry css (globale/di pagina e critical): ogni entry deve
-# importare direttamente custom-properties.css (vedi commenti nei file stessi)
-safe_cat "${TEMPLATES_DIR}/entry-tpl.css"          "${FRONTEND_INSTALL_PATH}/src/entry-tpl.css"
-safe_cat "${TEMPLATES_DIR}/entry-tpl.critical.css" "${FRONTEND_INSTALL_PATH}/src/entry-tpl.critical.css"
+# 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"
+
+# favicons: istruzioni d'uso di `npx create-favicons`
+safe_cat "${TEMPLATES_DIR}/favicons-readme.md" "${FRONTEND_INSTALL_PATH}/favicons/readme.md"
 
 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}"
+  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

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

@@ -58,7 +58,7 @@
 
     ],
     // Do not ignore node_modules css files, which is ignored by default
-    "cssvar.ignore": [],
+    // "cssvar.ignore": [], // decomment if you are using open props
 
     // add support for autocomplete in JS or JS like files
     "cssvar.extensions": [

package/dev-tools/starter-kit/templates/app_index.js

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

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

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

package/dev-tools/starter-kit/templates/jsconfig.json

@@ -9,14 +9,16 @@
     "target": "es2023",
     "module": "ES6",
     "paths": {
-      "@css/*": ["./src/css/*"],
-      "@src/*": ["./src/*"],
-      "@icons/*": ["./icons/*"],
-      "@imgs/*": ["./imgs/*"],
-      "@frontend/*": ["./*"],
-      "@minimo/*": ["__NODE_MODULES__/@massimo-cassandro/minimo/src/*"],
-      "@minimoCharts/*": ["__NODE_MODULES__/@massimo-cassandro/minimo/charts/*"]
+      "@css/*": ["app/css/*"],
+      "@src/*": ["app/src/*"],
+      "@icons/*": ["app/icons/*"],
+      "@imgs/*": ["app/imgs/*"],
+
+      "@frontend/*": ["fromtend/*"],
+
+      "@minimo/*": ["./node_modules/@massimo-cassandro/minimo/src/*"],
+      "@minimoCharts/*": ["./node_modules/@massimo-cassandro/minimo/charts/*"]
     }
   },
-  "exclude": ["__NODE_MODULES__", "dist", "docs", "build", "public"]
+  "exclude": ["node_modules", "dist", "docs", "build", "public"]
 }

package/dev-tools/starter-kit/templates/{entry-tpl.critical.css → layout-critical.css}

@@ -1,5 +1,6 @@
 /*
-  Template di entry css critical — rinominare e adattare.
+  Entry css critical di default (index-critical.css) — adattare al progetto.
+  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.

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

@@ -150,12 +150,12 @@ const CopyWebpackPluginPatterns = [
 // =>> entries
 // NB: percorsi dalla root del progetto
 const entries = {
-  'xxxxxx': './src/index.js'
+  'xxxxxx': './index.js'
 
   // css critici inlinati 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': './src/xxxxxx.critical.css'
+  // ,'xxxxxx.critical': './index-critical.css'
 };
 
 
@@ -410,6 +410,7 @@ const config = {
           // webpack.config.mjs NON è in una sottodirectory)
           // path.resolve(__dirname, '../templates/**/*.twig'),
           // path.resolve(__dirname, '../src/**/*.php'),
+          path.resolve(__dirname, './index.js'), // entry js di default (vedi starter-install.sh)
           path.resolve(__dirname, './src/**/*.{js,mjs,jsx}'),
           path.resolve(__dirname, './src/**/*.ejs'), // template html di webpack
           path.resolve(__dirname, './error-pages/**/*.js'),
@@ -449,6 +450,8 @@ const config = {
         // delle dipendenze (vedi webpack-modules/purgecss-variables-safelist.mjs)
         variablesSafelist: {
           declarationGlobs: [
+            path.resolve(__dirname, './index.css'), // entry css di default (vedi starter-install.sh)
+            path.resolve(__dirname, './index-critical.css'),
             path.resolve(__dirname, './src/**/*.css'),
             path.resolve(__dirname, './error-pages/**/*.css'),
             `${minimo_path}/src/**/*.css`,

package/package.json

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

package/src/utilities/dom-builder/dom-builder.js

@@ -14,10 +14,11 @@ import { parseDomString } from './parseDomString.js';
  * @property {string | string[]} [classname] - Alias for `className`.
  * @property {string | null} [id] - Unique element ID.
  * @property {[string, *] | [string, *][] | Object<string, *>} [attrs] - Attributes: a `[name, value]` pair, array of pairs, or `{name: value}` object.
- * @property {string | number | Function | Element | DomBuilderItem[] | null} [content] - Element content.
+ * @property {string | number | Function | Node | DomBuilderItem[] | null} [content] - Element content.
  *   A string or number is set as plain text (`textContent`) unless it contains `<`, in which case it is
  *   treated as markup: sanitized and inserted via the native Sanitizer API (`Element.setHTML`) where
- *   supported, falling back to raw `innerHTML` on browsers without it.
+ *   supported, falling back to raw `innerHTML` on browsers without it. A `Node` (an `Element`, a
+ *   `DocumentFragment`, ...) is appended as-is, either directly or returned from a function.
  * @property {string | number} [text] - Literal text node shorthand: inserts a plain `Text` node (never
  *   parsed as markup) in place of an element, so it can sit as a sibling of tags within `children`/`content`
  *   arrays. Mutually exclusive with `tag`/`content`/`children`: when set (and `tag` is absent), every other
@@ -44,7 +45,7 @@ import { parseDomString } from './parseDomString.js';
  *     className: 'xxx' | ['class1', 'class2'], // also `class`
  *     id: 'element-id',
  *     attrs: [attr_name, attr_value] | [[...], [...]] | {name: value},
- *     content: 'xxx' | 'xxx <strong>yyy</strong>' | 123 | domBuilder Array | function | Element, // see DomBuilderItem.content above
+ *     content: 'xxx' | 'xxx <strong>yyy</strong>' | 123 | domBuilder Array | function | Node, // see DomBuilderItem.content above
  *     condition: true | false,
  *     callback: el => ...,
  *     children: [...]
@@ -89,7 +90,7 @@ import { parseDomString } from './parseDomString.js';
  * - `className` / `class` / `classname` {string | string[]} - CSS class(es): a single string or an array (falsy values filtered out).
  * - `id` {string | null} - Unique element ID.
  * - `attrs` {[string, *] | [string, *][] | Object<string, *>} - Attributes: a `[name, value]` pair, array of pairs, or `{name: value}` object.
- * - `content` {string | number | Function | Element | DomBuilderItem[] | null} - Element content. A string/number is set as `textContent` unless it contains `<`, in which case it's sanitized and inserted as markup (`Element.setHTML`, falling back to `innerHTML`).
+ * - `content` {string | number | Function | Node | DomBuilderItem[] | null} - Element content. A string/number is set as `textContent` unless it contains `<`, in which case it's sanitized and inserted as markup (`Element.setHTML`, falling back to `innerHTML`). A `Node` (`Element`, `DocumentFragment`, ...), passed directly or returned from a function, is appended as-is.
  * - `text` {string | number} - Literal text node shorthand: inserts a plain `Text` node (never parsed as markup) as a sibling of other items, in place of an element. Mutually exclusive with `tag`/`content`/`children`.
  * - `condition` {boolean} - When false, the element (or text node) is skipped. Default `true`.
  * - `callback` {(function(HTMLElement|Text): void) | null} - Invoked after the element (or text node) is created.
@@ -232,16 +233,21 @@ export function domBuilder(structureArray = [], parent, options = {}) {
 
         } else {
 
-          /** @type {string | Element | null} */
+          /** @type {string | Node | null} */
           let content = null;
           if (typeof safeItem.content === 'function') {
             content = safeItem.content();
 
+          } else if (safeItem.content instanceof Node) {
+            content = safeItem.content;
+
           } else if (safeItem.content != null) {
             content = String(safeItem.content);
           }
 
-          if (content instanceof Element) {
+          if (content instanceof Node) {
+            // Element, DocumentFragment, Text, ... appended as-is (a DocumentFragment's
+            // children are moved into `el`, emptying the fragment, per native DOM behavior)
             el.appendChild(content);
 
           } else if (content != null) {

package/dev-tools/starter-kit/FIX.md

@@ -1,2 +0,0 @@
-l'aggiunta dell'undescore davanti a proprietà di package.json o __project__.code-workspace se già esistenti è fonte di confusione
-

package/dev-tools/starter-kit/src/merge-jsonc.mjs

@@ -1,144 +0,0 @@
-#!/usr/bin/env node
-// Merge JSONC: aggiunge in fondo al file di destinazione le chiavi di primo
-// livello del template, prefissate con '_', preservando commenti e
-// formattazione di entrambi i file.
-// Uso: node merge-jsonc.mjs <template> <destinazione>
-
-import fs from 'fs';
-
-// Analizza un testo JSONC ignorando stringhe e commenti: individua
-// l'oggetto principale, le virgole a profondità 1 e la posizione
-// dell'ultimo carattere significativo (non spazio, non commento)
-function scan(text) {
-  let depth = 0;
-  let open = -1;
-  let close = -1;
-  let last = -1;
-  const commas = [];
-  let i = 0;
-  while (i < text.length) {
-    const c = text[i];
-    const next = text[i + 1];
-    if (c === '"') {
-      i++;
-      while (i < text.length && text[i] !== '"') {
-        if (text[i] === '\\') i++;
-        i++;
-      }
-      last = i;
-    } else if (c === '/' && next === '/') {
-      while (i < text.length && text[i] !== '\n') i++;
-      continue;
-    } else if (c === '/' && next === '*') {
-      i += 2;
-      while (i < text.length && !(text[i] === '*' && text[i + 1] === '/')) i++;
-      i++;
-    } else {
-      if (c === '{' || c === '[') {
-        if (depth === 0 && open === -1 && c === '{') open = i;
-        depth++;
-      } else if (c === '}' || c === ']') {
-        depth--;
-        if (depth === 0 && close === -1) close = i;
-      } else if (c === ',' && depth === 1) {
-        commas.push(i);
-      }
-      if (!/\s/.test(c)) last = i;
-    }
-    i++;
-  }
-  return { open, close, commas, last };
-}
-
-// Posizione della prima doppia virgoletta fuori dai commenti
-function firstQuotePos(text) {
-  let i = 0;
-  while (i < text.length) {
-    const c = text[i];
-    const next = text[i + 1];
-    if (c === '/' && next === '/') {
-      while (i < text.length && text[i] !== '\n') i++;
-    } else if (c === '/' && next === '*') {
-      i += 2;
-      while (i < text.length && !(text[i] === '*' && text[i + 1] === '/')) i++;
-      i += 2;
-    } else if (c === '"') {
-      return i;
-    } else {
-      i++;
-    }
-  }
-  return -1;
-}
-
-// Voci di primo livello di un oggetto JSONC (spezzate sulle virgole a profondità 1)
-function topLevelEntries(text, s) {
-  const body = text.slice(s.open + 1, s.close);
-  const offset = s.open + 1;
-  const bounds = s.commas.map((p) => p - offset).concat(body.length);
-  const entries = [];
-  let prev = 0;
-  for (const b of bounds) {
-    entries.push(body.slice(prev, b));
-    prev = b + 1;
-  }
-  return entries;
-}
-
-// Nome della chiave di una voce (contenuto della prima stringa fuori dai commenti)
-function keyName(entry) {
-  const q = firstQuotePos(entry);
-  if (q < 0) return null;
-  let key = '';
-  let i = q + 1;
-  while (i < entry.length && entry[i] !== '"') {
-    if (entry[i] === '\\') i++;
-    key += entry[i];
-    i++;
-  }
-  return key;
-}
-
-const [tplPath, destPath] = process.argv.slice(2);
-
-try {
-  const tpl = fs.readFileSync(tplPath, 'utf8');
-  const dest = fs.readFileSync(destPath, 'utf8');
-  const t = scan(tpl);
-  const d = scan(dest);
-  if (t.open < 0 || t.close < 0) throw new Error(tplPath + ': oggetto JSON non trovato');
-  if (d.open < 0 || d.close < 0) throw new Error(destPath + ': oggetto JSON non trovato');
-
-  // chiavi di primo livello già presenti nella destinazione
-  const destKeys = new Set(
-    topLevelEntries(dest, d).map((entry) => keyName(entry)).filter((k) => k !== null)
-  );
-
-  // prefissa con '_' la chiave di ogni voce del template, saltando le voci di
-  // soli commenti/spazi e le chiavi già presenti nella destinazione
-  // (così rilanciare lo script non produce duplicati)
-  const renamed = [];
-  for (const entry of topLevelEntries(tpl, t)) {
-    const cleaned = entry.replace(/^\s+/, '').replace(/\s+$/, '');
-    const key = keyName(cleaned);
-    if (key === null || destKeys.has('_' + key)) continue;
-    const q = firstQuotePos(cleaned);
-    renamed.push('\n  ' + cleaned.slice(0, q + 1) + '_' + cleaned.slice(q + 1));
-  }
-  if (renamed.length === 0) process.exit(0);
-
-  // aggiunge le voci prima della chiusura dell'oggetto principale della
-  // destinazione, inserendo una virgola dopo l'ultima voce esistente se serve
-  const dBody = dest.slice(d.open + 1, d.close);
-  const b = scan(dBody);
-  const needsComma = b.last >= 0 && dBody[b.last] !== ',';
-  const insertAt = d.open + 1 + b.last + 1;
-  const out = needsComma
-    ? dest.slice(0, insertAt) + ',' + dest.slice(insertAt, d.close) + renamed.join(',') + '\n' + dest.slice(d.close)
-    : dest.slice(0, d.close) + renamed.join(',') + '\n' + dest.slice(d.close);
-
-  fs.writeFileSync(destPath, out);
-} catch (err) {
-  console.error('merge-jsonc: ' + err.message);
-  process.exit(1);
-}

package/dev-tools/starter-kit/templates/entry-tpl.css

@@ -1,24 +0,0 @@
-/*
-  Template di entry css (globale o di pagina) — rinominare e adattare.
-
-  NB: OGNI entry css (globale, di pagina, `.critical`) deve importare
-  direttamente custom-properties.css: PurgeCSS elabora gli asset css
-  SINGOLARMENTE e mantiene in ciascuno solo le custom properties
-  effettivamente usate nell'asset stesso (`variables: true`, che
-  sostituisce postcss-jit-props). L'import diretto non produce quindi
-  duplicazioni nel css finale.
-*/
-
-@import '@css/custom-properties.css';
-/* @import '@css/fonts.css'; */
-
-/* @import '@css/custom-media.css'; */ /* NON necessario: iniettato da postcss-global-data */
-
-/* moduli minimo: importare solo quelli effettivamente usati */
-/* @import '@minimo/css/reset.css'; */
-/* @import '@minimo/css/layout-base.css'; */
-/* @import '@minimo/css/container.css'; */
-/* @import '@minimo/css/forms/forms.css'; */
-/* @import '@minimo/css/buttons/buttons.css'; */
-/* @import '@minimo/css/alerts.css'; */
-/* ... */