mypgs 2.0.0 → 2.1.0

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.
Files changed (104) hide show
  1. package/README.md +25 -25
  2. package/assets/scss/components/_accordion.scss +0 -2
  3. package/assets/scss/components/_button.scss +1 -1
  4. package/assets/scss/components/_form.scss +0 -16
  5. package/assets/scss/components/_formAddon.scss +18 -0
  6. package/assets/scss/components/_modals.scss +5 -3
  7. package/assets/scss/components/_search.scss +2 -2
  8. package/assets/scss/components/_slides.scss +0 -1
  9. package/assets/scss/components/_tooltip.scss +0 -1
  10. package/assets/scss/index.scss +1 -0
  11. package/assets/scss/layout/_footer.scss +0 -2
  12. package/assets/scss/layout/_header.scss +9 -1
  13. package/assets/scss/layout/_pageShell.scss +6 -2
  14. package/assets/scss/mixin/_mx-button.scss +30 -76
  15. package/assets/scss/mixin/_mx-card.scss +11 -9
  16. package/assets/scss/mixin/_mx-form.scss +3 -5
  17. package/assets/scss/mixin/{_mx-form-addon.scss → _mx-formAddon.scss} +23 -26
  18. package/assets/scss/mixin/_mx-hover.scss +75 -0
  19. package/assets/scss/mixin/_settings.scss +2 -1
  20. package/assets/scss/mixin/mixin.scss +2 -1
  21. package/demo/demo.js +4 -3
  22. package/dist/css/index.css +1166 -1517
  23. package/dist/css/index.css.map +1 -1
  24. package/dist/css/index.min.css +1 -1
  25. package/docs/componenti-e-markup.md +6 -5
  26. package/docs/components/accordion.md +22 -22
  27. package/docs/components/badges.md +19 -19
  28. package/docs/components/breadcumbs.md +8 -8
  29. package/docs/components/button.md +17 -17
  30. package/docs/components/card.md +19 -19
  31. package/docs/components/dropdown.md +29 -29
  32. package/docs/components/form.md +63 -40
  33. package/docs/components/formAddon.md +79 -0
  34. package/docs/components/logo.md +11 -11
  35. package/docs/components/menu.md +20 -20
  36. package/docs/components/modal.md +46 -46
  37. package/docs/components/notification.md +34 -34
  38. package/docs/components/search.md +51 -50
  39. package/docs/components/slides.md +39 -39
  40. package/docs/components/stepTabs.md +41 -41
  41. package/docs/components/steps.md +16 -16
  42. package/docs/components/summary.md +20 -20
  43. package/docs/components/table.md +7 -7
  44. package/docs/components/tooltip.md +22 -22
  45. package/docs/convenzioni.md +11 -11
  46. package/docs/export-e-sviluppo.md +3 -3
  47. package/docs/helper-javascript.md +7 -7
  48. package/docs/layout/body.md +11 -11
  49. package/docs/layout/flex.md +44 -44
  50. package/docs/layout/footer.md +23 -23
  51. package/docs/layout/grid.md +44 -44
  52. package/docs/layout/header.md +34 -34
  53. package/docs/layout/pageShell.md +11 -11
  54. package/docs/layout/section.md +26 -26
  55. package/docs/patterns/cookieConsent.md +38 -38
  56. package/docs/utilizzo-css-scss.md +8 -8
  57. package/package.json +1 -1
  58. package/scripts/generate-component-docs.js +5 -5
  59. package/templates/html/components/accordion.html +19 -19
  60. package/templates/html/components/badges.html +17 -17
  61. package/templates/html/components/breadcumbs.html +6 -6
  62. package/templates/html/components/button.html +15 -15
  63. package/templates/html/components/card.html +17 -17
  64. package/templates/html/components/dropdown.html +25 -25
  65. package/templates/html/components/form.html +58 -35
  66. package/templates/html/components/formAddon.html +72 -0
  67. package/templates/html/components/logo.html +9 -9
  68. package/templates/html/components/menu.html +16 -16
  69. package/templates/html/components/modal.html +42 -42
  70. package/templates/html/components/notification.html +30 -30
  71. package/templates/html/components/search.html +43 -42
  72. package/templates/html/components/slides.html +31 -31
  73. package/templates/html/components/stepTabs.html +37 -37
  74. package/templates/html/components/steps.html +13 -13
  75. package/templates/html/components/summary.html +17 -17
  76. package/templates/html/components/table.html +5 -5
  77. package/templates/html/components/tooltip.html +18 -18
  78. package/templates/html/layout/body.html +9 -10
  79. package/templates/html/layout/flex.html +42 -42
  80. package/templates/html/layout/footer.html +20 -20
  81. package/templates/html/layout/grid.html +42 -42
  82. package/templates/html/layout/header.html +32 -32
  83. package/templates/html/layout/pageShell.html +8 -8
  84. package/templates/html/layout/section.html +24 -24
  85. package/templates/html/patterns/cookieConsent.html +33 -33
  86. package/templates/react/components/accordion.jsx +4 -4
  87. package/templates/react/components/breadcumbs.jsx +1 -1
  88. package/templates/react/components/button.jsx +5 -5
  89. package/templates/react/components/card.jsx +4 -4
  90. package/templates/react/components/dropdown.jsx +8 -8
  91. package/templates/react/components/form.jsx +2 -2
  92. package/templates/react/components/modal.jsx +14 -14
  93. package/templates/react/components/notification.jsx +3 -3
  94. package/templates/react/components/search.jsx +5 -5
  95. package/templates/react/components/slides.jsx +3 -3
  96. package/templates/react/components/stepTabs.jsx +8 -8
  97. package/templates/react/components/summary.jsx +3 -3
  98. package/templates/react/components/table.jsx +2 -2
  99. package/templates/react/layout/flex.jsx +8 -8
  100. package/templates/react/layout/grid.jsx +8 -8
  101. package/templates/react/layout/section.jsx +12 -12
  102. package/templates/react/patterns/cookieConsent.jsx +8 -8
  103. package/templates/react/patterns/footer.jsx +3 -3
  104. package/templates/react/patterns/header.jsx +3 -3
