@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.
- package/dev-tools/README.md +1 -44
- package/dev-tools/find-orphan-css-classes/readme.md +3 -0
- package/dev-tools/layout-tools/readme.md +3 -0
- package/dev-tools/starter-kit/README.md +26 -0
- package/dev-tools/svg-icons-tools/README.md +13 -0
- package/dev-tools/update-version/README.md +1 -1
- package/dev-tools/update-version/src/create-log-row.mjs +6 -8
- package/package.json +1 -1
- package/src/web-components/json-table/json-table.minimo.tokens.mjs +1 -1
package/dev-tools/README.md
CHANGED
|
@@ -1,50 +1,7 @@
|
|
|
1
1
|
# Dev tools
|
|
2
2
|
|
|
3
|
-
Raccolta di utilità CLI Node.js standalone che aiutano nelle attività
|
|
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,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 = `* ${
|
|
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) +
|
|
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