mypgs 2.1.0 → 3.0.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 (135) hide show
  1. package/.vscode/tasks.json +39 -0
  2. package/AGENTS.md +22 -21
  3. package/README.md +2 -2
  4. package/assets/javascript/components/_menu.js +2 -1
  5. package/assets/javascript/components/_modals.js +1 -1
  6. package/assets/javascript/components/_notifications.js +2 -1
  7. package/assets/javascript/components/_slides.js +2 -2
  8. package/assets/scss/base/_body.scss +5 -5
  9. package/assets/scss/base/_general.scss +27 -18
  10. package/assets/scss/base/_variables.scss +1 -1
  11. package/assets/scss/components/_accordion.scss +9 -7
  12. package/assets/scss/components/_alerts.scss +71 -0
  13. package/assets/scss/components/_badges.scss +40 -48
  14. package/assets/scss/components/_button.scss +27 -19
  15. package/assets/scss/components/_card.scss +9 -4
  16. package/assets/scss/components/_formAddon.scss +5 -1
  17. package/assets/scss/components/_logo.scss +3 -4
  18. package/assets/scss/components/_menu.scss +26 -3
  19. package/assets/scss/components/_modals.scss +2 -2
  20. package/assets/scss/components/_stepTabs.scss +2 -1
  21. package/assets/scss/index.scss +2 -3
  22. package/assets/scss/layout/_header.scss +3 -3
  23. package/assets/scss/layout/_responsive.scss +63 -0
  24. package/assets/scss/mixin/_mx-base.scss +4 -8
  25. package/assets/scss/mixin/_mx-button.scss +74 -70
  26. package/assets/scss/mixin/_mx-card.scss +33 -36
  27. package/assets/scss/mixin/_mx-form.scss +10 -5
  28. package/assets/scss/mixin/_mx-formAddon.scss +100 -58
  29. package/assets/scss/mixin/_mx-hover.scss +21 -15
  30. package/assets/scss/mixin/_mx-responsive.scss +81 -201
  31. package/demo/demo.css +9 -6
  32. package/demo/demo.html +7 -5
  33. package/demo/demo.js +34 -32
  34. package/dist/css/index.css +2502 -3507
  35. package/dist/css/index.css.map +1 -1
  36. package/dist/css/index.min.css +1 -1
  37. package/dist/javascript/index.js +7 -5
  38. package/dist/javascript/index.js.map +1 -1
  39. package/dist/javascript/index.min.js +1 -1
  40. package/docs/componenti-e-markup.md +5 -5
  41. package/docs/components/accordion.md +3 -3
  42. package/docs/components/alerts.md +67 -0
  43. package/docs/components/badges.md +11 -8
  44. package/docs/components/breadcumbs.md +1 -1
  45. package/docs/components/button.md +9 -9
  46. package/docs/components/card.md +9 -6
  47. package/docs/components/dropdown.md +1 -1
  48. package/docs/components/form.md +6 -5
  49. package/docs/components/formAddon.md +56 -19
  50. package/docs/components/logo.md +1 -1
  51. package/docs/components/menu.md +2 -2
  52. package/docs/components/modal.md +7 -6
  53. package/docs/components/notification.md +2 -2
  54. package/docs/components/search.md +8 -7
  55. package/docs/components/slides.md +5 -6
  56. package/docs/components/stepTabs.md +7 -7
  57. package/docs/components/steps.md +1 -1
  58. package/docs/components/summary.md +1 -1
  59. package/docs/components/table.md +1 -1
  60. package/docs/components/tooltip.md +4 -3
  61. package/docs/convenzioni.md +1 -1
  62. package/docs/export-e-sviluppo.md +1 -1
  63. package/docs/helper-javascript.md +1 -1
  64. package/docs/layout/body.md +1 -1
  65. package/docs/layout/footer.md +7 -3
  66. package/docs/layout/header.md +5 -4
  67. package/docs/layout/pageShell.md +11 -11
  68. package/docs/layout/responsive.md +90 -0
  69. package/docs/layout/section.md +16 -16
  70. package/docs/patterns/cookieConsent.md +6 -3
  71. package/docs/utilizzo-css-scss.md +26 -2
  72. package/package.json +1 -1
  73. package/{templates → reference}/html/components/accordion.html +2 -2
  74. package/reference/html/components/alerts.html +59 -0
  75. package/{templates → reference}/html/components/badges.html +9 -7
  76. package/{templates → reference}/html/components/button.html +7 -7
  77. package/{templates → reference}/html/components/card.html +7 -5
  78. package/{templates → reference}/html/components/form.html +5 -4
  79. package/reference/html/components/formAddon.html +109 -0
  80. package/{templates → reference}/html/components/menu.html +2 -2
  81. package/{templates → reference}/html/components/modal.html +6 -5
  82. package/{templates → reference}/html/components/notification.html +2 -2
  83. package/{templates → reference}/html/components/search.html +7 -6
  84. package/{templates → reference}/html/components/slides.html +4 -5
  85. package/{templates → reference}/html/components/stepTabs.html +6 -6
  86. package/{templates → reference}/html/components/tooltip.html +3 -2
  87. package/{templates → reference}/html/layout/footer.html +5 -2
  88. package/{templates → reference}/html/layout/header.html +4 -3
  89. package/{templates → reference}/html/layout/pageShell.html +10 -10
  90. package/reference/html/layout/responsive.html +83 -0
  91. package/{templates → reference}/html/layout/section.html +15 -15
  92. package/{templates → reference}/html/patterns/cookieConsent.html +4 -2
  93. package/{templates → reference}/react/components/accordion.jsx +1 -1
  94. package/reference/react/components/alerts.jsx +46 -0
  95. package/{templates → reference}/react/components/button.jsx +4 -4
  96. package/{templates → reference}/react/components/card.jsx +2 -2
  97. package/{templates → reference}/react/components/form.jsx +1 -1
  98. package/{templates → reference}/react/components/modal.jsx +2 -2
  99. package/{templates → reference}/react/components/search.jsx +4 -4
  100. package/{templates → reference}/react/components/slides.jsx +1 -1
  101. package/{templates → reference}/react/components/stepTabs.jsx +4 -4
  102. package/{templates → reference}/react/components/tooltip.jsx +1 -1
  103. package/{templates → reference}/react/layout/pageShell.jsx +2 -2
  104. package/reference/react/layout/responsive.jsx +61 -0
  105. package/{templates → reference}/react/layout/section.jsx +12 -12
  106. package/{templates → reference}/react/patterns/cookieConsent.jsx +1 -1
  107. package/{templates → reference}/react/patterns/footer.jsx +1 -1
  108. package/{templates → reference}/react/patterns/header.jsx +2 -2
  109. package/scripts/generate-component-docs.js +8 -8
  110. package/assets/scss/layout/_flex.scss +0 -49
  111. package/assets/scss/layout/_gap.scss +0 -21
  112. package/assets/scss/layout/_grid.scss +0 -13
  113. package/docs/layout/flex.md +0 -116
  114. package/docs/layout/grid.md +0 -116
  115. package/templates/html/components/formAddon.html +0 -72
  116. package/templates/html/layout/flex.html +0 -109
  117. package/templates/html/layout/grid.html +0 -109
  118. package/templates/react/layout/flex.jsx +0 -36
  119. package/templates/react/layout/grid.jsx +0 -36
  120. /package/{templates → reference}/html/components/breadcumbs.html +0 -0
  121. /package/{templates → reference}/html/components/dropdown.html +0 -0
  122. /package/{templates → reference}/html/components/logo.html +0 -0
  123. /package/{templates → reference}/html/components/steps.html +0 -0
  124. /package/{templates → reference}/html/components/summary.html +0 -0
  125. /package/{templates → reference}/html/components/table.html +0 -0
  126. /package/{templates → reference}/html/layout/body.html +0 -0
  127. /package/{templates → reference}/react/components/breadcumbs.jsx +0 -0
  128. /package/{templates → reference}/react/components/dropdown.jsx +0 -0
  129. /package/{templates → reference}/react/components/logo.jsx +0 -0
  130. /package/{templates → reference}/react/components/menu.jsx +0 -0
  131. /package/{templates → reference}/react/components/notification.jsx +0 -0
  132. /package/{templates → reference}/react/components/steps.jsx +0 -0
  133. /package/{templates → reference}/react/components/summary.jsx +0 -0
  134. /package/{templates → reference}/react/components/table.jsx +0 -0
  135. /package/{templates → reference}/react/layout/body.jsx +0 -0