@@ -1,116 +1,116 @@
1
- <!-- File generato automaticamente da templates/html/layout/grid.html. Modificare templates/html/layout/grid.html e rieseguire npm run docs:generate. -->
1
+ <!-- Automatically generated from templates/html/layout/grid.html. Edit templates/html/layout/grid.html and run npm run docs:generate again. -->
2
2
 
3
3
  # Grid
4
4
 
5
- Esempi di griglie responsive che distribuiscono da due a sei colonne mantenendo gap e ridimensionamento coerenti con il design system.
5
+ Responsive grid examples that distribute two to six columns while preserving design-system gaps and sizing.
6
6
 
7
7
  ## PGS
8
8
 
9
- - `grid-2`: crea una griglia responsive fino a due colonne.
10
- - `grid-3`: crea una griglia responsive fino a tre colonne.
11
- - `grid-4`: crea una griglia responsive fino a quattro colonne.
12
- - `grid-6`: crea una griglia responsive fino a sei colonne.
9
+ - `grid-2`: creates a responsive grid with up to two columns.
10
+ - `grid-3`: creates a responsive grid with up to three columns.
11
+ - `grid-4`: creates a responsive grid with up to four columns.
12
+ - `grid-6`: creates a responsive grid with up to six columns.
13
13
 
14
- ## Elementi correlati
14
+ ## Related elements
15
15
 
16
- - `container`: definisce il contesto contenitore dell'introduzione.
17
- - `flexColumnTexts`: organizza e distanzia i testi introduttivi e delle card.
18
- - `card`: rende visibili le celle dimostrative delle griglie.
16
+ - `container`: defines the container context for the introduction.
17
+ - `flexColumnTexts`: organizes and spaces introductory and card text.
18
+ - `card`: makes the demonstration grid cells visible.
19
19
 
20
20
  ## Output
21
21
 
22
- Raccolta HTML delle griglie responsive a due, tre, quattro e sei colonne.
22
+ HTML collection of responsive grids with two, three, four, and six columns.
23
23
 
24
- ## Esempio
24
+ ## Example
25
25
 
