@nappr/nappr-styles 0.3.1 → 0.3.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.
Files changed (124) hide show
  1. package/README.md +33 -20
  2. package/dist/styles.css +7462 -1
  3. package/dist/styles.css.map +1 -1
  4. package/dist/styles.min.css +3 -0
  5. package/dist/styles.min.css.map +1 -0
  6. package/docs/_coverpage.md +2 -2
  7. package/docs/_sidebar.md +2 -2
  8. package/docs/docs.theme.css +2 -1
  9. package/docs/docs.theme.css.map +1 -1
  10. package/docs/index.html +1 -1
  11. package/docs/pages/displays.md +26 -8
  12. package/docs/pages/grid.md +365 -0
  13. package/docs/pages/helpers.md +30 -18
  14. package/docs/pages/quick-start.md +100 -14
  15. package/docs/temp.scss +122 -0
  16. package/index.d.ts +25 -0
  17. package/package.json +48 -14
  18. package/sass/_globals.module.scss +43 -0
  19. package/sass/_globals.scss +78 -0
  20. package/sass/components/_.scss +1 -0
  21. package/sass/components/_badge.scss +58 -0
  22. package/sass/components/_button.scss +212 -0
  23. package/sass/components/scrollbar/_.scss +102 -0
  24. package/sass/configs/_.scss +7 -0
  25. package/sass/configs/_breakpoints.scss +12 -0
  26. package/sass/configs/_defaults.scss +6 -0
  27. package/sass/configs/_grid.scss +8 -0
  28. package/sass/configs/_palettes.scss +72 -0
  29. package/sass/configs/_spacing.scss +36 -0
  30. package/sass/configs/_text.scss +41 -0
  31. package/sass/configs/_themes.scss +24 -0
  32. package/sass/core/funcs/_list.scss +43 -0
  33. package/sass/core/funcs/_map.scss +42 -0
  34. package/sass/core/funcs/_math.scss +35 -0
  35. package/sass/core/funcs/_string.scss +47 -0
  36. package/sass/core/mixins/_.scss +3 -0
  37. package/{lib → sass/core}/mixins/_links.scss +2 -2
  38. package/sass/core/mixins/_media-queries.scss +22 -0
  39. package/sass/core/mixins/_typography.scss +26 -0
  40. package/sass/core/placeholders/_.scss +4 -0
  41. package/sass/core/placeholders/_dimensions.scss +16 -0
  42. package/sass/core/placeholders/_flexbox.scss +11 -0
  43. package/sass/core/placeholders/_lists.scss +41 -0
  44. package/sass/core/placeholders/_positions.scss +19 -0
  45. package/sass/core/placeholders/_typography.scss +10 -0
  46. package/sass/elements/_.scss +6 -0
  47. package/sass/elements/_dialog.scss +13 -0
  48. package/{lib/htmls → sass/elements}/_form.scss +28 -6
  49. package/sass/elements/_links.scss +21 -0
  50. package/sass/elements/_lists.scss +11 -0
  51. package/{lib/htmls → sass/elements}/_table.scss +2 -6
  52. package/sass/elements/_typography.scss +13 -0
  53. package/sass/layout/grid/_.scss +4 -0
  54. package/sass/layout/grid/_columns.scss +32 -0
  55. package/sass/layout/grid/_gaps.scss +42 -0
  56. package/sass/layout/grid/_grid.scss +130 -0
  57. package/sass/layout/grid/_offsets.scss +35 -0
  58. package/sass/main.scss +59 -0
  59. package/sass/resets/_.scss +5 -0
  60. package/sass/resets/_base.scss +69 -0
  61. package/sass/resets/_nappr.scss +82 -0
  62. package/sass/themes/_dark.scss +17 -0
  63. package/sass/themes/_dracula.scss +17 -0
  64. package/sass/themes/_github-light.scss +17 -0
  65. package/sass/themes/_light.scss +17 -0
  66. package/sass/themes/_monokai-pro.scss +17 -0
  67. package/sass/themes/_night-owl.scss +17 -0
  68. package/sass/themes/_nord.scss +17 -0
  69. package/sass/themes/_tokyo-night.scss +17 -0
  70. package/sass/utilities/_.scss +21 -0
  71. package/sass/utilities/_dimensions.scss +11 -0
  72. package/sass/utilities/_displays.scss +111 -0
  73. package/sass/utilities/_flexbox.scss +81 -0
  74. package/{lib/helpers → sass/utilities}/_floats.scss +10 -13
  75. package/sass/utilities/_lists.scss +86 -0
  76. package/sass/utilities/_negates.scss +121 -0
  77. package/sass/utilities/_palette.scss +11 -0
  78. package/sass/utilities/_scrolls.scss +67 -0
  79. package/sass/utilities/_spacers.scss +120 -0
  80. package/sass/utilities/_square-grid.scss +33 -0
  81. package/sass/utilities/_typography.scss +106 -0
  82. package/sass/utilities/_visibility.scss +60 -0
  83. package/sass/utilities/_wrap.scss +12 -0
  84. package/styles.scss +5 -1
  85. package/lib/_globals.scss +0 -16
  86. package/lib/_reset.scss +0 -223
  87. package/lib/customs/scrollbar.scss +0 -40
  88. package/lib/funcs/_.scss +0 -5
  89. package/lib/funcs/_get-color.scss +0 -3
  90. package/lib/funcs/_math.scss +0 -5
  91. package/lib/funcs/_merge-palette.scss +0 -12
  92. package/lib/funcs/_rem.scss +0 -104
  93. package/lib/funcs/_strings.scss +0 -35
  94. package/lib/grid/_.scss +0 -4
  95. package/lib/grid/_col.scss +0 -117
  96. package/lib/grid/_row.scss +0 -117
  97. package/lib/grid/_square.scss +0 -34
  98. package/lib/grid/_wrap.scss +0 -39
  99. package/lib/helpers/_.scss +0 -9
  100. package/lib/helpers/_displays.scss +0 -151
  101. package/lib/helpers/_flexbox.scss +0 -105
  102. package/lib/helpers/_margins.scss +0 -13
  103. package/lib/helpers/_negates.scss +0 -171
  104. package/lib/helpers/_scrolls.scss +0 -55
  105. package/lib/helpers/_texts.scss +0 -101
  106. package/lib/helpers/_visibility.scss +0 -34
  107. package/lib/htmls/_.scss +0 -4
  108. package/lib/htmls/_headings.scss +0 -29
  109. package/lib/htmls/_links.scss +0 -11
  110. package/lib/mixins/_.scss +0 -9
  111. package/lib/mixins/_border-radius.scss +0 -61
  112. package/lib/mixins/_border.scss +0 -48
  113. package/lib/mixins/_dimensions.scss +0 -48
  114. package/lib/mixins/_font-size.scss +0 -22
  115. package/lib/mixins/_line-height.scss +0 -19
  116. package/lib/mixins/_margin-padding.scss +0 -66
  117. package/lib/mixins/_root-variables.scss +0 -11
  118. package/lib/mixins/_theme.scss +0 -25
  119. package/lib/styles.scss +0 -19
  120. package/lib/variables/_.scss +0 -4
  121. package/lib/variables/_breakpoints.scss +0 -5
  122. package/lib/variables/_colors.scss +0 -60
  123. package/lib/variables/_defaults.scss +0 -53
  124. /package/{lib/helpers → sass/utilities}/_pointers.scss +0 -0