@@ -1,4 +1,4 @@
1
- <!-- Automatically generated from templates/html/components/formAddon.html. Edit templates/html/components/formAddon.html and run npm run docs:generate again. -->
1
+ <!-- Automatically generated from reference/html/components/formAddon.html. Edit reference/html/components/formAddon.html and run npm run docs:generate again. -->
2
2
 
3
3
  # Form Add-ons
4
4
 
@@ -9,12 +9,15 @@ Additional form controls for selectable cards, two-state buttons, switches, and
9
9
  - `checkboxBackground`: presents a checkbox as a selectable container with a highlighted checked state.
10
10
  - `twoState`: presents checkbox or radio labels as buttons whose appearance changes when selected.
11
11
  - `toggle`: presents a checkbox as a switch with a rail and movable thumb.
12
+ - `chip`: presents an individual checkbox or radio option as a compact selectable button.
12
13
  - `chips`: groups twoState controls into a compact segmented selector.
13
14
 
14
15
  ## Related elements
15
16
 
16
- - `flexColumnElements`: vertically arranges the form add-on examples.
17
- - `flexColumnTexts`: groups each example with its heading and control.
17
+ - `form`: applies the base form styles to the complete add-on example.
18
+ - `flexColumn`: vertically arranges each example with its heading and control.
19
+ - `flexRow`: horizontally arranges standalone chip controls.
20
+ - `gapElements`: applies element spacing between the form add-on examples.
18
21
 
19
22
  ## Output
20
23
 
@@ -23,8 +26,8 @@ HTML examples of the checkboxBackground, twoState, toggle, and chips form contro
23
26
  ## Example
24
27
 
25
28
  ```html
26
- <div pgs="flexColumnElements">
27
- <section pgs="flexColumnTexts">
29
+ <form pgs="form flexColumn gapElements">
30
+ <section pgs="flexColumn">
28
31
  <strong>Checkbox with background</strong>
29
32
 
30
33
  <label pgs="checkboxBackground">
@@ -36,7 +39,7 @@ HTML examples of the checkboxBackground, twoState, toggle, and chips form contro
36
39
  </label>
37
40
  </section>
38
41
 
39
- <section pgs="flexColumnTexts">
42
+ <section pgs="flexColumn">
40
43
  <strong>Two-state controls</strong>
41
44
 
42
45
  <label pgs="twoState">
@@ -46,34 +49,68 @@ HTML examples of the checkboxBackground, twoState, toggle, and chips form contro
46
49
  </label>
47
50
  </section>
48
51
 
49
- <section pgs="flexColumnTexts">
52
+ <section pgs="flexColumn">
50
53
  <strong>Toggle</strong>
51
54
 
52
55
  <label pgs="toggle">
53
- <span>Enable dark mode</span>
56
+ <span>Enable Wi-Fi</span>
54
57
  <input type="checkbox" name="darkMode" value="enabled">
55
58
  </label>
56
59
  </section>
57
60
 
58
- <section pgs="flexColumnTexts">
59
- <strong>Chips</strong>
61
+ <section pgs="flexColumn">
62
+ <strong>Chips checkbox</strong>
63
+ <div pgs="flexRow" role="group" aria-label="Chip actions">
64
+ <label pgs="chip">
65
+ <input type="checkbox" name="like" value="basic">
66
+ <i class="fa-solid fa-heart"></i>
67
+ Like
68
+ </label>
69
+ <label pgs="chip">
70
+ <input type="checkbox" name="share" value="basic">
71
+ <i class="fa-solid fa-share"></i>
72
+ Share
73
+ </label>
74
+ </div>
75
+ </section>
60
76
 
61
- <div pgs="chips" role="group" aria-label="Select a plan">
62
- <label pgs="twoState">
63
- <input type="radio" name="plan" value="basic" checked>
77
+ <section pgs="flexColumn gapElements">
78
+ <fieldset pgs="chips">
79
+ <legend>Chip checkbox</legend>
80
+ <label>
81
+ <input type="checkbox" name="plan" value="basic" checked>
64
82
  Basic
65
83
  </label>
66
84
 
67
- <label pgs="twoState">
68
- <input type="radio" name="plan" value="pro">
85
+ <label>
86
+ <input type="checkbox" name="plan" value="pro">
69
87
  Pro
70
88
  </label>
71
89
 
72
- <label pgs="twoState">
73
- <input type="radio" name="plan" value="enterprise">
90
+ <label>
91
+ <input type="checkbox" name="plan" value="enterprise">
74
92
  Enterprise
75
93
  </label>
76
- </div>
94
+ </fieldset>
95
+
96
+ <fieldset pgs="chips">
97
+ <legend>Chips radio</legend>
98
+ <label>
99
+ <input type="radio" name="characters" value="basic" checked>
100
+ <i class="fa-solid fa-crow"></i>
101
+ Crow
102
+ </label>
103
+
104
+ <label>
105
+ <i class="fa-solid fa-dove"></i> <input type="radio" name="characters" value="pro">
106
+ Dove
107
+ </label>
108
+
109
+ <label>
110
+ <i class="fa-solid fa-dragon"></i> <input type="radio" name="characters" value="enterprise">
111
+ dragon
112
+ </label>
113
+ </fieldset>
77
114
  </section>
78
- </div>
115
+ </form>
79
116
  ```