26
26
  ```html
27
27
  <div pgs="container flexColumnTexts">
28
- <strong>Sezione standard</strong>
29
- <p>Contenuto centrato dentro una sezione MyPGS.</p>
28
+ <strong>Standard section</strong>
29
+ <p>Centered content inside a MyPGS section.</p>
30
30
  </div>
31
31
 
32
32
 
33
33
  <div pgs="grid-2">
34
34
  <article pgs="card flexColumnTexts">
35
- <strong>Colonna uno</strong>
36
- <p>Contenuto della prima colonna.</p>
35
+ <strong>Column one</strong>
36
+ <p>First column content.</p>
37
37
  </article>
38
38
 
39
39
  <article pgs="card flexColumnTexts">
40
- <strong>Colonna due</strong>
41
- <p>Contenuto della seconda colonna.</p>
40
+ <strong>Column two</strong>
41
+ <p>Second column content.</p>
42
42
  </article>
43
43
  </div>
44
44
 
45
45
 
46
46
  <div pgs="grid-3">
47
47
  <article pgs="card flexColumnTexts">
48
- <strong>Colonna uno</strong>
49
- <p>Contenuto della prima colonna.</p>
48
+ <strong>Column one</strong>
49
+ <p>First column content.</p>
50
50
  </article>
51
51
 
52
52
  <article pgs="card flexColumnTexts">
53
- <strong>Colonna due</strong>
54
- <p>Contenuto della seconda colonna.</p>
53
+ <strong>Column two</strong>
54
+ <p>Second column content.</p>
55
55
  </article>
56
56
 
57
57
  <article pgs="card flexColumnTexts">
58
- <strong>Colonna tre</strong>
59
- <p>Contenuto della terza colonna.</p>
58
+ <strong>Column three</strong>
59
+ <p>Third column content.</p>
60
60
  </article>
61
61
  </div>
62
62
 
63
63
 
64
64
  <div pgs="grid-4">
65
65
  <article pgs="card flexColumnTexts">
66
- <strong>Colonna uno</strong>
67
- <p>Contenuto della prima colonna.</p>
66
+ <strong>Column one</strong>
67
+ <p>First column content.</p>
68
68
  </article>
69
69
 
70
70
  <article pgs="card flexColumnTexts">
71
- <strong>Colonna due</strong>
72
- <p>Contenuto della seconda colonna.</p>
71
+ <strong>Column two</strong>
72
+ <p>Second column content.</p>
73
73
  </article>
74
74
 
75
75
  <article pgs="card flexColumnTexts">
76
- <strong>Colonna tre</strong>
77
- <p>Contenuto della terza colonna.</p>
76
+ <strong>Column three</strong>
77
+ <p>Third column content.</p>
78
78
  </article>
79
79
  <article pgs="card flexColumnTexts">
80
- <strong>Colonna quattro</strong>
81
- <p>Contenuto della quarta colonna.</p>
80
+ <strong>Column four</strong>
81
+ <p>Fourth column content.</p>
82
82
  </article>
83
83
  </div>
84
84
 
85
85
  <div pgs="grid-6">
86
86
  <article pgs="card flexColumnTexts">
87
- <strong>Colonna uno</strong>
88
- <p>Contenuto della prima colonna.</p>
87
+ <strong>Column one</strong>
88
+ <p>First column content.</p>
89
89
  </article>
90
90
 
91
91
  <article pgs="card flexColumnTexts">
92
- <strong>Colonna due</strong>
93
- <p>Contenuto della seconda colonna.</p>
92
+ <strong>Column two</strong>
93
+ <p>Second column content.</p>
94
94
  </article>
95
95
 
96
96
  <article pgs="card flexColumnTexts">
97
- <strong>Colonna tre</strong>
98
- <p>Contenuto della terza colonna.</p>
97
+ <strong>Column three</strong>
98
+ <p>Third column content.</p>
99
99
  </article>
100
100
 
101
101
  <article pgs="card flexColumnTexts">
102
- <strong>Colonna quattro</strong>
103
- <p>Contenuto della quarta colonna.</p>
102
+ <strong>Column four</strong>
103
+ <p>Fourth column content.</p>
104
104
  </article>
105
105
 
106
106
  <article pgs="card flexColumnTexts">
107
- <strong>Colonna cinque</strong>
108
- <p>Contenuto della quinta colonna.</p>
107
+ <strong>Column five</strong>
108
+ <p>Fifth column content.</p>
109
109
  </article>
110
110
 
111
111
  <article pgs="card flexColumnTexts">
112
- <strong>Colonna sei</strong>
113
- <p>Contenuto della sesta colonna.</p>
112
+ <strong>Column six</strong>
113
+ <p>Sixth column content.</p>
114
114
  </article>
115
115
  </div
116
116
  ```
@@ -1,50 +1,50 @@
1
- <!-- File generato automaticamente da templates/html/layout/header.html. Modificare templates/html/layout/header.html e rieseguire npm run docs:generate. -->
1
+ <!-- Automatically generated from templates/html/layout/header.html. Edit templates/html/layout/header.html and run npm run docs:generate again. -->
2
2
 
3
3
  # Header
4
4
 
5
- Intestazione responsive che misura lo spazio disponibile, alterna contenuti desktop e mobile e integra menu, tema scuro e navigazione modale.
5
+ Responsive header that measures available space, switches between desktop and mobile content, and integrates menus, dark mode, and modal navigation.
6
6
 
7
7
  ## PGS
8
8
 
