@massimo-cassandro/minimo 1.42.2 → 1.42.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,50 +1,7 @@
1
1
  # Dev tools
2
2
 
3
- Raccolta di utilità CLI Node.js standalone che aiutano nelle attività quotidiane di gestione di un progetto web (aggiornamento delle dipendenze, versionamento/changelog, generazione di icone e favicon). Ogni strumento risiede in una propria sottocartella, funziona in modo indipendente dagli altri e dal pacchetto `minimo`, ed è documentato nel proprio README — questa pagina ne dà solo una panoramica.
3
+ Raccolta di utilità CLI Node.js standalone o Vanilla JS che aiutano nelle attività di gestione di un progetto web (aggiornamento delle dipendenze, versionamento/changelog, generazione di icone e favicon). Ogni strumento risiede in una propria sottocartella, funziona in modo indipendente dagli altri e dal pacchetto `minimo`, ed è documentato nel proprio README.
4
4
 
5
- * [update-version](./update-version/README.md) — incrementa la versione in `package.json` e aggiunge una voce a `changelog.md`
6
- * [Svg Icons Tools](./svg-icons-tools/README.md) — ottimizza le icone SVG e le combina/converte in symbol, JSX o variabili SCSS
7
- * [Create favicons](./create-favicons/README.md) — genera il set completo di favicon (SVG, PNG, ICO, webmanifest, snippet HTML) a partire da un'immagine sorgente
8
- * [upd@m](./upd@m/README.md) — aggiorna tutti i pacchetti `@massimo-cassandro/*` installati in `node_modules`
9
- * [Design Tokens Builder](./design-tokens-builder/README.md) — genera un file di custom properties CSS (e, opzionalmente, file JSON di token) a partire dai sorgenti dei design token
10
- * [starter-kit](#starter-kit) — script per installare l'ambiente minimo
11
-
12
- ## starter-kit
13
-
14
- `starter-kit/starter-install.sh` avvia un nuovo progetto frontend: copia i file di configurazione starter (`package.json`, `.gitignore`, `jsconfig.json`, configurazioni eslint/stylelint, configurazione e moduli webpack, ...) nella root del progetto e i file frontend (template webpack, `CLAUDE.md`, `_root_htaccess`/`_root_robots.txt`, ...) in una cartella `./app` fissa, quindi installa tutte le dipendenze di sviluppo necessarie.
15
-
16
- Lo script **richiede zsh** (termina con un errore se lanciato con `sh` o `bash`). I file esistenti non vengono mai sovrascritti: vengono copiati accanto con il prefisso `NEW-` (da integrare manualmente o da rimuovere). Se la cartella `./app` esiste già, l'intero set di file frontend viene copiato in `./NEW-app`.
17
-
18
- ### Se minimo è già installato
19
-
20
- Lo script è esposto come `bin` del pacchetto:
21
-
22
- ```bash
23
- npx starter-kit
24
- ```
25
-
26
- Poiché l'installazione non sovrascrive mai nulla, lo script può essere anche **rieseguito in qualsiasi momento per aggiornare** una configurazione esistente (ad es. per aggiornare i moduli webpack o reinstallare le dipendenze di sviluppo): i file esistenti vengono copiati con il prefisso `NEW-`, quindi rieseguire lo script non duplica né sovrascrive mai nulla.
27
-
28
- ### Senza installare minimo
29
-
30
- Per avviare un progetto **prima** di installare l'intero pacchetto, scaricare solo la cartella `starter-kit` dal tarball npm ed eseguire lo script da lì:
31
-
32
- ```bash
33
- curl -sL "$(npm view @massimo-cassandro/minimo dist.tarball)" | tar xz package/dev-tools/starter-kit
34
- zsh package/dev-tools/starter-kit/starter-install.sh
35
- rm -rf package
36
- ```
37
-
38
- ## Strumenti per SVG e favicon
39
-
40
- ```bash
41
- ## SVG Icons Tools
42
- npx svgIconsTools --config ./path/to/svg-icons-tools.config.mjs
43
-
44
- # create favicons
45
- npx create-favicons init
46
- npx create-favicons [--dir=./path/to/dir]
47
- ```
48
5
 
49
6
  ## Aggiungere gli strumenti più usati alla sezione scripts di `package.json`:
50
7
 
@@ -0,0 +1,3 @@
1
+ # Find orphan css classes
2
+
3
+ Analizza i file di un progetto e crea un rapporto con eventuali classi css non esistenti.
@@ -0,0 +1,3 @@
1
+ # Layout tools
2
+
3
+ // TODO
@@ -0,0 +1,26 @@
1
+
2
+ # starter-kit
3
+
4
+ `starter-kit/starter-install.sh` avvia un nuovo progetto frontend: copia i file di configurazione starter (`package.json`, `.gitignore`, `jsconfig.json`, configurazioni eslint/stylelint, configurazione e moduli webpack, ...) nella root del progetto e i file frontend (template webpack, `CLAUDE.md`, `_root_htaccess`/`_root_robots.txt`, ...) in una cartella `./app` fissa, quindi installa tutte le dipendenze di sviluppo necessarie.
5
+
6
+ Lo script **richiede zsh** (termina con un errore se lanciato con `sh` o `bash`). I file esistenti non vengono mai sovrascritti: vengono copiati accanto con il prefisso `NEW-` (da integrare manualmente o da rimuovere). Se la cartella `./app` esiste già, l'intero set di file frontend viene copiato in `./NEW-app`.
7
+
8
+ ### Se minimo è già installato
9
+
10
+ Lo script è esposto come `bin` del pacchetto:
11
+
12
+ ```bash
13
+ npx starter-kit
14
+ ```
15
+
16
+ Poiché l'installazione non sovrascrive mai nulla, lo script può essere anche **rieseguito in qualsiasi momento per aggiornare** una configurazione esistente (ad es. per aggiornare i moduli webpack o reinstallare le dipendenze di sviluppo): i file esistenti vengono copiati con il prefisso `NEW-`, quindi rieseguire lo script non duplica né sovrascrive mai nulla.
17
+
18
+ ### Senza installare minimo
19
+
20
+ Per avviare un progetto **prima** di installare l'intero pacchetto, scaricare solo la cartella `starter-kit` dal tarball npm ed eseguire lo script da lì:
21
+
22
+ ```bash
23
+ curl -sL "$(npm view @massimo-cassandro/minimo dist.tarball)" | tar xz package/dev-tools/starter-kit
24
+ zsh package/dev-tools/starter-kit/starter-install.sh
25
+ rm -rf package
26
+ ```
@@ -1,5 +1,18 @@
1
1
  # Svg Icons Tools
2
2
 
3
+ ## Quick start
4
+
5
+ ```bash
6
+ ## SVG Icons Tools
7
+ npx svgIconsTools --config ./path/to/svg-icons-tools.config.mjs
8
+
9
+ # create favicons
10
+ npx create-favicons init
11
+ npx create-favicons [--dir=./path/to/dir]
12
+ ```
13
+
14
+ ## Panoramica
15
+
3
16
  Svg Icons Tools fornisce alcune utilità per gestire e ottimizzare le icone SVG:
4
17
 
5
18
  * ottimizza tutti i file con [SVGO](https://svgo.dev/)
@@ -16,6 +16,6 @@ Opzioni:
16
16
 
17
17
  * `--pkg`: Percorso del file `package.json` relativo alla directory corrente (default: `./package.json`)
18
18
  * `--log-file`: Percorso del file di log relativo alla directory corrente (default: `./changelog.md`). Se il nome del file termina con `.txt`, si assume il formato di log della versione precedente di `update-version`, in cui ogni riga ha la forma `timestamp | version | description`
19
- * `--log-patch`: Se presente, vengono registrate nel log anche le modifiche di tipo patch.
19
+ * `--log-patch`: Se presente, vengono registrate nel log anche le modifiche di tipo patch, e la versione viene scritta nel log per intero (es. `1.3.1`). Se assente, nel log compaiono solo le prime due cifre (es. `1.3`).
20
20
  * `--default-patch-log="testo"`: Testo di default usato per il log delle patch (default: `Fix / Upd`).
21
21
  * `--no-log-v0`: Se `true` (default), il log non viene scritto quando la versione major è `0`, tranne per la voce iniziale creata alla prima inizializzazione del file changelog. Passare `--no-log-v0` per abilitarlo esplicitamente, oppure `--no-log-v0=false` per disabilitarlo da riga di comando.
@@ -2,24 +2,22 @@ import { params } from './params.mjs';
2
2
 
3
3
  export function createLogRow() {
4
4
 
5
+ // Con --log-patch si registra la semver completa, altrimenti solo major.minor
6
+ const vers = params.toLog.includes('patch')
7
+ ? params.logRow.vers
8
+ : String(params.logRow.vers).split('.').slice(0, 2).join('.');
5
9
 
6
10
  if (params.markdownLog) {
7
-
8
11
  const dateStr = params.logRow.date.toLocaleString(params.locale, {
9
12
  year: 'numeric', month: 'short', day: '2-digit'
10
13
  });
11
- params.logRow.fullText = `* ${params.logRow.vers} (${dateStr})${params.logRow.descr ? ' - ' + params.logRow.descr : ''}`;
12
-
14
+ params.logRow.fullText = `* ${vers} (${dateStr})${params.logRow.descr ? ' - ' + params.logRow.descr : ''}`;
13
15
 
14
16
  } else {
15
-
16
17
  const dateStr = params.logRow.date.toISOString();
17
- params.logRow.fullText = `${dateStr} | ${(' '.repeat(16) + params.logRow.vers).slice(-16)} | ${params.logRow.descr || ''}`;
18
+ params.logRow.fullText = `${dateStr} | ${(' '.repeat(16) + vers).slice(-16)} | ${params.logRow.descr || ''}`;
18
19
 
19
20
  }
20
-
21
-
22
-
23
21
  }
24
22
 
25
23
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@massimo-cassandro/minimo",
3
- "version": "1.42.2",
3
+ "version": "1.42.3",
4
4
  "description": "Light css framework & utilities",
5
5
  "type": "module",
6
6
  "main": "./src/index.js",
@@ -22,7 +22,7 @@ export default {
22
22
  },
23
23
  color: {
24
24
  $type: 'color',
25
- $value: '{text.muted}'
25
+ $value: '{text.color}'
26
26
  },
27
27
  outer: {
28
28
  padding: {