@@ -1,4 +1,4 @@
1
- <!-- Automatically generated from templates/html/components/logo.html. Edit templates/html/components/logo.html and run npm run docs:generate again. -->
1
+ <!-- Automatically generated from reference/html/components/logo.html. Edit reference/html/components/logo.html and run npm run docs:generate again. -->
2
2
 
3
3
  # Logo
4
4
 
@@ -1,4 +1,4 @@
1
- <!-- Automatically generated from templates/html/components/menu.html. Edit templates/html/components/menu.html and run npm run docs:generate again. -->
1
+ <!-- Automatically generated from reference/html/components/menu.html. Edit reference/html/components/menu.html and run npm run docs:generate again. -->
2
2
 
3
3
  # Menu
4
4
 
@@ -15,6 +15,7 @@ Menu markup, configuration, behavior, and usage example.
15
15
  - `vertical`: identifies the vertical element used by Menu.
16
16
  - `menuHeader`: identifies the menuHeader element used by Menu.
17
17
  - `position`: identifies the position element used by Menu.
18
+ - `buttonNohover`: disables hover behavior on menu buttons generated at runtime.
18
19
 
19
20
  ## PGS States
20
21
 
@@ -30,7 +31,6 @@ Menu markup, configuration, behavior, and usage example.
30
31
 
31
32
  - `dropdown`: uses the related dropdown component or utility in this example.
32
33
  - `dropdown-button`: uses the related dropdown-button component or utility in this example.
33
- - `buttonNohover`: uses the related buttonNohover component or utility in this example.
34
34
  - `dropdown-content`: uses the related dropdown-content component or utility in this example.
35
35
 
36
36
  ## Output
@@ -1,4 +1,4 @@
1
- <!-- Automatically generated from templates/html/components/modal.html. Edit templates/html/components/modal.html and run npm run docs:generate again. -->
1
+ <!-- Automatically generated from reference/html/components/modal.html. Edit reference/html/components/modal.html and run npm run docs:generate again. -->
2
2
 
3
3
  # Modal
4
4
 
@@ -24,6 +24,8 @@ Modal markup, configuration, behavior, and usage example.
24
24
  - `topLevel`: identifies the topLevel element used by Modal.
25
25
  - `left`: identifies the left element used by Modal.
26
26
  - `right`: identifies the right element used by Modal.
27
+ - `buttonStrong`: applies stronger emphasis to the save action.
28
+ - `buttonClose`: styles the close action generated at runtime.
27
29
 
28
30
  ## JavaScript API
29
31
 
@@ -38,9 +40,8 @@ Modal markup, configuration, behavior, and usage example.
38
40
  ## Related elements
39
41
 
40
42
  - `button`: uses the related button component or utility in this example.
41
- - `buttonStrong`: uses the related buttonStrong component or utility in this example.
42
- - `buttonClose`: uses the related buttonClose component or utility in this example.
43
- - `flexColumnElements`: uses the related flexColumnElements component or utility in this example.
43
+ - `flexColumn`: vertically organizes modal content.
44
+ - `gapElements`: applies element spacing to modal content.
44
45
  - `flexRow`: uses the related flexRow component or utility in this example.
45
46
 
46
47
  ## Output
@@ -115,12 +116,12 @@ Complete HTML markup and usage example for Modal.
115
116
  <h3>Save changes?</h3>
116
117
  </div>
117
118
 
118
- <div pgs="modal-dialog-content-scroll flexColumnElements">
119
+ <div pgs="modal-dialog-content-scroll flexColumn gapElements">
119
120
  <p>You have unsaved changes. Confirm to apply them or cancel to return to the page.</p>
120
121
 
121
122
  <div pgs="flexRow">
122
123
  <button pgs="button modal-close" type="button">Cancel</button>
123
- <button pgs="buttonStrong" type="button">Save changes</button>
124
+ <button pgs="button" pgs-option="buttonStrong" type="button">Save changes</button>
124
125
  </div>
125
126
  </div>
126
127
  </div>
@@ -1,4 +1,4 @@
1
- <!-- Automatically generated from templates/html/components/notification.html. Edit templates/html/components/notification.html and run npm run docs:generate again. -->
1
+ <!-- Automatically generated from reference/html/components/notification.html. Edit reference/html/components/notification.html and run npm run docs:generate again. -->
2
2
 