9
- - `header`: identifica l'intestazione principale osservata dal modulo JavaScript.
10
- - `header-element`: identifica il gruppo interno misurato per determinare il passaggio alla modalità mobile.
11
- - `header-element-alwaysOn`: identifica l'area iniziale sempre visibile.
12
- - `header-element-onlyDesktop`: identifica i contenuti mostrati soltanto quando il menu desktop è attivo.
13
- - `header-element-onlyMobile`: identifica i contenuti mostrati soltanto in modalità mobile.
14
- - `header-element-alwaysOnLast`: identifica l'area finale sempre visibile.
15
- - `header-element-hamburger`: identifica il gruppo della navigazione mobile.
16
- - `header-element-hamburger-button`: identifica il controllo hamburger specifico dell'header.
9
+ - `header`: identifies the main header observed by the JavaScript module.
10
+ - `header-element`: identifies the inner group measured to determine the switch to mobile mode.
11
+ - `header-element-alwaysOn`: identifies the initial area that is always visible.
12
+ - `header-element-onlyDesktop`: identifies content shown only while the desktop menu is active.
13
+ - `header-element-onlyMobile`: identifies content shown only in mobile mode.
14
+ - `header-element-alwaysOnLast`: identifies the final area that is always visible.
15
+ - `header-element-hamburger`: identifies the mobile navigation group.
16
+ - `header-element-hamburger-button`: identifies the header-specific hamburger control.
17
17
 
18
18
  ## PGS Options
19
19
 
20
- - `horizontal`: dispone orizzontalmente il menu desktop correlato.
21
- - `vertical`: dispone verticalmente il menu mobile correlato.
22
- - `menuHeader`: adatta entrambi i menu al contesto dell'header.
23
- - `containerPGS`: sul wrapper modal usa containerPGS[header] per spostare il dialog nell'intestazione.
24
- - `right`: sul dialog della navigazione mobile presenta il contenuto dal lato destro.
20
+ - `horizontal`: arranges the related desktop menu horizontally.
21
+ - `vertical`: arranges the related mobile menu vertically.
22
+ - `menuHeader`: adapts both menus to the header context.
23
+ - `containerPGS`: uses containerPGS[header] on the modal wrapper to move the dialog into the header.
24
+ - `right`: presents the mobile navigation dialog content from the right side.
25
25
 
26
26
  ## PGS States
27
27
 
28
- - `mobileActive`: viene applicato a header e header-element quando larghezza o viewport richiedono la navigazione mobile.
28
+ - `mobileActive`: is applied to header and header-element when their width or the viewport requires mobile navigation.
29
29
 
30
- ## Elementi correlati
30
+ ## Related elements
31
31
 
32
- - `logo`: inserisce il marchio nell'area iniziale.
33
- - `logo-text`: usa la variante testuale del logo.
34
- - `menu`: fornisce la navigazione desktop e mobile.
35
- - `buttonIcon`: presenta i controlli tema e hamburger come pulsanti a icona.
36
- - `toggleDarkmode`: collega il controllo al gestore globale del tema.
37
- - `modal`: fornisce apertura e chiusura della navigazione mobile.
38
- - `modal-button`: apre il pannello mobile.
39
- - `modal-close`: chiude il pannello mobile e condivide il controllo hamburger.
40
- - `modal-dialog`: identifica il dialog della navigazione mobile.
41
- - `modal-dialog-content`: identifica il pannello interno della navigazione mobile.
32
+ - `logo`: inserts the brand into the initial area.
33
+ - `logo-text`: uses the text variant of the logo.
34
+ - `menu`: provides desktop and mobile navigation.
35
+ - `buttonIcon`: presents theme and hamburger controls as icon buttons.
36
+ - `toggleDarkmode`: connects the control to the global theme handler.
37
+ - `modal`: provides opening and closing behavior for mobile navigation.
38
+ - `modal-button`: opens the mobile panel.
39
+ - `modal-close`: closes the mobile panel and shares the hamburger control.
40
+ - `modal-dialog`: identifies the mobile navigation dialog.
41
+ - `modal-dialog-content`: identifies the inner mobile navigation panel.
42
42
 
43
43
  ## Output
44
44
 
45
- Header HTML completo con navigazione desktop e pannello mobile laterale.
45
+ Complete header HTML with desktop navigation and a side mobile panel.
46
46
 
47
- ## Esempio
47
+ ## Example
48
48
 