package/docs/_sidebar.md CHANGED
@@ -3,9 +3,9 @@
3
3
  - [**Getting started**](pages/quick-start.md)
4
4
 
5
5
  - Styles
6
-
7
6
  - [Helpers](pages/helpers.md)
8
7
  - [Typography](pages/typography.md)
8
+ - [Grid](pages/grid.md)
9
9
  - [Responsive Grid](pages/responsive.md)
10
10
  - [Scrollbox](pages/scrollbox.md)
11
11
  - [Display](pages/displays.md)
@@ -15,4 +15,4 @@
15
15
 
16
16
  - Mixins
17
17
 
18
- - [Github](https://github.com/sixertoy/napper-styles)
18
+ - [Github](https://github.com/sixertoy/nappr-styles)
@@ -1 +1,2 @@
1
- .docs-palette{align-items:center;border:1px solid #ccc;display:flex;flex:1;height:70px;justify-content:center;text-align:center}/*# sourceMappingURL=docs.theme.css.map */
1
+ .docs-palette{align-items:center;border:1px solid #ccc;display:flex;flex:1;height:70px;justify-content:center;text-align:center}
2
+ /*# sourceMappingURL=docs.theme.css.map */
@@ -1 +1 @@
1
- {"version":3,"sourceRoot":"","sources":["../docs.theme.scss"],"names":[],"mappings":"AAQA,cACE,mBACA,sBACA,aACA,OACA,YACA,uBACA","file":"docs.theme.css"}
1
+ {"version":3,"sources":["../docs.theme.scss"],"names":[],"mappings":"AAOA,cACE,kBAAA,CACA,qBAAA,CACA,YAAA,CACA,MAAA,CACA,WAAA,CACA,sBAAA,CACA,iBAAA","file":"docs.theme.css"}
package/docs/index.html CHANGED
@@ -24,7 +24,7 @@
24
24
  onlyCover: true,
25
25
  loadSidebar: true,
26
26
  routerMode: 'hash',
27
- name: '@iziges/nappr-styles',
27
+ name: '@nappr/nappr-styles',
28
28
  repo: 'https://github.com/sixertoy/nappr-styles',
29
29
  };
30
30
  </script>
@@ -76,17 +76,35 @@
76
76
  </div>
77
77
  </pre>
78
78
 
79
- #### .is-top-to-bottom {
79
+ #### .is-inset-0
80
80
 
81
- top: 0;
82
- bottom: 0;
83
- }
81
+ > Place l'élément avec `inset: 0` (couvre tous les bords)
84
82
 
85
- #### .is-left-to-right {
83
+ <pre class="docsify-example">
84
+ <div class="is-relative" style="min-height:144px;border:1px solid #CCC;min-width:100%;width:100%;height:140px;">
85
+ <div class="is-absolute is-inset-0" style="background-color:rgba(0,0,0,0.2);" />
86
+ </div>
87
+ </pre>
88
+
89
+ #### .is-stretch-y
86
90
 
87
- left: 0;
88
- right: 0;
89
- }
91
+ > Étire l'élément verticalement de haut en bas (`top: 0; bottom: 0`)
92
+
93
+ <pre class="docsify-example">
94
+ <div class="is-relative" style="min-height:144px;border:1px solid #CCC;min-width:100%;width:100%;height:140px;">
95
+ <div class="is-absolute is-stretch-y" style="left:10px;right:10px;background-color:rgba(0,0,0,0.2);" />
96
+ </div>
97
+ </pre>
98
+
99
+ #### .is-stretch-x
100
+
101
+ > Étire l'élément horizontalement de gauche à droite (`left: 0; right: 0`)
102
+
103
+ <pre class="docsify-example">
104
+ <div class="is-relative" style="min-height:144px;border:1px solid #CCC;min-width:100%;width:100%;height:140px;">
105
+ <div class="is-absolute is-stretch-x" style="top:10px;bottom:10px;background-color:rgba(0,0,0,0.2);" />
106
+ </div>
107
+ </pre>
90
108
 
91
109
  ## Dimensions
92
110
 
@@ -0,0 +1,365 @@
1
+ # Grille CSS Grid
2
+
3
+ > Système de grille responsive basé sur CSS Grid avec 12 colonnes et des gouttières personnalisables
4
+
5
+ ## Introduction
6
+
7
+ Le système de grille utilise CSS Grid pour créer des layouts flexibles et responsive. La grille est composée de 12 colonnes avec des gouttières (gaps) configurables.
8
+
9
+ ## Container de base
10
+
11
+ Utilisez la classe `.grid` pour créer un container de grille :
12
+
13
+ ```html
14
+ <div class="grid">
15
+ <!-- Vos colonnes ici -->
16
+ </div>
17
+ ```
18
+
19
+ ## Colonnes
20
+
21
+ ### Colonnes de base
22
+
23
+ Les colonnes sont définies de 1 à 12. Utilisez `.grid-col-{nombre}` pour définir la largeur d'une colonne :
24
+
25
+ ```html
26
+ <div class="grid">
27
+ <div class="grid-col-12">12 colonnes (100%)</div>
28
+ <div class="grid-col-6">6 colonnes (50%)</div>
29
+ <div class="grid-col-4">4 colonnes (33.33%)</div>
30
+ <div class="grid-col-3">4 colonnes (25%)</div>
31
+ </div>
32
+ ```
33
+
34
+ ### Colonnes responsive
35
+
36
+ Le système est mobile-first. Utilisez les préfixes de breakpoint pour définir des colonnes différentes selon la taille d'écran :
37
+
38
+ - `.grid-col-sm-*` : ≥ 576px (Mobile)
39
+ - `.grid-col-md-*` : ≥ 768px (Tablet)
40
+ - `.grid-col-lg-*` : ≥ 1024px (Desktop)
41
+ - `.grid-col-xl-*` : ≥ 1248px (Desktop Large)
42
+
43
+ ```html
44
+ <div class="grid">
45
+ <!-- Mobile: 1 colonne, Tablet: 2 colonnes, Desktop: 3 colonnes -->
46
+ <div class="grid-col-12 grid-col-md-6 grid-col-lg-4">
47
+ Colonne responsive
48
+ </div>
49
+ <div class="grid-col-12 grid-col-md-6 grid-col-lg-4">
50
+ Colonne responsive
51
+ </div>
52
+ <div class="grid-col-12 grid-col-md-12 grid-col-lg-4">
53
+ Colonne responsive
54
+ </div>
55
+ </div>
56
+ ```
57
+
58
+ ## Décalage (Offset)
59
+
60
+ ### Offset vers la droite
61
+
62
+ Utilisez `.grid-col-offset-{nombre}` pour décaler une colonne vers la droite :
63
+
64
+ ```html
65
+ <div class="grid">
66
+ <!-- Colonne de 4 colonnes décalée de 2 colonnes vers la droite -->
67
+ <div class="grid-col-4 grid-col-offset-2">
68
+ Colonne décalée
69
+ </div>
70
+ </div>
71
+ ```
72
+
73
+ ### Offset vers la gauche
74
+
75
+ Utilisez `.grid-col-offset-{nombre}--right` pour définir où se termine une colonne :
76
+
77
+ ```html
78
+ <div class="grid">
79
+ <!-- Colonne qui se termine à la position 9 -->
80
+ <div class="grid-col-4 grid-col-offset-8--right">
81
+ Colonne avec offset right
82
+ </div>
83
+ </div>
84
+ ```
85
+
86
+ ### Exemple : Centrer une colonne
87
+
88
+ ```html
89
+ <div class="grid">
90
+ <!-- Colonne de 4 colonnes centrée (offset de 4) -->
91
+ <div class="grid-col-4 grid-col-offset-4">
92
+ Colonne centrée
93
+ </div>
94
+ </div>
95
+ ```
96
+
97
+ ## Gouttières (Gaps)
98
+
99
+ ### Gouttières de base
100
+
101
+ Définissez l'espacement entre les colonnes avec les classes de gouttières :
102
+
103
+ - `.grid-gap-none` : Pas de gouttière (0px)
104
+ - `.grid-gap-small` : Petite gouttière (6px)
105
+ - `.grid-gap-medium` : Gouttière moyenne (12px) - **défaut**
106
+ - `.grid-gap-large` : Grande gouttière (24px)
107
+ - `.grid-gap-xlarge` : Très grande gouttière (48px)
108
+
109
+ ```html
110
+ <div class="grid grid-gap-large">
111
+ <div class="grid-col-6">Colonne 1</div>
112
+ <div class="grid-col-6">Colonne 2</div>
113
+ </div>
114
+ ```
115
+
116
+ ### Gouttières responsive
117
+
118
+ Les gouttières peuvent être différentes selon les breakpoints :
119
+
120
+ ```html
121
+ <div class="grid grid-gap-small grid-gap-md-medium grid-gap-lg-large">
122
+ <div class="grid-col-12 grid-col-md-6">Colonne 1</div>
123
+ <div class="grid-col-12 grid-col-md-6">Colonne 2</div>
124
+ </div>
125
+ ```
126
+
127
+ ## Nombre de colonnes du container
128
+
129
+ Par défaut, le container utilise 12 colonnes. Vous pouvez changer le nombre de colonnes avec `.grid-cols-{nombre}` :
130
+
131
+ ```html
132
+ <!-- Grille avec 6 colonnes -->
133
+ <div class="grid grid-cols-6">
134
+ <div class="grid-col-2">2/6</div>
135
+ <div class="grid-col-2">2/6</div>
136
+ <div class="grid-col-2">2/6</div>
137
+ </div>
138
+ ```
139
+
140
+ ### Responsive
141
+
142
+ ```html
143
+ <div class="grid grid-cols-1 grid-cols-md-2 grid-cols-lg-3 grid-cols-xl-4">
144
+ <div>Item 1</div>
145
+ <div>Item 2</div>
146
+ <div>Item 3</div>
147
+ <div>Item 4</div>
148
+ </div>
149
+ ```
150
+
151
+ ## Alignement des items
152
+
153
+ ### Alignement vertical (align-items)
154
+
155
+ - `.grid-items-top` : Aligne les items en haut
156
+ - `.grid-items-middle` : Centre les items verticalement
157
+ - `.grid-items-bottom` : Aligne les items en bas
158
+ - `.grid-items-stretch` : Étire les items pour remplir (défaut)
159
+
160
+ ```html
161
+ <div class="grid grid-items-middle">
162
+ <div class="grid-col-4">Item centré verticalement</div>
163
+ <div class="grid-col-4">Item centré verticalement</div>
164
+ </div>
165
+ ```
166
+
167
+ ### Justification horizontale (justify-items)
168
+
169
+ - `.grid-justify-start` : Aligne les items à gauche
170
+ - `.grid-justify-center` : Centre les items horizontalement
171
+ - `.grid-justify-end` : Aligne les items à droite
172
+ - `.grid-justify-stretch` : Étire les items pour remplir (défaut)
173
+
174
+ ```html
175
+ <div class="grid grid-justify-center">
176
+ <div class="grid-col-4">Item centré horizontalement</div>
177
+ </div>
178
+ ```
179
+
180
+ ### Alignement et justification combinés (place-items)
181
+
182
+ - `.grid-place-start` : Haut/Gauche
183
+ - `.grid-place-center` : Centre
184
+ - `.grid-place-end` : Bas/Droite
185
+ - `.grid-place-stretch` : Étire
186
+
187
+ ```html
188
+ <div class="grid grid-place-center">
189
+ <div class="grid-col-4">Item centré</div>
190
+ </div>
191
+ ```
192
+
193
+ ## Alignement du contenu
194
+
195
+ ### Alignement vertical du contenu (align-content)
196
+
197
+ - `.grid-content-top` : Aligne le contenu en haut
198
+ - `.grid-content-middle` : Centre le contenu verticalement
199
+ - `.grid-content-bottom` : Aligne le contenu en bas
200
+ - `.grid-content-between` : Espace entre les éléments
201
+ - `.grid-content-around` : Espace autour des éléments
202
+ - `.grid-content-evenly` : Espace égal autour des éléments
203
+ - `.grid-content-stretch` : Étire le contenu
204
+
205
+ ```html
206
+ <div class="grid grid-content-middle" style="height: 400px;">
207
+ <div class="grid-col-4">Contenu centré</div>
208
+ </div>
209
+ ```
210
+
211
+ ### Justification horizontale du contenu (justify-content)
212
+
213
+ - `.grid-justify-content-start` : Aligne le contenu à gauche
214
+ - `.grid-justify-content-center` : Centre le contenu horizontalement
215
+ - `.grid-justify-content-end` : Aligne le contenu à droite
216
+ - `.grid-justify-content-between` : Espace entre les éléments
217
+ - `.grid-justify-content-around` : Espace autour des éléments
218
+ - `.grid-justify-content-evenly` : Espace égal autour des éléments
219
+ - `.grid-justify-content-stretch` : Étire le contenu
220
+
221
+ ```html
222
+ <div class="grid grid-justify-content-center">
223
+ <div class="grid-col-4">Contenu centré</div>
224
+ </div>
225
+ ```
226
+
227
+ ## Alignement des items individuels
228
+
229
+ ### Alignement vertical d'un item (align-self)
230
+
231
+ - `.grid-self-top` : Aligne cet item en haut
232
+ - `.grid-self-middle` : Centre cet item verticalement
233
+ - `.grid-self-bottom` : Aligne cet item en bas
234
+ - `.grid-self-stretch` : Étire cet item
235
+
236
+ ```html
237
+ <div class="grid">
238
+ <div class="grid-col-4 grid-self-bottom">
239
+ Cet item est aligné en bas
240
+ </div>
241
+ <div class="grid-col-4 grid-self-middle">
242
+ Cet item est centré
243
+ </div>
244
+ </div>
245
+ ```
246
+
247
+ ### Justification horizontale d'un item (justify-self)
248
+
249
+ - `.grid-self-justify-start` : Aligne cet item à gauche
250
+ - `.grid-self-justify-center` : Centre cet item horizontalement
251
+ - `.grid-self-justify-end` : Aligne cet item à droite
252
+ - `.grid-self-justify-stretch` : Étire cet item
253
+
254
+ ```html
255
+ <div class="grid">
256
+ <div class="grid-col-4 grid-self-justify-end">
257
+ Cet item est aligné à droite
258
+ </div>
259
+ </div>
260
+ ```
261
+
262
+ ### Alignement et justification combinés (place-self)
263
+
264
+ - `.grid-self-place-start` : Haut/Gauche
265
+ - `.grid-self-place-center` : Centre
266
+ - `.grid-self-place-end` : Bas/Droite
267
+ - `.grid-self-place-stretch` : Étire
268
+
269
+ ```html
270
+ <div class="grid">
271
+ <div class="grid-col-4 grid-self-place-center">
272
+ Item centré individuellement
273
+ </div>
274
+ </div>
275
+ ```
276
+
277
+ ## Exemples complets
278
+
279
+ ### Layout classique 3 colonnes
280
+
281
+ ```html
282
+ <div class="grid grid-gap-medium">
283
+ <div class="grid-col-12 grid-col-md-4">
284
+ <h2>Colonne 1</h2>
285
+ <p>Contenu de la première colonne</p>
286
+ </div>
287
+ <div class="grid-col-12 grid-col-md-4">
288
+ <h2>Colonne 2</h2>
289
+ <p>Contenu de la deuxième colonne</p>
290
+ </div>
291
+ <div class="grid-col-12 grid-col-md-4">
292
+ <h2>Colonne 3</h2>
293
+ <p>Contenu de la troisième colonne</p>
294
+ </div>
295
+ </div>
296
+ ```
297
+
298
+ ### Layout avec sidebar
299
+
300
+ ```html
301
+ <div class="grid grid-gap-large">
302
+ <!-- Sidebar -->
303
+ <aside class="grid-col-12 grid-col-md-3">
304
+ <nav>Menu de navigation</nav>
305
+ </aside>
306
+
307
+ <!-- Contenu principal -->
308
+ <main class="grid-col-12 grid-col-md-9">
309
+ <article>
310
+ <h1>Titre de l'article</h1>
311
+ <p>Contenu principal...</p>
312
+ </article>
313
+ </main>
314
+ </div>
315
+ ```
316
+
317
+ ### Grille de cartes responsive
318
+
319
+ ```html
320
+ <div class="grid grid-cols-1 grid-cols-sm-2 grid-cols-md-3 grid-cols-lg-4 grid-gap-medium">
321
+ <div class="card">Carte 1</div>
322
+ <div class="card">Carte 2</div>
323
+ <div class="card">Carte 3</div>
324
+ <div class="card">Carte 4</div>
325
+ <div class="card">Carte 5</div>
326
+ <div class="card">Carte 6</div>
327
+ </div>
328
+ ```
329
+
330
+ ### Centrer un contenu
331
+
332
+ ```html
333
+ <div class="grid grid-items-middle grid-justify-center" style="min-height: 100vh;">
334
+ <div class="grid-col-12 grid-col-md-8 grid-col-lg-6">
335
+ <h1>Contenu centré</h1>
336
+ <p>Ce contenu est centré verticalement et horizontalement</p>
337
+ </div>
338
+ </div>
339
+ ```
340
+
341
+ ## Breakpoints
342
+
343
+ Les breakpoints utilisés sont :
344
+
345
+ - **xs** : 320px (Mobile Small)
346
+ - **sm** : 576px (Mobile)
347
+ - **md** : 768px (Tablet)
348
+ - **lg** : 1024px (Desktop)
349
+ - **xl** : 1248px (Desktop Extra Large)
350
+
351
+ ## Variables personnalisables
352
+
353
+ Vous pouvez personnaliser la grille en surchargeant les variables dans votre fichier `variables.scss` :
354
+
355
+ ```scss
356
+ // Nombre de colonnes (défaut: 12)
357
+ $NAPPR_GRID_COLUMNS: 12 !default;
358
+
359
+ // Gouttières
360
+ $NAPPR_GRID_GAP_DEFAULT: 12px !default;
361
+ $NAPPR_GRID_GAP_SMALL: 6px !default;
362
+ $NAPPR_GRID_GAP_MEDIUM: 12px !default;
363
+ $NAPPR_GRID_GAP_LARGE: 24px !default;
364
+ $NAPPR_GRID_GAP_XLARGE: 48px !default;
365
+ ```
@@ -1,12 +1,12 @@
1
1
  ## Font Size
2
2
 
3
- > Les tailles des fonts sont à définir par la variable sass `$FontSizes`
3
+ > Les tailles des fonts sont à définir par la variable sass `$NAPPR_FONT_SIZES_MAP`
4
4
 
5
- ```css
6
- $FontSizes: (6, 8, 9, 12, 26, 24);
5
+ ```scss
6
+ $NAPPR_FONT_SIZES_MAP: (6, 8, 9, 12, 24, 26) !default;
7
7
  ```
8
8
 
9
- **Example en utilisant classe `.fs24`**
9
+ **Exemple en utilisant la classe `.fs24`**
10
10
 
11
11
  ```html
12
12
  <span class="fs24">Font size: 24px</span>
@@ -14,10 +14,10 @@ $FontSizes: (6, 8, 9, 12, 26, 24);
14
14
 
15
15
  ## Margin / Padding
16
16
 
17
- > Les tailles des margin/padding sont à définir par la variable sass `$MarginPaddingSizes`
17
+ > Les tailles des margin/padding sont à définir par la variable sass `$NAPPR_SPACINGS_MAP`
18
18
 
19
- ```css
20
- $MarginPadding: (6, 8, 9, 12, 26, 24);
19
+ ```scss
20
+ $NAPPR_SPACINGS_MAP: (3, 6, 9, 12, 18, 24, 48) !default;
21
21
  ```
22
22
 
23
23
  > Il est alors possible d'ajouter du margin/padding sur :
@@ -26,7 +26,7 @@ $MarginPadding: (6, 8, 9, 12, 26, 24);
26
26
  > - les 2 axes `.my(n) .mx(n)`
27
27
  > - les 4 directions `.mt(n), .mr(n), .mb(n), .ml(n)`
28
28
 
29
- **L'example ci-dessous ajoute un padding de 24px sur la position top d'un bloc**
29
+ **L'exemple ci-dessous ajoute un padding de 24px sur la position top d'un bloc**
30
30
 
31
31
  ```html
32
32
  <div class="pt24">padding-top: 24px;</div>
@@ -34,12 +34,12 @@ $MarginPadding: (6, 8, 9, 12, 26, 24);
34
34
 
35
35
  ## Borders
36
36
 
37
- > Le type de bordure est à définir par la variable `$BorderStyle`
38
- > Les tailles des bordures sont à définir par la variable sass `$BorderSizes`
37
+ > Le type de bordure est à définir par la variable `$NAPPR_BORDER_STYLE`
38
+ > Les tailles des bordures sont à définir par la variable sass `$NAPPR_BORDER_SIZE_MAP`
39
39
 
40
- ```css
41
- $BorderStyle: solid;
42
- $BorderSizes: (1, 2, 3);
40
+ ```scss
41
+ $NAPPR_BORDER_STYLE: solid !default;
42
+ $NAPPR_BORDER_SIZE_MAP: (1, 2, 3) !default;
43
43
  ```
44
44
 
45
45
  > Il est alors possible d'ajouter des bordures sur :
@@ -48,7 +48,7 @@ $BorderSizes: (1, 2, 3);
48
48
  > - les 2 axes `.bx(n) .by(n)`
49
49
  > - les 4 directions `.bt(n), .br(n), .bb(n), .bl(n)`
50
50
 
51
- **L'example ci-dessous ajoute une bordure de 2px sur les positions top et bottom d'un bloc**
51
+ **L'exemple ci-dessous ajoute une bordure de 2px sur les positions top et bottom d'un bloc**
52
52
 
53
53
  ```html
54
54
  <div class="by2" style="border-color: #CCCCCCCC;">
@@ -58,10 +58,10 @@ $BorderSizes: (1, 2, 3);
58
58
 
59
59
  ## Border Radius
60
60
 
61
- > Les arrondis de bordures sont à définir par la variable sass `$BorderRadiusSizes`.
61
+ > Les arrondis de bordures sont à définir par la variable sass `$NAPPR_BORDER_RADIUS_MAP`.
62
62
 
63
- ```css
64
- $BorderRadiusSizes: (2, 3, 4, 8, 10, 12);
63
+ ```scss
64
+ $NAPPR_BORDER_RADIUS_MAP: (2, 3, 4, 8, 10, 12) !default;
65
65
  ```
66
66
 
67
67
  > Il est alors possible d'ajouter des angles arrondis à un bloc sur :
@@ -69,10 +69,22 @@ $BorderRadiusSizes: (2, 3, 4, 8, 10, 12);
69
69
  > - la totalité d'un bloc `.brad(n)`
70
70
  > - les 4 directions `.bradt(n), .bradr(n), .bradb(n), .bradl(n)`
71
71
 
72
- **L'example ci-dessous ajoute un angle arrondi de 2px sur le haut d'un bloc**
72
+ **L'exemple ci-dessous ajoute un angle arrondi de 2px sur le haut d'un bloc**
73
73
 
74
74
  ```html
75
75
  <div class="bradt2" style="border-color: #CCCCCC;">
76
76
  <span>Lorem ipsum</span>
77
77
  </div>
78
78
  ```
79
+
80
+ ## Deprecated
81
+
82
+ > ⚠️ **Version 1.0.0** : Les variables suivantes ont été renommées.
83
+
84
+ | Ancienne variable | Nouvelle variable |
85
+ |-------------------|-------------------|
86
+ | `$FontSizes` | `$NAPPR_FONT_SIZES_MAP` |
87
+ | `$MarginPaddingSizes` | `$NAPPR_SPACINGS_MAP` |
88
+ | `$BorderStyle` | `$NAPPR_BORDER_STYLE` |
89
+ | `$BorderSizes` | `$NAPPR_BORDER_SIZE_MAP` |
90
+ | `$BorderRadiusSizes` | `$NAPPR_BORDER_RADIUS_MAP` |
@@ -1,26 +1,112 @@
1
- # Napper Styles (SASS/CSS)
1
+ # Quick Start
2
2
 
3
- > A collection of CSS/SCSS helpers
3
+ > Guide de démarrage rapide pour utiliser @nappr/nappr-styles
4
4
 
5
5
  ## Installation
6
6
 
7
7
  ```bash
8
- git clone git@github.com:sixertoy/napper-styles.git
8
+ yarn add https://github.com/sixertoy/nappr-styles.git#latest
9
9
  ```
10
10
 
11
- ## Variables
11
+ ## Configuration
12
12
 
13
- ```sass
14
- $body-width: 100% !default;
15
- $body-font-size: 16px !default;
16
- $default-padding: 12px !default;
13
+ Créez un fichier `variables.scss` pour personnaliser les variables :
17
14
 
18
- $BorderStyle: solid;
19
- $BorderSizes: () !default;
20
- $BorderRadiusSizes: () !default;
15
+ ```scss
16
+ // Configuration principale
17
+ $NAPPR_BODY_FONT_SIZE: 16px !default;
18
+ $NAPPR_BODY_WIDTH: 100vw !default;
19
+ $NAPPR_DEFAULT_SPACING: 12px !default;
21
20
 
22
- $FontSizes: () !default;
21
+ // Tailles de police
22
+ $NAPPR_FONT_SIZES_MAP: (11, 12, 14, 16) !default;
23
23
 
24
- $default-padding: 12px !default;
25
- $MarginPaddingSizes: (3, 6, 9, 12, 18, 24, 48) !default;
24
+ // Espacements
25
+ $NAPPR_SPACINGS_MAP: (3, 6, 9, 12, 18, 24, 48) !default;
26
+
27
+ // Dimensions
28
+ $NAPPR_DIMENSIONS_MAP: (25, 50, 75, 100) !default;
29
+
30
+ // Bordures
31
+ $NAPPR_BORDER_STYLE: solid !default;
32
+ $NAPPR_BORDER_SIZE_MAP: (1, 2, 3) !default;
33
+ $NAPPR_BORDER_RADIUS_MAP: (4, 8, 12) !default;
34
+ ```
35
+
36
+ ## Utilisation
37
+
38
+ Importez les styles dans votre fichier principal :
39
+
40
+ ```scss
41
+ @use './variables.scss' as *;
42
+ @use '@nappr/nappr-styles/styles.scss' as *;
43
+ ```
44
+
45
+ ## Exemple complet
46
+
47
+ ```scss
48
+ // variables.scss
49
+ $NAPPR_BODY_FONT_SIZE: 16px !default;
50
+ $NAPPR_FONT_SIZES_MAP: (12, 14, 16, 24) !default;
51
+ $NAPPR_SPACINGS_MAP: (6, 12, 18, 24) !default;
52
+
53
+ // main.scss
54
+ @use './variables.scss' as *;
55
+ @use '@nappr/nappr-styles/styles.scss' as *;
56
+
57
+ .my-component {
58
+ @extend .fs16;
59
+ @extend .m12;
60
+ @extend .p6;
61
+ }
26
62
  ```
63
+
64
+ ## Deprecated
65
+
66
+ > ⚠️ **Version 1.0.0** : Les éléments suivants ont été supprimés.
67
+
68
+ ### Variables deprecated
69
+
70
+ | Ancienne variable | Nouvelle variable |
71
+ |-------------------|-------------------|
72
+ | `$body-width` | `$NAPPR_BODY_WIDTH` |
73
+ | `$body-font-size` | `$NAPPR_BODY_FONT_SIZE` |
74
+ | `$default-spacing` | `$NAPPR_DEFAULT_SPACING` |
75
+ | `$font-sizes-map` | `$NAPPR_FONT_SIZES_MAP` |
76
+ | `$spacings-map` | `$NAPPR_SPACINGS_MAP` |
77
+ | `$border-style` | `$NAPPR_BORDER_STYLE` |
78
+ | `$border-size-map` | `$NAPPR_BORDER_SIZE_MAP` |
79
+ | `$border-radius-map` | `$NAPPR_BORDER_RADIUS_MAP` |
80
+
81
+ ### Syntaxe deprecated
82
+
83
+ ```scss
84
+ // ❌ Ancienne syntaxe (deprecated)
85
+ @import './_variables.scss';
86
+ @import '~@nappr/nappr-styles/styles.scss';
87
+
88
+ // ✅ Nouvelle syntaxe
89
+ @use './variables.scss' as *;
90
+ @use '@nappr/nappr-styles/styles.scss' as *;
91
+ ```
92
+
93
+ ### Grille deprecated
94
+
95
+ Les anciennes classes `.columns` et `.rows` (basées sur flexbox) ont été supprimées. Utilisez le nouveau système de grille CSS Grid :
96
+
97
+ ```scss
98
+ // ❌ Deprecated
99
+ .columns .col-50 { ... }
100
+
101
+ // ✅ Nouvelle syntaxe
102
+ .nappr-grid .nappr-grid-col-6 { ... }
103
+ ```
104
+
105
+ ## Migration
106
+
107
+ Pour migrer votre code vers la version 1.0.0+ :
108
+
109
+ 1. **Remplacez toutes les variables** : Utilisez les variables en MAJUSCULES préfixées avec `NAPPR_`
110
+ 2. **Remplacez `@import` par `@use`** : Utilisez la syntaxe moderne des modules Sass
111
+ 3. **Configuration rem** : Si vous utilisiez `$rem-baseline`, `$rem-fallback` ou `$rem-px-only`, configurez directement `sass-rem` dans votre projet
112
+ 4. **Migrez vers la nouvelle grille** : Remplacez `.columns`/`.rows` par `.nappr-grid` et `.nappr-grid-col-*`