3
3
  # Notification
4
4
 
@@ -16,6 +16,7 @@ Notification markup, configuration, behavior, and usage example.
16
16
 
17
17
  - `toast`: identifies the toast element used by Notification.
18
18
  - `notification`: identifies the notification element used by Notification.
19
+ - `buttonClose`: styles the dismiss action generated at runtime.
19
20
 
20
21
  ## PGS States
21
22
 
@@ -41,7 +42,6 @@ Notification markup, configuration, behavior, and usage example.
41
42
  ## Related elements
42
43
 
43
44
  - `hidden`: uses the related hidden component or utility in this example.
44
- - `buttonClose`: uses the related buttonClose component or utility in this example.
45
45
 
46
46
  ## Output
47
47
 
@@ -1,4 +1,4 @@
1
- <!-- Automatically generated from templates/html/components/search.html. Edit templates/html/components/search.html and run npm run docs:generate again. -->
1
+ <!-- Automatically generated from reference/html/components/search.html. Edit reference/html/components/search.html and run npm run docs:generate again. -->
2
2
 
3
3
  # Search
4
4
 
@@ -15,6 +15,8 @@ Search markup, configuration, behavior, and usage example.
15
15
  ## PGS Options
16
16
 
17
17
  - `containerPGS`: identifies the containerPGS element used by Search.
18
+ - `buttonNohover`: disables hover behavior on the search container.
19
+ - `buttonIcon`: presents search and close actions as icon buttons.
18
20
 
19
21
  ## PGS States
20
22
 
@@ -44,11 +46,10 @@ Search markup, configuration, behavior, and usage example.
44
46
 
45
47
  ## Related elements
46
48
 
47
- - `buttonNohover`: uses the related buttonNohover component or utility in this example.
49
+ - `button`: provides the base styling for search controls.
48
50
  - `modal`: uses the related modal component or utility in this example.
49
51
  - `modal-button`: uses the related modal-button component or utility in this example.
50
52
  - `modal-close`: uses the related modal-close component or utility in this example.
51
- - `buttonIcon`: uses the related buttonIcon component or utility in this example.
52
53
  - `flexRow`: uses the related flexRow component or utility in this example.
53
54
  - `section`: uses the related section component or utility in this example.
54
55
 
@@ -59,7 +60,7 @@ Complete HTML markup and usage example for Search.
59
60
  ## Example
60
61
 
61
62
  ```html
62
- <form pgs="buttonNohover search" autocomplete="off" action="" method="get">
63
+ <form pgs="button search" pgs-option="buttonNohover" autocomplete="off" action="" method="get">
63
64
  <button type="submit" title="Search"><i class="fa-solid fa-search"></i></button>
64
65
  <input type="search" name="s" placeholder="Search" value="">
65
66
  <ul pgs="search-suggestions"></ul>
@@ -67,14 +68,14 @@ Complete HTML markup and usage example for Search.
67
68
 
68
69
  <div pgs="modal search-modal" pgs-option="containerPGS[header]">
69
70
 
70
- <button type="button" pgs="modal-button buttonIcon" title="Search">
71
+ <button type="button" pgs="modal-button button" pgs-option="buttonIcon" title="Search">
71
72
  <i class="fa-solid fa-search"></i>
72
73
  </button>
73
74
 
74
75
  <dialog>
75
76
  <div pgs="flexRow section search-mobile">
76
77
 
77
- <form pgs="buttonNohover search" autocomplete="off" action="/" method="get">
78
+ <form pgs="button search" pgs-option="buttonNohover" autocomplete="off" action="/" method="get">
78
79
  <button type="submit" title="Search">
79
80
  <i class="fa-solid fa-search"></i>
80
81
  </button>
@@ -82,7 +83,7 @@ Complete HTML markup and usage example for Search.
82
83
  <input type="search" name="s" placeholder="Search" value="">
83
84
  <ul pgs="search-suggestions"></ul>
84
85
 
85
- <button type="button" pgs="modal-close buttonIcon">
86
+ <button type="button" pgs="modal-close button" pgs-option="buttonIcon">
86
87
  <i class="fa-solid fa-close"></i>
87
88
  </button>
88
89
  </form>
@@ -1,4 +1,4 @@
1
- <!-- Automatically generated from templates/html/components/slides.html. Edit templates/html/components/slides.html and run npm run docs:generate again. -->
1
+ <!-- Automatically generated from reference/html/components/slides.html. Edit reference/html/components/slides.html and run npm run docs:generate again. -->
2
2
 
3
3
  # Slides
4
4
 
@@ -18,6 +18,7 @@ Slides markup, configuration, behavior, and usage example.
18
18
  - `shadowDesktop`: identifies the shadowDesktop element used by Slides.
19
19
  - `notScrollAnimation`: identifies the notScrollAnimation element used by Slides.
20
20
  - `notScrollWithMouse`: identifies the notScrollWithMouse element used by Slides.
21
+ - `buttonIcon`: styles the previous and next actions generated at runtime.
21
22
 
22
23
  ## JavaScript API
23
24
 
@@ -39,8 +40,6 @@ Slides markup, configuration, behavior, and usage example.
39
40
  - `card-img`: uses the related card-img component or utility in this example.
40
41
  - `imgCover`: uses the related imgCover component or utility in this example.
41
42
  - `flexColumn`: uses the related flexColumn component or utility in this example.
42
- - `flexColumnTexts`: uses the related flexColumnTexts component or utility in this example.
43
- - `buttonIcon`: uses the related buttonIcon component or utility in this example.
44
43
 
45
44
  ## Output
46
45
 
@@ -54,7 +53,7 @@ Complete HTML markup and usage example for Slides.
54
53
  <li>
55
54
  <article pgs="card flexColumn">
56
55
  <img pgs="card-img imgCover" src="https://placehold.co/800x500?text=Slide+1" alt="Slide 1">
57
- <div pgs="flexColumnTexts">
56
+ <div pgs="flexColumn">
58
57
  <h3>Slide uno</h3>
59
58
  <p>First slide content.</p>
60
59
  </div>
@@ -64,7 +63,7 @@ Complete HTML markup and usage example for Slides.
64
63
  <li>
65
64
  <article pgs="card flexColumn">
66
65
  <img pgs="card-img imgCover" src="https://placehold.co/800x500?text=Slide+2" alt="Slide 2">
67
- <div pgs="flexColumnTexts">
66
+ <div pgs="flexColumn">
68
67
  <h3>Slide due</h3>
69
68
  <p>Second slide content.</p>
70
69
  </div>
@@ -74,7 +73,7 @@ Complete HTML markup and usage example for Slides.
74
73
  <li>
75
74
  <article pgs="card flexColumn">
76
75
  <img pgs="card-img imgCover" src="https://placehold.co/800x500?text=Slide+3" alt="Slide 3">
77
- <div pgs="flexColumnTexts">
76
+ <div pgs="flexColumn">
78
77
  <h3>Slide tre</h3>
79
78
  <p>Third slide content.</p>
80
79
  </div>
@@ -1,4 +1,4 @@
1
- <!-- Automatically generated from templates/html/components/stepTabs.html. Edit templates/html/components/stepTabs.html and run npm run docs:generate again. -->
1
+ <!-- Automatically generated from reference/html/components/stepTabs.html. Edit reference/html/components/stepTabs.html and run npm run docs:generate again. -->
2
2
 
3
3
  # Step Tabs
4
4
 
@@ -42,8 +42,8 @@ Step Tabs markup, configuration, behavior, and usage example.
42
42
 
43
43
  ## Related elements
44
44
 
45
- - `flexColumnElements`: uses the related flexColumnElements component or utility in this example.
46
- - `flexColumnTexts`: uses the related flexColumnTexts component or utility in this example.
45
+ - `flexColumn`: uses the related flexColumn component or utility in this example.
46
+ - `gapElements`: applies element spacing to the step tab container.
47
47
  - `flexRow`: uses the related flexRow component or utility in this example.
48
48
  - `button`: uses the related button component or utility in this example.
49
49
 
@@ -54,21 +54,21 @@ Complete HTML markup and usage example for Step Tabs.
54
54
  ## Example
55
55
 
56
56
  ```html