49
49
  ```html
50
50
  <header pgs="header">
@@ -56,10 +56,10 @@ Header HTML completo con navigazione desktop e pannello mobile laterale.
56
56
  </div>
57
57
 
58
58
  <div pgs="header-element-onlyDesktop">
59
- <nav pgs="menu" pgs-option="horizontal menuHeader" aria-label="Menu principale">
59
+ <nav pgs="menu" pgs-option="horizontal menuHeader" aria-label="Main menu">
60
60
  <ul>
61
61
  <li><a href="/">Home</a></li>
62
- <li><a href="#componenti">Componenti</a></li>
62
+ <li><a href="#components">Components</a></li>
63
63
  <li><a href="#layout">Layout</a></li>
64
64
  </ul>
65
65
  </nav>
@@ -69,7 +69,7 @@ Header HTML completo con navigazione desktop e pannello mobile laterale.
69
69
  </div>
70
70
 
71
71
  <div pgs="header-element-alwaysOnLast">
72
- <button pgs="buttonIcon toggleDarkmode" type="button" aria-label="Cambia tema">
72
+ <button pgs="buttonIcon toggleDarkmode" type="button" aria-label="Change theme">
73
73
  <i class="fa-solid fa-moon"></i>
74
74
  </button>
75
75
  </div>
@@ -80,10 +80,10 @@ Header HTML completo con navigazione desktop e pannello mobile laterale.
80
80
 
81
81
  <dialog pgs="modal-dialog" pgs-option="right">
82
82
  <div pgs="modal-dialog-content">
83
- <nav pgs="menu" pgs-option="vertical menuHeader" aria-label="Menu mobile">
83
+ <nav pgs="menu" pgs-option="vertical menuHeader" aria-label="Mobile menu">
84
84
  <ul>
85
85
  <li><a href="/">Home</a></li>
86
- <li><a href="#componenti">Componenti</a></li>
86
+ <li><a href="#components">Components</a></li>
87
87
  <li><a href="#layout">Layout</a></li>
88
88
  </ul>
89
89
  </nav>
@@ -1,26 +1,26 @@
1
- <!-- File generato automaticamente da templates/html/layout/pageShell.html. Modificare templates/html/layout/pageShell.html e rieseguire npm run docs:generate. -->
1
+ <!-- Automatically generated from templates/html/layout/pageShell.html. Edit templates/html/layout/pageShell.html and run npm run docs:generate again. -->
2
2
 
3
3
  # Page Shell
4
4
 
5
- Layout di pagina responsive che combina un contenuto principale con zero, una o due barre laterali scorrevoli, adattandone larghezza e posizione.
5
+ Responsive page layout that combines main content with zero, one, or two scrollable sidebars and adapts their width and position.
6
6
 
7
7
  ## PGS
8
8
 
9
- - `pageShell`: identifica il contenitore che calcola la composizione di main e aside.
10
- - `pageShell-aside`: identifica una barra laterale posizionabile prima o dopo il contenuto.
11
- - `pageShell-aside-scroll`: identifica l'area interna che può restare visibile durante lo scorrimento.
12
- - `pageShell-content`: identifica il contenuto principale della pagina.
9
+ - `pageShell`: identifies the container that calculates the main and aside composition.
10
+ - `pageShell-aside`: identifies a sidebar that can be placed before or after the content.
11
+ - `pageShell-aside-scroll`: identifies the inner area that can remain visible while scrolling.
12
+ - `pageShell-content`: identifies the main page content.
13
13
 
14
- ## Elementi correlati
14
+ ## Related elements
15
15
 
16
- - `flexColumnTexts`: organizza i testi contenuti nelle barre laterali.
17
- - `flexColumnElements`: organizza verticalmente gli elementi delle sezioni principali.
16
+ - `flexColumnTexts`: organizes text contained in the sidebars.
17
+ - `flexColumnElements`: vertically organizes elements in the main sections.
18
18
 
19
19
  ## Output
20
20
 
21
- Quattro configurazioni HTML di page shell con due, una o nessuna barra laterale.
21
+ Four page-shell HTML configurations with two, one, or no sidebars.
22
22
 
23
- ## Esempio
23
+ ## Example
24
24
 
25
25
  ```html
26
26
  <div pgs="pageShell">
@@ -1,68 +1,68 @@
1
- <!-- File generato automaticamente da templates/html/layout/section.html. Modificare templates/html/layout/section.html e rieseguire npm run docs:generate. -->
1
+ <!-- Automatically generated from templates/html/layout/section.html. Edit templates/html/layout/section.html and run npm run docs:generate again. -->
2
2
 
3
3
  # Section
4
4
 
5
- Varianti di sezione che controllano larghezza, padding e trattamento di contenuti specifici mantenendo la spaziatura verticale condivisa.
5
+ Section variants that control width, padding, and specific content treatment while preserving shared vertical spacing.
6
6
 
7
7
  ## PGS
8
8
 
9
- - `section`: identifica la sezione standard con contenuto centrato.
10
- - `sectionFull`: identifica una sezione estesa a tutta la larghezza disponibile.
11
- - `sectionSpecificity`: identifica una sezione che applica una struttura specifica al relativo figlio.
12
- - `sectionSpecificity-child`: identifica il contenuto figlio gestito dalla variante sectionSpecificity.
13
- - `sectionMax`: identifica una sezione con larghezza massima estesa.
14
- - `sectionNoPadding`: identifica una sezione priva del padding standard.
9
+ - `section`: identifies the standard section with centered content.
10
+ - `sectionFull`: identifies a section that spans the full available width.
11
+ - `sectionSpecificity`: identifies a section that applies a specific structure to its child.
12
+ - `sectionSpecificity-child`: identifies child content managed by the sectionSpecificity variant.
13
+ - `sectionMax`: identifies a section with an extended maximum width.
14
+ - `sectionNoPadding`: identifies a section without standard padding.
15
15
 