57
- <div pgs="stepTabs flexColumnElements">
57
+ <div pgs="stepTabs flexColumn gapElements">
58
58
  <div pgs="stepTabs-dots" aria-label="Avanzamento"></div>
59
59
 
60
60
  <div pgs="stepTabs-container">
61
- <section pgs="tab flexColumnTexts" tabindex="-1" pgs-option="tabIcon[fa-user]">
61
+ <section pgs="tab flexColumn" tabindex="-1" pgs-option="tabIcon[fa-user]">
62
62
  <h3>Personal details</h3>
63
63
  <p>First tab content.</p>
64
64
  </section>
65
65
 
66
- <section pgs="tab flexColumnTexts" tabindex="-1" pgs-option="tabIcon[fa-list-check]">
66
+ <section pgs="tab flexColumn" tabindex="-1" pgs-option="tabIcon[fa-list-check]">
67
67
  <h3>Preferences</h3>
68
68
  <p>Second tab content.</p>
69
69
  </section>
70
70
 
71
- <section pgs="tab flexColumnTexts" tabindex="-1" pgs-option="tabIcon[fa-check]">
71
+ <section pgs="tab flexColumn" tabindex="-1" pgs-option="tabIcon[fa-check]">
72
72
  <h3>Confirmation</h3>
73
73
  <p>Third tab content.</p>
74
74
  </section>
@@ -1,4 +1,4 @@
1
- <!-- Automatically generated from templates/html/components/steps.html. Edit templates/html/components/steps.html and run npm run docs:generate again. -->
1
+ <!-- Automatically generated from reference/html/components/steps.html. Edit reference/html/components/steps.html and run npm run docs:generate again. -->
2
2
 
3
3
  # Steps
4
4
 
@@ -1,4 +1,4 @@
1
- <!-- Automatically generated from templates/html/components/summary.html. Edit templates/html/components/summary.html and run npm run docs:generate again. -->
1
+ <!-- Automatically generated from reference/html/components/summary.html. Edit reference/html/components/summary.html and run npm run docs:generate again. -->
2
2
 
3
3
  # Summary
4
4
 
@@ -1,4 +1,4 @@
1
- <!-- Automatically generated from templates/html/components/table.html. Edit templates/html/components/table.html and run npm run docs:generate again. -->
1
+ <!-- Automatically generated from reference/html/components/table.html. Edit reference/html/components/table.html and run npm run docs:generate again. -->
2
2
 
3
3
  # Table
4
4
 
@@ -1,4 +1,4 @@
1
- <!-- Automatically generated from templates/html/components/tooltip.html. Edit templates/html/components/tooltip.html and run npm run docs:generate again. -->
1
+ <!-- Automatically generated from reference/html/components/tooltip.html. Edit reference/html/components/tooltip.html and run npm run docs:generate again. -->
2
2
 
3
3
  # Tooltip
4
4
 
@@ -13,6 +13,7 @@ Tooltip markup, configuration, behavior, and usage example.
13
13
  ## PGS Options
14
14
 
15
15
  - `position`: identifies the position element used by Tooltip.
16
+ - `buttonMini`: applies the smallest button variant to the tooltip trigger.
16
17
 
17
18
  ## PGS States
18
19
 
@@ -30,10 +31,10 @@ Tooltip markup, configuration, behavior, and usage example.
30
31
 
31
32
  ## Related elements
32
33
 
34
+ - `button`: provides the base styling for the tooltip trigger.
33
35
  - `dropdown`: uses the related dropdown component or utility in this example.
34
36
  - `dropdown-button`: uses the related dropdown-button component or utility in this example.
35
37
  - `dropdown-content`: uses the related dropdown-content component or utility in this example.