16
- ## Elementi correlati
16
+ ## Related elements
17
17
 
18
- - `flexColumnSections`: distanzia verticalmente tutte le sezioni dell'esempio.
19
- - `flexColumnElements`: organizza verticalmente gli elementi principali di ogni sezione.
20
- - `flexColumnTexts`: organizza e distanzia i contenuti interni.
21
- - `card-img`: riutilizza il trattamento delle immagini card nelle sezioni dimostrative.
22
- - `imgCover`: adatta le immagini alla larghezza della sezione.
18
+ - `flexColumnSections`: vertically spaces all sections in the example.
19
+ - `flexColumnElements`: vertically organizes the main elements of each section.
20
+ - `flexColumnTexts`: organizes and spaces inner content.
21
+ - `card-img`: reuses card image treatment in the demonstration sections.
22
+ - `imgCover`: scales images to the section width.
23
23
 
24
24
  ## Output
25
25
 
26
- Raccolta HTML delle varianti di section disponibili.
26
+ HTML collection of the available section variants.
27
27
 
28
- ## Esempio
28
+ ## Example
29
29
 
30
30
  ```html
31
31
  <div pgs="flexColumnSections">
32
32
  <section pgs="section flexColumnElements">
33
33
  <div pgs="flexColumnTexts">
34
- <strong>Sezione standard</strong>
35
- <p>Contenuto centrato dentro una sezione MyPGS.</p>
34
+ <strong>Standard section</strong>
35
+ <p>Centered content inside a MyPGS section.</p>
36
36
  </div>
37
37
  </section>
38
38
 
39
39
  <section pgs="sectionFull flexColumnElements">
40
40
  <div pgs="flexColumnTexts">
41
- <strong>Sezione full-width</strong>
42
- <p>Contenuto centrato dentro una sezione MyPGS.</p>
41
+ <strong>Full-width section</strong>
42
+ <p>Centered content inside a MyPGS section.</p>
43
43
  </div>
44
44
  </section>
45
45
 
46
46
  <section pgs="sectionSpecificity flexColumnElements">
47
47
  <div pgs="flexColumnTexts">
48
- <img pgs="card-img imgCover" src="https://placehold.co/800x200?text=Hero" alt="Immagine segnaposto">
48
+ <img pgs="card-img imgCover" src="https://placehold.co/800x200?text=Hero" alt="Placeholder image">
49
49
  </div>
50
50
  <div pgs="sectionSpecificity-child flexColumnTexts">
51
- <strong>Sezione specificità-child</strong>
52
- <p>Contenuto centrato dentro una sezione MyPGS.</p>
51
+ <strong>Specificity-child section</strong>
52
+ <p>Centered content inside a MyPGS section.</p>
53
53
  </div>
54
54
  </section>
55
55
 
56
56
  <section pgs="sectionMax flexColumnElements" style="background-color: var(--color-primary-soft)">
57
57
  <div pgs="flexColumnTexts">
58
- <strong>Sezione max-width</strong>
59
- <p>Contenuto centrato dentro una sezione MyPGS.</p>
58
+ <strong>Max-width section</strong>
59
+ <p>Centered content inside a MyPGS section.</p>
60
60
  </div>
61
61
  </section>
62
62
 
63
63
  <section pgs="sectionNoPadding flexColumnElements">
64
64
  <div pgs="flexColumnTexts">
65
- <img pgs="card-img imgCover" src="https://placehold.co/800x500?text=HI!" alt="Immagine segnaposto">
65
+ <img pgs="card-img imgCover" src="https://placehold.co/800x500?text=HI!" alt="Placeholder image">
66
66
  </div>
67
67
  </section>
68
68
  </div>
@@ -1,48 +1,48 @@
1
- <!-- File generato automaticamente da templates/html/patterns/cookieConsent.html. Modificare templates/html/patterns/cookieConsent.html e rieseguire npm run docs:generate. -->
1
+ <!-- Automatically generated from templates/html/patterns/cookieConsent.html. Edit templates/html/patterns/cookieConsent.html and run npm run docs:generate again. -->
2
2
 
3
3
  # Cookie Consent
4
4
 
5
- Pattern accessibile per raccogliere e memorizzare il consenso ai cookie analitici, applicare le preferenze e caricare Google Analytics solo quando autorizzato.
5
+ Accessible pattern for collecting and storing analytics cookie consent, applying preferences, and loading Google Analytics only when authorized.
6
6
 
7
7
  ## PGS
8
8
 
9
- - `cookieConsent`: identifica il pannello principale inizializzato dal pattern JavaScript.
10
- - `cookieConsent-panel`: identifica il gruppo delle preferenze configurabili.
11
- - `cookieConsent-featureEssential`: identifica la riga dei cookie tecnici sempre attivi.
12
- - `cookieConsent-panel-badge`: identifica l'indicatore dello stato dei cookie tecnici.
13
- - `cookieConsent-featureAnalytics`: identifica la riga dei cookie analitici opzionali.
14
- - `cookieConsent-toggleAnalytics`: identifica il controllo che abilita il consenso analytics.
15
- - `cookieConsent-actionReject`: applica le preferenze selezionate senza accettare automaticamente analytics.
16
- - `cookieConsent-actionAccept`: accetta tutti i cookie disponibili.
17
- - `cookieConsent-actionOpen`: identifica controlli esterni che riaprono il pannello delle preferenze.
18
- - `cookieConsent-gaUnavailable`: token runtime applicato al root quando manca un measurement ID utilizzabile.
19
- - `cookieConsent-accepted`: token runtime applicato al root quando analytics è consentito.
20
- - `cookieConsent-declined`: token runtime applicato al root quando analytics non è consentito.
21
-
22
- ## Elementi correlati
23
-
24
- - `flexColumn`: organizza verticalmente il pannello delle preferenze.
25
- - `flexRow`: dispone righe e azioni del pannello.
26
- - `nowrap`: impedisce il ritorno a capo nella riga dei cookie essenziali.
27
- - `toggle`: presenta il consenso analytics come interruttore.
28
- - `button`: presenta l'azione di selezione con lo stile standard.
29
- - `buttonStrong`: presenta l'accettazione completa come azione primaria.
9
+ - `cookieConsent`: identifies the main panel initialized by the JavaScript pattern.
10
+ - `cookieConsent-panel`: identifies the configurable preference group.
11
+ - `cookieConsent-featureEssential`: identifies the row of always-active essential cookies.
12
+ - `cookieConsent-panel-badge`: identifies the essential-cookie status indicator.
13
+ - `cookieConsent-featureAnalytics`: identifies the optional analytics-cookie row.
14
+ - `cookieConsent-toggleAnalytics`: identifies the control that enables analytics consent.
15
+ - `cookieConsent-actionReject`: applies selected preferences without automatically accepting analytics.
16
+ - `cookieConsent-actionAccept`: accepts all available cookies.
17
+ - `cookieConsent-actionOpen`: identifies external controls that reopen the preference panel.
18
+ - `cookieConsent-gaUnavailable`: runtime token applied to the root when no usable measurement ID is available.
19
+ - `cookieConsent-accepted`: runtime token applied to the root when analytics is allowed.
20
+ - `cookieConsent-declined`: runtime token applied to the root when analytics is not allowed.
21
+
22
+ ## Related elements
23
+
24
+ - `flexColumn`: vertically organizes the preference panel.
25
+ - `flexRow`: arranges panel rows and actions.
26
+ - `nowrap`: prevents wrapping in the essential-cookie row.
27
+ - `toggle`: presents analytics consent as a switch.
28
+ - `button`: presents the selection action with standard styling.
29
+ - `buttonStrong`: presents full acceptance as the primary action.
30
30
 
31
31
  ## Output
32
32
 
33
- Pannello HTML di consenso con preferenze tecniche e analytics, azioni e attributi accessibili.
33
+ Consent panel HTML with essential and analytics preferences, actions, and accessible attributes.
34
34
 
35
- ## Esempio
35
+ ## Example
36
36
 
37
37
  ```html