36
- - `buttonMini`: uses the related buttonMini component or utility in this example.
37
38
 
38
39
  ## Output
39
40
 
@@ -43,7 +44,7 @@ Complete HTML markup and usage example for Tooltip.
43
44
 
44
45
  ```html
45
46
  <span pgs="dropdown tooltip">
46
- <button pgs="dropdown-button buttonMini tooltip-button" title="open-tooltip" type="button">
47
+ <button pgs="dropdown-button button tooltip-button" pgs-option="buttonMini" title="open-tooltip" type="button">
47
48
  <i class="fa-solid fa-info"></i>
48
49
  </button>
49
50
  <div pgs="dropdown-content tooltip-content">
@@ -1,7 +1,7 @@
1
1
  # Conventions
2
2
 
3
3
  - Use `pgs` as the first choice for markup, layouts, components, and behaviors.
4
- - Keep tokens consistent across templates, SCSS, and JavaScript.
4
+ - Keep tokens consistent across references, SCSS, and JavaScript.
5
5
  - Use `pgs-state` for runtime states.
6
6
  - Use `pgs-option` for declarative options.
7
7
  - Prefer custom properties and mixins to hardcoded CSS.
@@ -57,7 +57,7 @@ npm pack
57
57
  Recommended workflow when modifying the library:
58
58
 
59
59
  1. modifica i sorgenti in `assets/`;
60
- 2. aggiorna template o documentazione se cambia il modo d'uso;
60
+ 2. aggiorna i riferimenti o la documentazione se cambia il modo d'uso;
61
61
  3. ricompila con `npm run start`;
62
62
  4. verifica `dist/`;
63
63
  5. crea il pacchetto con `npm pack`;
@@ -136,7 +136,7 @@ Shortcuts available after `import "mypgs"`:
136
136
 
137
137
  ## Component API reference
138
138
 
139
- Le firme, i parametri e la funzione di ogni metodo sono generati dai commenti nei template:
139
+ Le firme, i parametri e la funzione di ogni metodo sono generati dai commenti nei riferimenti HTML:
140
140
 
141
141
  - [Accordion](components/accordion.md#api-javascript)
142
142
  - [Dropdown](components/dropdown.md#api-javascript)
@@ -1,4 +1,4 @@
1
- <!-- Automatically generated from templates/html/layout/body.html. Edit templates/html/layout/body.html and run npm run docs:generate again. -->
1
+ <!-- Automatically generated from reference/html/layout/body.html. Edit reference/html/layout/body.html and run npm run docs:generate again. -->
2
2
 
3
3
  # Body
4
4
 
@@ -1,4 +1,4 @@
1
- <!-- Automatically generated from templates/html/layout/footer.html. Edit templates/html/layout/footer.html and run npm run docs:generate again. -->
1
+ <!-- Automatically generated from reference/html/layout/footer.html. Edit reference/html/layout/footer.html and run npm run docs:generate again. -->
2
2
 
3
3
  # Footer
4
4
 
@@ -15,12 +15,16 @@ Complete footer with theme control, brand area, navigation, informational conten
15
15
  - `footer-legal`: identifies the lower section dedicated to legal information.
16
16
  - `footer-legal-content`: identifies the content of the legal section.
17
17
 
18
+ ## PGS Options
19
+
20
+ - `column-3`: configures the footer flex layout with three columns.
21
+
18
22
  ## Related elements
19
23
 
20
24
  - `button`: presents theme and cookie preference controls as buttons.
21
25
  - `toggleDarkmode`: connects the control to the global light or dark theme handler.
22
26
  - `section`: applies the shared section structure to the upper and legal areas.
23
- - `flex-3`: distributes the upper columns responsively.
27
+ - `flexRow`: distributes the upper columns responsively.
24
28
  - `logo`: inserts the brand into the footer.
25
29
  - `logo-text`: uses the text variant of the logo.
26
30
  - `cookieConsent-actionOpen`: opens the Cookie Consent preference panel.
@@ -38,7 +42,7 @@ Complete footer HTML structure with brand, menu, and legal area.
38
42
  </button>
39
43
 
40
44
  <section pgs="footer-top section">
41
- <div pgs="footer-top-content flex-3">
45
+ <div pgs="footer-top-content flexRow" pgs-option="column-3">
42
46
  <div pgs="footer-brand">
43
47
  <a aria-label="Logo" pgs="logo" href="/">
44
48
  <span pgs="logo-text">MyPGS</span>
@@ -1,4 +1,4 @@
1
- <!-- Automatically generated from templates/html/layout/header.html. Edit templates/html/layout/header.html and run npm run docs:generate again. -->
1
+ <!-- Automatically generated from reference/html/layout/header.html. Edit reference/html/layout/header.html and run npm run docs:generate again. -->
2
2
 
3
3
  # Header
4
4
 
@@ -22,6 +22,7 @@ Responsive header that measures available space, switches between desktop and mo
22
22
  - `menuHeader`: adapts both menus to the header context.
23
23
  - `containerPGS`: uses containerPGS[header] on the modal wrapper to move the dialog into the header.
24
24
  - `right`: presents the mobile navigation dialog content from the right side.
25
+ - `buttonIcon`: presents theme and hamburger controls as icon buttons.
25
26
 
26
27
  ## PGS States
27
28
 
@@ -29,10 +30,10 @@ Responsive header that measures available space, switches between desktop and mo
29
30
 
30
31
  ## Related elements
31
32
 
33
+ - `button`: provides the base styling for header controls.
32
34
  - `logo`: inserts the brand into the initial area.
33
35
  - `logo-text`: uses the text variant of the logo.
34
36
  - `menu`: provides desktop and mobile navigation.
35
- - `buttonIcon`: presents theme and hamburger controls as icon buttons.
36
37
  - `toggleDarkmode`: connects the control to the global theme handler.
37
38
  - `modal`: provides opening and closing behavior for mobile navigation.
38
39
  - `modal-button`: opens the mobile panel.
@@ -69,14 +70,14 @@ Complete header HTML with desktop navigation and a side mobile panel.
69
70
  </div>
70
71
 
71
72
  <div pgs="header-element-alwaysOnLast">
72
- <button pgs="buttonIcon toggleDarkmode" type="button" aria-label="Change theme">
73
+ <button pgs="button toggleDarkmode" pgs-option="buttonIcon" type="button" aria-label="Change theme">
73
74
  <i class="fa-solid fa-moon"></i>
74
75
  </button>
75
76
  </div>
76
77
 
77
78
  <div pgs="header-element-hamburger modal" pgs-option="containerPGS[header] ">
78
79
 
79
- <button pgs="buttonIcon modal-button modal-close header-element-hamburger-button" type="button"></button>
80
+ <button pgs="button modal-button modal-close header-element-hamburger-button" pgs-option="buttonIcon" type="button"></button>
80
81
 
81
82
  <dialog pgs="modal-dialog" pgs-option="right">
82
83
  <div pgs="modal-dialog-content">
@@ -1,4 +1,4 @@
1
- <!-- Automatically generated from templates/html/layout/pageShell.html. Edit templates/html/layout/pageShell.html and run npm run docs:generate again. -->
1
+ <!-- Automatically generated from reference/html/layout/pageShell.html. Edit reference/html/layout/pageShell.html and run npm run docs:generate again. -->
2
2
 
3
3
  # Page Shell
4
4
 
@@ -13,8 +13,8 @@ Responsive page layout that combines main content with zero, one, or two scrolla
13
13
 
14
14
  ## Related elements
15
15
 
16
- - `flexColumnTexts`: organizes text contained in the sidebars.
17
- - `flexColumnElements`: vertically organizes elements in the main sections.
16
+ - `flexColumn`: organizes text contained in the sidebars.
17
+ - `gapElements`: applies element spacing in the main sections.
18
18
 
19
19
  ## Output
20
20
 
@@ -26,14 +26,14 @@ Four page-shell HTML configurations with two, one, or no sidebars.
26
26
  <div pgs="pageShell">
27
27
  <aside pgs="pageShell-aside">
28
28
  <div pgs="pageShell-aside-scroll">
29
- <div pgs="flexColumnTexts">
29
+ <div pgs="flexColumn">
30
30
  <p>Lorem ipsum dolor sit amet consectetur adipisicing elit. Ab modi ut sunt est illum accusantium dolores eum aut cum itaque.</p>
31
31
  </div>
32
32
  </div>
33
33
  </aside>
34
34
 
35
35
  <main pgs="pageShell-content">
36
- <section pgs="flexColumnElements" id="sezione-uno">
36
+ <section pgs="flexColumn gapElements" id="sezione-uno">
37
37
  <strong>Lorem ipsum</strong>
38
38
  <p>Lorem ipsum dolor sit amet consectetur adipisicing elit. Quidem dolore veniam nulla hic voluptatum harum illo voluptatem quos. Id quibusdam nemo, mollitia iusto quisquam tenetur doloremque corrupti natus nisi est sed consectetur deserunt? Fugiat consectetur iure aut id voluptate unde autem eius facilis dolorum? Eveniet, sit, excepturi iusto porro eos temporibus illum non ut sunt ex aut earum neque. Iure harum similique autem commodi ratione enim quisquam soluta rem, eius dolor officiis necessitatibus voluptatibus obcaecati vel sint iusto. Eligendi reiciendis aut error rem? Hic aliquid tenetur porro itaque quaerat excepturi consequatur veniam, et alias molestiae, eius odio quae maiores suscipit iure voluptatibus sed dolor facere ipsa quod libero necessitatibus, placeat natus. Doloribus esse nobis culpa ab ut dolorem id expedita nesciunt necessitatibus ipsam natus accusantium eius eveniet eum, distinctio quos modi perspiciatis earum sequi nostrum consequatur quibusdam? Blanditiis iusto possimus officia odio animi repudiandae? Repellendus autem ut soluta facere accusamus magni aut architecto cumque cupiditate. Nostrum officiis, tenetur consequuntur quaerat alias animi debitis? Quae quas placeat iure alias totam quaerat fugit recusandae sed, earum ipsa nihil molestiae quam odit itaque, odio asperiores, mollitia porro ratione tempora laboriosam. Incidunt aliquam nobis sunt ut molestiae nam animi placeat neque vero ratione? Eaque?</p>
39
39
  </section>
@@ -41,7 +41,7 @@ Four page-shell HTML configurations with two, one, or no sidebars.
41
41
 
42
42
  <aside pgs="pageShell-aside">
43
43
  <div pgs="pageShell-aside-scroll">
44
- <div pgs="flexColumnTexts">
44
+ <div pgs="flexColumn">
45
45
  <p>Lorem ipsum dolor sit amet consectetur adipisicing elit. Ab modi ut sunt est illum accusantium dolores eum aut cum itaque.</p>
46
46
  </div>
47
47
  </div>
@@ -50,14 +50,14 @@ Four page-shell HTML configurations with two, one, or no sidebars.
50
50
  <div pgs="pageShell">
51
51
  <aside pgs="pageShell-aside">
52
52
  <div pgs="pageShell-aside-scroll">
53
- <div pgs="flexColumnTexts">
53
+ <div pgs="flexColumn">
54
54
  <p>Lorem ipsum dolor sit amet consectetur adipisicing elit. Ab modi ut sunt est illum accusantium dolores eum aut cum itaque.</p>
55
55
  </div>
56
56
  </div>
57
57
  </aside>
58
58
 
59
59
  <main pgs="pageShell-content">
60
- <section pgs="flexColumnElements" id="sezione-uno">
60
+ <section pgs="flexColumn gapElements" id="sezione-uno">
61
61
  <strong>Lorem ipsum</strong>
62
62
  <p>Lorem ipsum dolor sit amet consectetur adipisicing elit. Quidem dolore veniam nulla hic voluptatum harum illo voluptatem quos. Id quibusdam nemo, mollitia iusto quisquam tenetur doloremque corrupti natus nisi est sed consectetur deserunt? Fugiat consectetur iure aut id voluptate unde autem eius facilis dolorum? Eveniet, sit, excepturi iusto porro eos temporibus illum non ut sunt ex aut earum neque. Iure harum similique autem commodi ratione enim quisquam soluta rem, eius dolor officiis necessitatibus voluptatibus obcaecati vel sint iusto. Eligendi reiciendis aut error rem? Hic aliquid tenetur porro itaque quaerat excepturi consequatur veniam, et alias molestiae, eius odio quae maiores suscipit iure voluptatibus sed dolor facere ipsa quod libero necessitatibus, placeat natus. Doloribus esse nobis culpa ab ut dolorem id expedita nesciunt necessitatibus ipsam natus accusantium eius eveniet eum, distinctio quos modi perspiciatis earum sequi nostrum consequatur quibusdam? Blanditiis iusto possimus officia odio animi repudiandae? Repellendus autem ut soluta facere accusamus magni aut architecto cumque cupiditate. Nostrum officiis, tenetur consequuntur quaerat alias animi debitis? Quae quas placeat iure alias totam quaerat fugit recusandae sed, earum ipsa nihil molestiae quam odit itaque, odio asperiores, mollitia porro ratione tempora laboriosam. Incidunt aliquam nobis sunt ut molestiae nam animi placeat neque vero ratione? Eaque?</p>
63
63
  </section>
@@ -67,7 +67,7 @@ Four page-shell HTML configurations with two, one, or no sidebars.
67
67
  <div pgs="pageShell">
68
68
 
69
69
  <main pgs="pageShell-content">
70
- <section pgs="flexColumnElements" id="sezione-uno">
70
+ <section pgs="flexColumn gapElements" id="sezione-uno">
71
71
  <strong>Lorem ipsum</strong>
72
72
  <p>Lorem ipsum dolor sit amet consectetur adipisicing elit. Quidem dolore veniam nulla hic voluptatum harum illo voluptatem quos. Id quibusdam nemo, mollitia iusto quisquam tenetur doloremque corrupti natus nisi est sed consectetur deserunt? Fugiat consectetur iure aut id voluptate unde autem eius facilis dolorum? Eveniet, sit, excepturi iusto porro eos temporibus illum non ut sunt ex aut earum neque. Iure harum similique autem commodi ratione enim quisquam soluta rem, eius dolor officiis necessitatibus voluptatibus obcaecati vel sint iusto. Eligendi reiciendis aut error rem? Hic aliquid tenetur porro itaque quaerat excepturi consequatur veniam, et alias molestiae, eius odio quae maiores suscipit iure voluptatibus sed dolor facere ipsa quod libero necessitatibus, placeat natus. Doloribus esse nobis culpa ab ut dolorem id expedita nesciunt necessitatibus ipsam natus accusantium eius eveniet eum, distinctio quos modi perspiciatis earum sequi nostrum consequatur quibusdam? Blanditiis iusto possimus officia odio animi repudiandae? Repellendus autem ut soluta facere accusamus magni aut architecto cumque cupiditate. Nostrum officiis, tenetur consequuntur quaerat alias animi debitis? Quae quas placeat iure alias totam quaerat fugit recusandae sed, earum ipsa nihil molestiae quam odit itaque, odio asperiores, mollitia porro ratione tempora laboriosam. Incidunt aliquam nobis sunt ut molestiae nam animi placeat neque vero ratione? Eaque?</p>
73
73
  </section>
@@ -75,7 +75,7 @@ Four page-shell HTML configurations with two, one, or no sidebars.
75
75
 
76
76
  <aside pgs="pageShell-aside">
77
77
  <div pgs="pageShell-aside-scroll">
78
- <div pgs="flexColumnTexts">
78
+ <div pgs="flexColumn">
79
79
  <p>Lorem ipsum dolor sit amet consectetur adipisicing elit. Ab modi ut sunt est illum accusantium dolores eum aut cum itaque.</p>
80
80
  </div>
81
81
  </div>
@@ -85,7 +85,7 @@ Four page-shell HTML configurations with two, one, or no sidebars.
85
85
  <div pgs="pageShell">
86
86
 
87
87
  <main pgs="pageShell-content">
88
- <section pgs="flexColumnElements" id="sezione-uno">
88
+ <section pgs="flexColumn gapElements" id="sezione-uno">
89
89
  <strong>Lorem ipsum</strong>
90
90
  <p>Lorem ipsum dolor sit amet consectetur adipisicing elit. Quidem dolore veniam nulla hic voluptatum harum illo voluptatem quos. Id quibusdam nemo, mollitia iusto quisquam tenetur doloremque corrupti natus nisi est sed consectetur deserunt? Fugiat consectetur iure aut id voluptate unde autem eius facilis dolorum? Eveniet, sit, excepturi iusto porro eos temporibus illum non ut sunt ex aut earum neque. Iure harum similique autem commodi ratione enim quisquam soluta rem, eius dolor officiis necessitatibus voluptatibus obcaecati vel sint iusto. Eligendi reiciendis aut error rem? Hic aliquid tenetur porro itaque quaerat excepturi consequatur veniam, et alias molestiae, eius odio quae maiores suscipit iure voluptatibus sed dolor facere ipsa quod libero necessitatibus, placeat natus. Doloribus esse nobis culpa ab ut dolorem id expedita nesciunt necessitatibus ipsam natus accusantium eius eveniet eum, distinctio quos modi perspiciatis earum sequi nostrum consequatur quibusdam? Blanditiis iusto possimus officia odio animi repudiandae? Repellendus autem ut soluta facere accusamus magni aut architecto cumque cupiditate. Nostrum officiis, tenetur consequuntur quaerat alias animi debitis? Quae quas placeat iure alias totam quaerat fugit recusandae sed, earum ipsa nihil molestiae quam odit itaque, odio asperiores, mollitia porro ratione tempora laboriosam. Incidunt aliquam nobis sunt ut molestiae nam animi placeat neque vero ratione? Eaque?</p>
91
91
  </section>