38
38
  <section id="pgs-cookieConsent" pgs="cookieConsent" role="dialog" aria-modal="true" data-ga-id="G-XXXXXXXXXX" hidden tabindex="-1">
39
- <p><i class="fa-duotone fa-solid fa-cookie-bite"></i> Cookie e privacy <br></p>
40
- <h2>La tua privacy prima di tutto</h2>
39
+ <p><i class="fa-duotone fa-solid fa-cookie-bite"></i> Cookies and privacy <br></p>
40
+ <h2>Your privacy comes first</h2>
41
41
 
42
42
  <p>
43
- Utilizziamo cookie tecnici per offrire il servizio e, previo consenso, cookie analitici di
44
- <strong>Google Analytics</strong> per misurare in modo anonimo il traffico e migliorare i contenuti.
45
- Puoi modificare la scelta in qualsiasi momento.
43
+ We use essential cookies to provide the service and, with your consent, analytics cookies from
44
+ <strong>Google Analytics</strong> to measure traffic anonymously and improve our content.
45
+ You can change your choice at any time.
46
46
  </p>
47
47
 
48
48
  <p>
@@ -50,17 +50,17 @@ Pannello HTML di consenso con preferenze tecniche e analytics, azioni e attribut
50
50
  <a href="/cookie-policy/" target="_blank" rel="noopener">Cookie Policy</a>
51
51
  </p>
52
52
 
53
- <div pgs="cookieConsent-panel flexColumn" role="group" aria-label="Preferenze cookie">
53
+ <div pgs="cookieConsent-panel flexColumn" role="group" aria-label="Cookie preferences">
54
54
  <div pgs="flexRow nowrap cookieConsent-featureEssential">
55
55
  <div>
56
56
  <p>
57
- <strong>Cookie tecnici</strong>
57
+ <strong>Essential cookies</strong>
58
58
  <br>
59
- <small>Sempre attivi per garantire il corretto funzionamento del sito.</small>
59
+ <small>Always active to ensure the website works correctly.</small>
60
60
  </p>
61
61
  </div>
62
62
 
63
- <span pgs="cookieConsent-panel-badge">Attivi</span>
63
+ <span pgs="cookieConsent-panel-badge">Active</span>
64
64
  </div>
65
65
 
66
66
  <div pgs="flexRow cookieConsent-featureAnalytics">
@@ -68,21 +68,21 @@ Pannello HTML di consenso con preferenze tecniche e analytics, azioni e attribut
68
68
  <p>
69
69
  <strong>Analytics</strong>
70
70
  <br>
71
- <small>Dati di navigazione raccolti in forma aggregata per statistiche anonime.</small>
71
+ <small>Browsing data collected in aggregate form for anonymous statistics.</small>
72
72
  </p>
73
73
 
74
- <input type="checkbox" pgs="cookieConsent-toggleAnalytics" aria-label="Abilita Google Analytics">
74
+ <input type="checkbox" pgs="cookieConsent-toggleAnalytics" aria-label="Enable Google Analytics">
75
75
  </label>
76
76
  </div>
77
77
  </div>
78
78
 
79
79
  <div pgs="flexRow">
80
80
  <button type="button" pgs="button cookieConsent-actionReject">
81
- <i class="fa-solid fa-duotone fa-sliders"></i>Solo selezionati
81
+ <i class="fa-solid fa-duotone fa-sliders"></i>Selected only
82
82
  </button>
83
83
 
84
84
  <button type="button" pgs="buttonStrong cookieConsent-actionAccept">
85
- <i class="fa-solid fa-check"></i> Accetta tutto
85
+ <i class="fa-solid fa-check"></i> Accept all
86
86
  </button>
87
87
  </div>
88
88
  </section>
@@ -1,6 +1,6 @@
1
- # Utilizzo CSS/SCSS
1
+ # CSS/SCSS usage
2
2
 
3
- La libreria espone molte custom properties da preferire agli hardcode, per esempio:
3
+ The library exposes many custom properties that should be preferred to hardcoded values, for example:
4
4
 
5
5
  ```scss
6
6
  :root {
@@ -13,7 +13,7 @@ La libreria espone molte custom properties da preferire agli hardcode, per esemp
13
13
  }
14
14
  ```
15
15
 
16
- Override consigliato:
16
+ Recommended override:
17
17
 
18
18
  ```scss
19
19
  #danger-action {
@@ -22,15 +22,15 @@ Override consigliato:
22
22
  }
23
23
  ```
24
24
 
25
- Evita di riscrivere da zero padding, gap, border-radius o colori se esiste gia' una variabile o un token PGS adatto.
25
+ Avoid rewriting padding, gaps, border radii, or colors from scratch when a suitable variable or PGS token already exists.
26
26
 
27
- ## Il sistema `pgs`
27
+ ## The `pgs` system
28
28
 
29
- Il markup usa token separati da spazio dentro l'attributo `pgs`:
29
+ Markup uses space-separated tokens inside the `pgs` attribute:
30
30
 
31
31
  ```html
32
- <button pgs="button buttonStrong" type="button">Salva</button>
32
+ <button pgs="button buttonStrong" type="button">Save</button>
33
33
  <section pgs="section flexColumnElements"></section>
34
34
  ```
35
35
 
36
- Gli stessi token collegano HTML, SCSS e JavaScript.
36
+ The same tokens connect HTML, SCSS, and JavaScript.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "mypgs",
3
- "version": "2.0.0",
3
+ "version": "2.1.0",
4
4
  "description": "MyPGS frontend theme and UI behaviors, with bundled JavaScript and CSS assets.",
5
5
  "main": "./dist/javascript/index.js",
6
6
  "module": "./assets/javascript/index.js",