@auriel/peppertino 0.3.0 → 0.5.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 (68) hide show
  1. package/CHANGELOG.txt +210 -122
  2. package/MIGRATION.md +52 -0
  3. package/README.md +284 -40
  4. package/dist/accordion.js +88 -0
  5. package/dist/accordion.js.map +7 -0
  6. package/dist/alert.js +26 -0
  7. package/dist/alert.js.map +7 -0
  8. package/dist/carousel.js +4 -0
  9. package/dist/carousel.js.map +2 -2
  10. package/dist/header.js +1 -0
  11. package/dist/header.js.map +2 -2
  12. package/dist/main.css +3607 -299
  13. package/dist/main.css.map +1 -1
  14. package/dist/modal.js +2 -0
  15. package/dist/modal.js.map +2 -2
  16. package/dist/peppertino.js +290 -11
  17. package/dist/peppertino.js.map +3 -3
  18. package/dist/select.js +2 -4
  19. package/dist/select.js.map +2 -2
  20. package/dist/switch.js +29 -0
  21. package/dist/switch.js.map +7 -0
  22. package/dist/tabs.js +27 -7
  23. package/dist/tabs.js.map +2 -2
  24. package/dist/theme.js +47 -0
  25. package/dist/theme.js.map +7 -0
  26. package/dist/toast.js +69 -0
  27. package/dist/toast.js.map +7 -0
  28. package/index.html +813 -48
  29. package/package.json +6 -4
  30. package/scripts/hex-to-hsl.mjs +75 -0
  31. package/scripts/lint-bem.mjs +53 -0
  32. package/scripts/lint-colors.mjs +87 -0
  33. package/src/js/accordion.js +103 -0
  34. package/src/js/alert.js +28 -0
  35. package/src/js/carousel.js +5 -0
  36. package/src/js/header.js +1 -0
  37. package/src/js/modal.js +4 -0
  38. package/src/js/peppertino.js +6 -0
  39. package/src/js/select.js +2 -4
  40. package/src/js/switch.js +28 -0
  41. package/src/js/tabs.js +31 -21
  42. package/src/js/theme.js +47 -0
  43. package/src/js/toast.js +79 -0
  44. package/src/scss/accordion.scss +156 -0
  45. package/src/scss/alert.scss +203 -0
  46. package/src/scss/badge.scss +90 -0
  47. package/src/scss/base.scss +331 -36
  48. package/src/scss/button.scss +44 -46
  49. package/src/scss/card.scss +4 -4
  50. package/src/scss/carousel.scss +18 -28
  51. package/src/scss/dark-mode.scss +514 -0
  52. package/src/scss/footer.scss +14 -14
  53. package/src/scss/forms/fieldset.scss +12 -12
  54. package/src/scss/forms/form-instructions.scss +8 -8
  55. package/src/scss/forms/text-field.scss +17 -17
  56. package/src/scss/forms/validation.scss +12 -12
  57. package/src/scss/gradient.scss +2 -2
  58. package/src/scss/header.scss +8 -8
  59. package/src/scss/main.scss +8 -0
  60. package/src/scss/modal.scss +2 -2
  61. package/src/scss/section.scss +1 -1
  62. package/src/scss/select.scss +8 -8
  63. package/src/scss/switch.scss +121 -0
  64. package/src/scss/table.scss +5 -5
  65. package/src/scss/tabs.scss +26 -26
  66. package/src/scss/toast.scss +170 -0
  67. package/src/scss/tooltip.scss +126 -0
  68. package/src/scss/utilities.scss +243 -0
package/index.html CHANGED
@@ -1,4 +1,4 @@
1
- <!DOCTYPE html>
1
+ <!DOCTYPE html>
2
2
  <html lang="en">
3
3
  <head>
4
4
  <meta charset="UTF-8" />
@@ -32,6 +32,9 @@
32
32
  <li class="pp-header__nav-item" role="none">
33
33
  <a href="#components" class="pp-header__nav-link font-sans font-400" role="menuitem" aria-haspopup="true" aria-expanded="false">Components</a>
34
34
  <ul class="pp-header__dropdown" role="menu" aria-label="Components">
35
+ <li role="none"><a href="#accordion" class="pp-header__dropdown-link font-sans font-400" role="menuitem">Accordion</a></li>
36
+ <li role="none"><a href="#alert" class="pp-header__dropdown-link font-sans font-400" role="menuitem">Alert</a></li>
37
+ <li role="none"><a href="#badges" class="pp-header__dropdown-link font-sans font-400" role="menuitem">Badge</a></li>
35
38
  <li role="none"><a href="#buttons" class="pp-header__dropdown-link font-sans font-400" role="menuitem">Buttons</a></li>
36
39
  <li role="none"><a href="#cards" class="pp-header__dropdown-link font-sans font-400" role="menuitem">Cards</a></li>
37
40
  <li role="none"><a href="#carousel" class="pp-header__dropdown-link font-sans font-400" role="menuitem">Carousel</a></li>
@@ -39,8 +42,11 @@
39
42
  <li role="none"><a href="#gradient" class="pp-header__dropdown-link font-sans font-400" role="menuitem">Gradient</a></li>
40
43
  <li role="none"><a href="#modals" class="pp-header__dropdown-link font-sans font-400" role="menuitem">Modals</a></li>
41
44
  <li role="none"><a href="#selects" class="pp-header__dropdown-link font-sans font-400" role="menuitem">Selects</a></li>
45
+ <li role="none"><a href="#switches" class="pp-header__dropdown-link font-sans font-400" role="menuitem">Switch</a></li>
42
46
  <li role="none"><a href="#tabs" class="pp-header__dropdown-link font-sans font-400" role="menuitem">Tabs</a></li>
43
47
  <li role="none"><a href="#tables" class="pp-header__dropdown-link font-sans font-400" role="menuitem">Tables</a></li>
48
+ <li role="none"><a href="#toasts" class="pp-header__dropdown-link font-sans font-400" role="menuitem">Toast</a></li>
49
+ <li role="none"><a href="#tooltips" class="pp-header__dropdown-link font-sans font-400" role="menuitem">Tooltip</a></li>
44
50
  </ul>
45
51
  </li>
46
52
  <li class="pp-header__nav-item" role="none">
@@ -53,24 +59,54 @@
53
59
  <li role="none"><a href="#form-validation" class="pp-header__dropdown-link font-sans font-400" role="menuitem">Validation</a></li>
54
60
  </ul>
55
61
  </li>
62
+ <li class="pp-header__nav-item" role="none">
63
+ <a href="#utilities" class="pp-header__nav-link font-sans font-400" role="menuitem">Utilities</a>
64
+ </li>
56
65
  <li class="pp-header__nav-item" role="none">
57
66
  <a href="#changelog" class="pp-header__nav-link font-sans font-400" role="menuitem">Changelog</a>
58
67
  </li>
59
68
  </ul>
60
69
  </nav>
61
- <button class="pp-header__toggle" aria-expanded="false" aria-label="Toggle navigation">
62
- <span></span><span></span><span></span>
63
- </button>
70
+ <div style="display:flex;align-items:center;gap:0.5rem;flex-shrink:0;">
71
+ <button id="dark-toggle" aria-label="Toggle dark mode" style="display:flex;align-items:center;justify-content:center;width:32px;height:32px;border-radius:6px;border:none;background:none;cursor:pointer;color:inherit;transition:background 150ms ease;" title="Toggle dark mode">
72
+ <svg id="dark-icon-sun" xmlns="http://www.w3.org/2000/svg" width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" style="display:none"><circle cx="12" cy="12" r="4"/><path d="M12 2v2M12 20v2M4.93 4.93l1.41 1.41M17.66 17.66l1.41 1.41M2 12h2M20 12h2M6.34 17.66l-1.41 1.41M19.07 4.93l-1.41 1.41"/></svg>
73
+ <svg id="dark-icon-moon" xmlns="http://www.w3.org/2000/svg" width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M21 12.79A9 9 0 1 1 11.21 3 7 7 0 0 0 21 12.79z"/></svg>
74
+ </button>
75
+ <button class="pp-header__toggle" aria-expanded="false" aria-label="Toggle navigation">
76
+ <span></span><span></span><span></span>
77
+ </button>
78
+ </div>
64
79
  </header>
65
80
 
81
+ <script>
82
+ (function() {
83
+ var btn = document.getElementById('dark-toggle');
84
+ var sun = document.getElementById('dark-icon-sun');
85
+ var moon = document.getElementById('dark-icon-moon');
86
+ function apply(dark) {
87
+ document.documentElement.classList.toggle('dark', dark);
88
+ sun.style.display = dark ? 'block' : 'none';
89
+ moon.style.display = dark ? 'none' : 'block';
90
+ btn.style.background = dark ? 'rgba(255,255,255,0.08)' : '';
91
+ }
92
+ var stored = localStorage.getItem('pp-dark');
93
+ apply(stored === 'true');
94
+ btn.addEventListener('click', function() {
95
+ var isDark = document.documentElement.classList.contains('dark');
96
+ apply(!isDark);
97
+ localStorage.setItem('pp-dark', !isDark);
98
+ });
99
+ })();
100
+ </script>
101
+
66
102
  <!-- Hero -->
67
103
  <section id="hero" class="pp-section pp-section--gradient">
68
104
  <div class="pp-section__inner">
69
105
  <h1 class="font-sans font-700 tracking-tight">PeppertinoCSS</h1>
70
106
  <p class="font-sans font-400 text-lg leading-relaxed">A modern, opinionated SCSS framework. Fast to build with, easy to extend.</p>
71
107
  <div class="row">
72
- <button class="button font-sans font-400" style="background:#fff;color:#ea5753;">Get Started</button>
73
- <button class="button-outline font-sans font-400" style="border-color:#fff;color:#fff;">View Source</button>
108
+ <button class="pp-button font-sans font-400" style="background:#fff;color:#ea5753;">Get Started</button>
109
+ <button class="pp-button--outline font-sans font-400" style="border-color:#fff;color:#fff;">View Source</button>
74
110
  </div>
75
111
  </div>
76
112
  </section>
@@ -210,6 +246,346 @@ const greet = (name) =&gt; `Hello, ${name}!`;</code></pre>
210
246
  </div>
211
247
  </section>
212
248
 
249
+ <!-- Accordion -->
250
+ <section id="accordion" class="pp-section">
251
+ <div class="pp-section__inner text-left" style="align-items:flex-start;max-width:720px;">
252
+ <h2 class="font-sans font-700 tracking-tight">Accordion</h2>
253
+ <p class="font-sans font-400 text-sm" style="color:#71717a;">CSS-only open/close via max-height transition. JS adds keyboard navigation (↑↓ Home End), ARIA state, and multi-open control. Progressive — works without JS.</p>
254
+
255
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:1.5rem;">Default (single open)</p>
256
+ <div class="pp-accordion" style="margin-top:0.5rem;">
257
+ <div class="pp-accordion__item">
258
+ <button class="pp-accordion__trigger font-sans" aria-expanded="true" aria-controls="acc-1">
259
+ What is PeppertinoCSS?
260
+ <svg class="pp-accordion__icon" viewBox="0 0 24 24" aria-hidden="true"><polyline points="6 9 12 15 18 9"/></svg>
261
+ </button>
262
+ <div class="pp-accordion__panel is-open" id="acc-1" aria-hidden="false">
263
+ <p class="pp-accordion__content">PeppertinoCSS is an Apple-inspired CSS framework with a spicy red accent. Clean geometry, restrained elegance, and zero Cupertino lawsuits.</p>
264
+ </div>
265
+ </div>
266
+ <div class="pp-accordion__item">
267
+ <button class="pp-accordion__trigger font-sans" aria-expanded="false" aria-controls="acc-2">
268
+ Does it require JavaScript?
269
+ <svg class="pp-accordion__icon" viewBox="0 0 24 24" aria-hidden="true"><polyline points="6 9 12 15 18 9"/></svg>
270
+ </button>
271
+ <div class="pp-accordion__panel" id="acc-2" aria-hidden="true">
272
+ <p class="pp-accordion__content">No. The CSS-only baseline uses max-height transitions driven by class toggling. The JS shim adds ARIA state management and keyboard navigation on top.</p>
273
+ </div>
274
+ </div>
275
+ <div class="pp-accordion__item">
276
+ <button class="pp-accordion__trigger font-sans" aria-expanded="false" aria-controls="acc-3">
277
+ Can I use it with any framework?
278
+ <svg class="pp-accordion__icon" viewBox="0 0 24 24" aria-hidden="true"><polyline points="6 9 12 15 18 9"/></svg>
279
+ </button>
280
+ <div class="pp-accordion__panel" id="acc-3" aria-hidden="true">
281
+ <p class="pp-accordion__content">Yes — it's plain CSS classes. Consume via CDN, npm, or SCSS import. Works with React, Vue, Svelte, vanilla HTML — anything that can apply a class name.</p>
282
+ </div>
283
+ </div>
284
+ </div>
285
+
286
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:2rem;">Multi-open (<code class="font-mono">data-allow-multiple</code>)</p>
287
+ <div class="pp-accordion" data-allow-multiple style="margin-top:0.5rem;">
288
+ <div class="pp-accordion__item">
289
+ <button class="pp-accordion__trigger font-sans" aria-expanded="false" aria-controls="accm-1">
290
+ Spacing system
291
+ <svg class="pp-accordion__icon" viewBox="0 0 24 24" aria-hidden="true"><polyline points="6 9 12 15 18 9"/></svg>
292
+ </button>
293
+ <div class="pp-accordion__panel" id="accm-1" aria-hidden="true">
294
+ <p class="pp-accordion__content">Multiples of 0.25rem from 0 to 8rem, accessible via the <code class="font-mono">spacing($key)</code> helper function in SCSS.</p>
295
+ </div>
296
+ </div>
297
+ <div class="pp-accordion__item">
298
+ <button class="pp-accordion__trigger font-sans" aria-expanded="false" aria-controls="accm-2">
299
+ Color tokens
300
+ <svg class="pp-accordion__icon" viewBox="0 0 24 24" aria-hidden="true"><polyline points="6 9 12 15 18 9"/></svg>
301
+ </button>
302
+ <div class="pp-accordion__panel" id="accm-2" aria-hidden="true">
303
+ <p class="pp-accordion__content">Primary red (#e90111), gradient gold-to-red, ten neutral steps, and semantic success/warning/error/info tokens — all overridable with <code class="font-mono">!default</code>.</p>
304
+ </div>
305
+ </div>
306
+ </div>
307
+
308
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:2rem;">Dark variant</p>
309
+ <div class="pp-accordion pp-accordion--dark" style="margin-top:0.5rem;">
310
+ <div class="pp-accordion__item">
311
+ <button class="pp-accordion__trigger font-sans" aria-expanded="true" aria-controls="accd-1">
312
+ MacBook Pro M4
313
+ <svg class="pp-accordion__icon" viewBox="0 0 24 24" aria-hidden="true"><polyline points="6 9 12 15 18 9"/></svg>
314
+ </button>
315
+ <div class="pp-accordion__panel is-open" id="accd-1" aria-hidden="false">
316
+ <p class="pp-accordion__content">Apple M4 chip, 14-core GPU, up to 64 GB unified memory, Liquid Retina XDR display. Built for the ones who push limits.</p>
317
+ </div>
318
+ </div>
319
+ <div class="pp-accordion__item">
320
+ <button class="pp-accordion__trigger font-sans" aria-expanded="false" aria-controls="accd-2">
321
+ MacBook Air M3
322
+ <svg class="pp-accordion__icon" viewBox="0 0 24 24" aria-hidden="true"><polyline points="6 9 12 15 18 9"/></svg>
323
+ </button>
324
+ <div class="pp-accordion__panel" id="accd-2" aria-hidden="true">
325
+ <p class="pp-accordion__content">Impossibly thin. Apple M3, all-day battery, 13.6" Liquid Retina display. The world's best consumer laptop.</p>
326
+ </div>
327
+ </div>
328
+ </div>
329
+
330
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:2rem;">Flush variant</p>
331
+ <div class="pp-accordion pp-accordion--flush" style="margin-top:0.5rem;">
332
+ <div class="pp-accordion__item">
333
+ <button class="pp-accordion__trigger font-sans" aria-expanded="false" aria-controls="accf-1">
334
+ Is this flush?
335
+ <svg class="pp-accordion__icon" viewBox="0 0 24 24" aria-hidden="true"><polyline points="6 9 12 15 18 9"/></svg>
336
+ </button>
337
+ <div class="pp-accordion__panel" id="accf-1" aria-hidden="true">
338
+ <p class="pp-accordion__content">Yes — no outer border, no border-radius, no box-shadow. Only dividing lines between items. Great inside cards or panels.</p>
339
+ </div>
340
+ </div>
341
+ <div class="pp-accordion__item">
342
+ <button class="pp-accordion__trigger font-sans" aria-expanded="false" aria-controls="accf-2">
343
+ When to use flush?
344
+ <svg class="pp-accordion__icon" viewBox="0 0 24 24" aria-hidden="true"><polyline points="6 9 12 15 18 9"/></svg>
345
+ </button>
346
+ <div class="pp-accordion__panel" id="accf-2" aria-hidden="true">
347
+ <p class="pp-accordion__content">When the accordion is already inside a contained surface — a card, a sidebar, a settings panel — and you don't need another layer of border/radius.</p>
348
+ </div>
349
+ </div>
350
+ </div>
351
+
352
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:2rem;">Dark mode preview</p>
353
+ <div class="dark" style="margin-top:0.5rem;background:#18181b;border-radius:16px;padding:1.5rem;">
354
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-bottom:0.75rem;">.dark on ancestor</p>
355
+ <div class="pp-accordion">
356
+ <div class="pp-accordion__item">
357
+ <button class="pp-accordion__trigger font-sans" aria-expanded="true" aria-controls="acc-dm-1">
358
+ What is PeppertinoCSS?
359
+ <svg class="pp-accordion__icon" viewBox="0 0 24 24" aria-hidden="true"><polyline points="6 9 12 15 18 9"/></svg>
360
+ </button>
361
+ <div class="pp-accordion__panel is-open" id="acc-dm-1" aria-hidden="false">
362
+ <p class="pp-accordion__content">Dark-mode aware — surface, border, and text all respond to the <code class="font-mono">.dark</code> ancestor class.</p>
363
+ </div>
364
+ </div>
365
+ <div class="pp-accordion__item">
366
+ <button class="pp-accordion__trigger font-sans" aria-expanded="false" aria-controls="acc-dm-2">
367
+ Does it require extra markup?
368
+ <svg class="pp-accordion__icon" viewBox="0 0 24 24" aria-hidden="true"><polyline points="6 9 12 15 18 9"/></svg>
369
+ </button>
370
+ <div class="pp-accordion__panel" id="acc-dm-2" aria-hidden="true">
371
+ <p class="pp-accordion__content">No — same classes, no modifier needed. Add <code class="font-mono">.dark</code> to any ancestor and the token overrides cascade down automatically.</p>
372
+ </div>
373
+ </div>
374
+ </div>
375
+ </div>
376
+
377
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:2rem;">Usage</p>
378
+ <table class="pp-table pp-table--cols-2" style="width:100%;">
379
+ <thead><tr><th class="font-sans font-600">Class / attribute</th><th class="font-sans font-600">What it does</th></tr></thead>
380
+ <tbody>
381
+ <tr><td><code class="font-mono">.pp-accordion</code></td><td>Outer wrapper — bordered, rounded-16, white bg</td></tr>
382
+ <tr><td><code class="font-mono">.pp-accordion__item</code></td><td>Individual row — bottom border except last</td></tr>
383
+ <tr><td><code class="font-mono">.pp-accordion__trigger</code></td><td>Full-width button — icon rotates when open</td></tr>
384
+ <tr><td><code class="font-mono">.pp-accordion__panel</code></td><td>Collapsible region — max-height transition</td></tr>
385
+ <tr><td><code class="font-mono">.pp-accordion__content</code></td><td>Inner text wrapper</td></tr>
386
+ <tr><td><code class="font-mono">.pp-accordion__icon</code></td><td>Inline SVG chevron — 180° rotation when open</td></tr>
387
+ <tr><td><code class="font-mono">.pp-accordion--flush</code></td><td>No outer border / radius / shadow</td></tr>
388
+ <tr><td><code class="font-mono">.pp-accordion--dark</code></td><td>Dark neutral surface</td></tr>
389
+ <tr><td><code class="font-mono">.pp-accordion--primary</code></td><td>Open trigger gets primary red background</td></tr>
390
+ <tr><td><code class="font-mono">data-allow-multiple</code></td><td>Allow multiple items open simultaneously</td></tr>
391
+ <tr><td><code class="font-mono">aria-expanded</code></td><td>Drives open/closed state — the JS shim sets this</td></tr>
392
+ <tr><td><code class="font-mono">aria-controls</code></td><td>Links trigger to panel by id</td></tr>
393
+ <tr><td><code class="font-mono">.is-open</code></td><td>CSS class applied to panel when open (drives max-height)</td></tr>
394
+ </tbody>
395
+ </table>
396
+ </div>
397
+ </section>
398
+
399
+ <!-- Alert -->
400
+ <section id="alert" class="pp-section pp-section--muted">
401
+ <div class="pp-section__inner text-left" style="align-items:flex-start;max-width:720px;">
402
+ <h2 class="font-sans font-700 tracking-tight">Alert</h2>
403
+ <p class="font-sans font-400 text-sm" style="color:#71717a;">Inline feedback messages. CSS-only. Add <code class="font-mono">.is-dismissible</code> and wire the close button if you need dismiss behaviour.</p>
404
+
405
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:1.5rem;">Soft (default)</p>
406
+ <div style="display:flex;flex-direction:column;gap:0.75rem;margin-top:0.5rem;">
407
+ <div class="pp-alert pp-alert--info font-sans" role="note">
408
+ <span class="pp-alert__icon"><i data-lucide="info" aria-hidden="true"></i></span>
409
+ <div class="pp-alert__body">
410
+ <p class="pp-alert__title">Info</p>
411
+ <p class="pp-alert__message">Your session will expire in 10 minutes. Save your work to avoid losing progress.</p>
412
+ </div>
413
+ </div>
414
+ <div class="pp-alert pp-alert--success font-sans" role="status">
415
+ <span class="pp-alert__icon"><i data-lucide="circle-check" aria-hidden="true"></i></span>
416
+ <div class="pp-alert__body">
417
+ <p class="pp-alert__title">Success</p>
418
+ <p class="pp-alert__message">Your changes have been saved and published successfully.</p>
419
+ </div>
420
+ </div>
421
+ <div class="pp-alert pp-alert--warning font-sans" role="note">
422
+ <span class="pp-alert__icon"><i data-lucide="triangle-alert" aria-hidden="true"></i></span>
423
+ <div class="pp-alert__body">
424
+ <p class="pp-alert__title">Warning</p>
425
+ <p class="pp-alert__message">This action will affect all linked accounts. Review before proceeding.</p>
426
+ </div>
427
+ </div>
428
+ <div class="pp-alert pp-alert--error font-sans" role="alert">
429
+ <span class="pp-alert__icon"><i data-lucide="circle-x" aria-hidden="true"></i></span>
430
+ <div class="pp-alert__body">
431
+ <p class="pp-alert__title">Error</p>
432
+ <p class="pp-alert__message">Payment failed. Check your card details and try again.</p>
433
+ </div>
434
+ </div>
435
+ <div class="pp-alert pp-alert--primary font-sans" role="note">
436
+ <span class="pp-alert__icon"><i data-lucide="zap" aria-hidden="true"></i></span>
437
+ <div class="pp-alert__body">
438
+ <p class="pp-alert__title">Primary</p>
439
+ <p class="pp-alert__message">PeppertinoCSS v0.3 is now available on npm. Check the changelog for what's new.</p>
440
+ </div>
441
+ </div>
442
+ <div class="pp-alert pp-alert--neutral font-sans" role="note">
443
+ <span class="pp-alert__icon"><i data-lucide="message-square" aria-hidden="true"></i></span>
444
+ <div class="pp-alert__body">
445
+ <p class="pp-alert__title">Neutral</p>
446
+ <p class="pp-alert__message">No issues detected. All systems are operating normally.</p>
447
+ </div>
448
+ </div>
449
+ </div>
450
+
451
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:2rem;">Filled</p>
452
+ <div style="display:flex;flex-direction:column;gap:0.75rem;margin-top:0.5rem;">
453
+ <div class="pp-alert pp-alert--filled pp-alert--info font-sans" role="note">
454
+ <span class="pp-alert__icon"><i data-lucide="info" aria-hidden="true"></i></span>
455
+ <div class="pp-alert__body"><p class="pp-alert__message">Filled info — your session expires in 10 minutes.</p></div>
456
+ </div>
457
+ <div class="pp-alert pp-alert--filled pp-alert--success font-sans" role="status">
458
+ <span class="pp-alert__icon"><i data-lucide="circle-check" aria-hidden="true"></i></span>
459
+ <div class="pp-alert__body"><p class="pp-alert__message">Filled success — changes saved and published.</p></div>
460
+ </div>
461
+ <div class="pp-alert pp-alert--filled pp-alert--warning font-sans" role="note">
462
+ <span class="pp-alert__icon"><i data-lucide="triangle-alert" aria-hidden="true"></i></span>
463
+ <div class="pp-alert__body"><p class="pp-alert__message">Filled warning — this will affect linked accounts.</p></div>
464
+ </div>
465
+ <div class="pp-alert pp-alert--filled pp-alert--error font-sans" role="alert">
466
+ <span class="pp-alert__icon"><i data-lucide="circle-x" aria-hidden="true"></i></span>
467
+ <div class="pp-alert__body"><p class="pp-alert__message">Filled error — payment failed. Check your card details.</p></div>
468
+ </div>
469
+ </div>
470
+
471
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:2rem;">Dismissible</p>
472
+ <div style="display:flex;flex-direction:column;gap:0.75rem;margin-top:0.5rem;">
473
+ <div class="pp-alert pp-alert--info is-dismissible font-sans" role="note" id="alert-dismiss-demo">
474
+ <span class="pp-alert__icon"><i data-lucide="info" aria-hidden="true"></i></span>
475
+ <div class="pp-alert__body">
476
+ <p class="pp-alert__title">Dismissible alert</p>
477
+ <p class="pp-alert__message">Click the × to dismiss this alert. Add <code>.is-dismissing</code> before removing the element for the slide-out animation.</p>
478
+ </div>
479
+ <button class="pp-alert__dismiss font-sans" aria-label="Dismiss alert"
480
+ onclick="const el=document.getElementById('alert-dismiss-demo');el.classList.add('is-dismissing');setTimeout(()=>el.remove(),200);">
481
+ <i data-lucide="x" aria-hidden="true"></i>
482
+ </button>
483
+ </div>
484
+ </div>
485
+
486
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:2rem;">Dark mode preview</p>
487
+ <div class="dark" style="margin-top:0.5rem;background:#18181b;border-radius:16px;padding:1.5rem;display:flex;flex-direction:column;gap:0.75rem;">
488
+ <div class="pp-alert pp-alert--info font-sans" role="note">
489
+ <span class="pp-alert__icon"><i data-lucide="info" aria-hidden="true"></i></span>
490
+ <div class="pp-alert__body"><p class="pp-alert__title">Info</p><p class="pp-alert__message">Your session expires in 10 minutes.</p></div>
491
+ </div>
492
+ <div class="pp-alert pp-alert--success font-sans" role="status">
493
+ <span class="pp-alert__icon"><i data-lucide="circle-check" aria-hidden="true"></i></span>
494
+ <div class="pp-alert__body"><p class="pp-alert__title">Success</p><p class="pp-alert__message">Changes saved and published.</p></div>
495
+ </div>
496
+ <div class="pp-alert pp-alert--warning font-sans" role="note">
497
+ <span class="pp-alert__icon"><i data-lucide="triangle-alert" aria-hidden="true"></i></span>
498
+ <div class="pp-alert__body"><p class="pp-alert__title">Warning</p><p class="pp-alert__message">This will affect linked accounts.</p></div>
499
+ </div>
500
+ <div class="pp-alert pp-alert--error font-sans" role="alert">
501
+ <span class="pp-alert__icon"><i data-lucide="circle-x" aria-hidden="true"></i></span>
502
+ <div class="pp-alert__body"><p class="pp-alert__title">Error</p><p class="pp-alert__message">Payment failed. Check your card details.</p></div>
503
+ </div>
504
+ <div class="pp-alert pp-alert--primary font-sans" role="note">
505
+ <span class="pp-alert__icon"><i data-lucide="zap" aria-hidden="true"></i></span>
506
+ <div class="pp-alert__body"><p class="pp-alert__title">Primary</p><p class="pp-alert__message">PeppertinoCSS v0.3 is now available on npm.</p></div>
507
+ </div>
508
+ </div>
509
+
510
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:2rem;">Usage</p>
511
+ <table class="pp-table pp-table--cols-2" style="width:100%;">
512
+ <thead><tr><th class="font-sans font-600">Class</th><th class="font-sans font-600">What it does</th></tr></thead>
513
+ <tbody>
514
+ <tr><td><code class="font-mono">.pp-alert</code></td><td>Base wrapper — flex row, border, radius-12</td></tr>
515
+ <tr><td><code class="font-mono">.pp-alert--info</code></td><td>Blue tint</td></tr>
516
+ <tr><td><code class="font-mono">.pp-alert--success</code></td><td>Green tint</td></tr>
517
+ <tr><td><code class="font-mono">.pp-alert--warning</code></td><td>Amber tint</td></tr>
518
+ <tr><td><code class="font-mono">.pp-alert--error</code></td><td>Red tint — use <code>role="alert"</code></td></tr>
519
+ <tr><td><code class="font-mono">.pp-alert--primary</code></td><td>Spicy red tint</td></tr>
520
+ <tr><td><code class="font-mono">.pp-alert--neutral</code></td><td>Grey tint</td></tr>
521
+ <tr><td><code class="font-mono">.pp-alert--filled</code></td><td>Solid background instead of tinted</td></tr>
522
+ <tr><td><code class="font-mono">.pp-alert__icon</code></td><td>Leading icon slot — 18px</td></tr>
523
+ <tr><td><code class="font-mono">.pp-alert__title</code></td><td>Semibold label line</td></tr>
524
+ <tr><td><code class="font-mono">.pp-alert__message</code></td><td>Body text (85% opacity)</td></tr>
525
+ <tr><td><code class="font-mono">.is-dismissible</code></td><td>Adds right padding for the close button</td></tr>
526
+ <tr><td><code class="font-mono">.pp-alert__dismiss</code></td><td>Absolute-positioned close × button</td></tr>
527
+ <tr><td><code class="font-mono">.is-dismissing</code></td><td>Slide-out animation before DOM removal</td></tr>
528
+ <tr><td><code class="font-mono">role="alert"</code></td><td>Use on error alerts — announces immediately</td></tr>
529
+ <tr><td><code class="font-mono">role="status"</code></td><td>Use on success — polite announcement</td></tr>
530
+ <tr><td><code class="font-mono">role="note"</code></td><td>Use on info / warning — supplemental context</td></tr>
531
+ </tbody>
532
+ </table>
533
+ </div>
534
+ </section>
535
+
536
+ <!-- Badge -->
537
+ <section id="badges" class="pp-section">
538
+ <div class="pp-section__inner text-left" style="align-items:flex-start;max-width:720px;">
539
+ <h2 class="font-sans font-700 tracking-tight">Badge</h2>
540
+ <p class="font-sans font-400 text-sm" style="color:#71717a;">Pill-shaped status indicators. CSS-only — no JS required.</p>
541
+
542
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:1.5rem;">Tint variants (default)</p>
543
+ <div style="display:flex;flex-wrap:wrap;gap:0.5rem;margin-top:0.5rem;align-items:center;">
544
+ <span class="pp-badge pp-badge--primary font-sans">Primary</span>
545
+ <span class="pp-badge pp-badge--success font-sans">Success</span>
546
+ <span class="pp-badge pp-badge--warning font-sans">Warning</span>
547
+ <span class="pp-badge pp-badge--error font-sans">Error</span>
548
+ <span class="pp-badge pp-badge--info font-sans">Info</span>
549
+ </div>
550
+
551
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:1.5rem;">Filled</p>
552
+ <div style="display:flex;flex-wrap:wrap;gap:0.5rem;margin-top:0.5rem;align-items:center;">
553
+ <span class="pp-badge pp-badge--primary pp-badge--filled font-sans">Primary</span>
554
+ <span class="pp-badge pp-badge--success pp-badge--filled font-sans">Success</span>
555
+ <span class="pp-badge pp-badge--warning pp-badge--filled font-sans">Warning</span>
556
+ <span class="pp-badge pp-badge--error pp-badge--filled font-sans">Error</span>
557
+ <span class="pp-badge pp-badge--info pp-badge--filled font-sans">Info</span>
558
+ </div>
559
+
560
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:1.5rem;">Sizes</p>
561
+ <div style="display:flex;flex-wrap:wrap;gap:0.5rem;margin-top:0.5rem;align-items:center;">
562
+ <span class="pp-badge pp-badge--info pp-badge--sm font-sans">Small</span>
563
+ <span class="pp-badge pp-badge--info font-sans">Default</span>
564
+ <span class="pp-badge pp-badge--info pp-badge--lg font-sans">Large</span>
565
+ </div>
566
+
567
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:1.5rem;">Dot indicator</p>
568
+ <div style="display:flex;flex-wrap:wrap;gap:1rem;margin-top:0.5rem;align-items:center;">
569
+ <span class="pp-badge pp-badge--error pp-badge--dot" aria-label="3 unread notifications"></span>
570
+ <span class="pp-badge pp-badge--success pp-badge--dot" aria-label="Online"></span>
571
+ <span class="pp-badge pp-badge--warning pp-badge--dot" aria-label="Away"></span>
572
+ </div>
573
+
574
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:1.5rem;">In context</p>
575
+ <div style="display:flex;flex-wrap:wrap;gap:1rem;margin-top:0.5rem;align-items:center;">
576
+ <span class="font-sans font-500" style="color:var(--pp-on-surface);">
577
+ Messages <span class="pp-badge pp-badge--error pp-badge--filled">3</span>
578
+ </span>
579
+ <span class="font-sans font-500" style="color:var(--pp-on-surface);">
580
+ Status <span class="pp-badge pp-badge--success">Active</span>
581
+ </span>
582
+ <span class="font-sans font-500" style="color:var(--pp-on-surface);">
583
+ Plan <span class="pp-badge pp-badge--primary pp-badge--filled">Beta</span>
584
+ </span>
585
+ </div>
586
+ </div>
587
+ </section>
588
+
213
589
  <!-- Buttons -->
214
590
  <section id="buttons" class="pp-section">
215
591
  <div class="pp-section__inner" style="align-items:flex-start;">
@@ -217,22 +593,42 @@ const greet = (name) =&gt; `Hello, ${name}!`;</code></pre>
217
593
 
218
594
  <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;">Filled</p>
219
595
  <div class="row" style="justify-content:flex-start;">
220
- <button class="button font-sans">Primary</button>
221
- <button class="button-success font-sans">Success</button>
222
- <button class="button-warning font-sans">Warning</button>
223
- <button class="button-error font-sans">Error</button>
224
- <button class="button-dark font-sans">Dark</button>
225
- <button class="button-gradient font-sans">Gradient</button>
226
- <button class="button-ghost font-sans">Ghost</button>
596
+ <button class="pp-button font-sans">Primary</button>
597
+ <button class="pp-button--success font-sans">Success</button>
598
+ <button class="pp-button--warning font-sans">Warning</button>
599
+ <button class="pp-button--error font-sans">Error</button>
600
+ <button class="pp-button--dark font-sans">Dark</button>
601
+ <button class="pp-button--gradient font-sans">Gradient</button>
602
+ <button class="pp-button--ghost font-sans">Ghost</button>
227
603
  </div>
228
604
 
229
605
  <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:1.5rem;">Outline</p>
230
606
  <div class="row" style="justify-content:flex-start;">
231
- <button class="button-outline font-sans">Primary</button>
232
- <button class="button-outline-success font-sans">Success</button>
233
- <button class="button-outline-warning font-sans">Warning</button>
234
- <button class="button-outline-error font-sans">Error</button>
235
- <button class="button-outline-dark font-sans">Dark</button>
607
+ <button class="pp-button--outline font-sans">Primary</button>
608
+ <button class="pp-button--outline pp-button--success font-sans">Success</button>
609
+ <button class="pp-button--outline pp-button--warning font-sans">Warning</button>
610
+ <button class="pp-button--outline pp-button--error font-sans">Error</button>
611
+ <button class="pp-button--outline pp-button--dark font-sans">Dark</button>
612
+ </div>
613
+
614
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:2rem;">Dark mode preview</p>
615
+ <div class="dark" style="margin-top:0.5rem;background:#18181b;border-radius:16px;padding:1.25rem 1.5rem;display:flex;flex-direction:column;gap:1rem;align-items:flex-start;">
616
+ <div class="row" style="justify-content:flex-start;">
617
+ <button class="pp-button font-sans">Primary</button>
618
+ <button class="pp-button--success font-sans">Success</button>
619
+ <button class="pp-button--warning font-sans">Warning</button>
620
+ <button class="pp-button--error font-sans">Error</button>
621
+ <button class="pp-button--dark font-sans">Dark</button>
622
+ <button class="pp-button--gradient font-sans">Gradient</button>
623
+ <button class="pp-button--ghost font-sans">Ghost</button>
624
+ </div>
625
+ <div class="row" style="justify-content:flex-start;">
626
+ <button class="pp-button--outline font-sans">Primary</button>
627
+ <button class="pp-button--outline pp-button--success font-sans">Success</button>
628
+ <button class="pp-button--outline pp-button--warning font-sans">Warning</button>
629
+ <button class="pp-button--outline pp-button--error font-sans">Error</button>
630
+ <button class="pp-button--outline pp-button--dark font-sans">Dark</button>
631
+ </div>
236
632
  </div>
237
633
  </div>
238
634
  </section>
@@ -248,7 +644,7 @@ const greet = (name) =&gt; `Hello, ${name}!`;</code></pre>
248
644
  <p class="pp-card__title">Clean by default</p>
249
645
  <p class="pp-card__body">White background, subtle shadow, 16px radius. The base card — works for anything.</p>
250
646
  <div class="pp-card__footer">
251
- <button class="button font-sans font-400">Learn more</button>
647
+ <button class="pp-button font-sans font-400">Learn more</button>
252
648
  </div>
253
649
  </div>
254
650
  <div class="pp-card pp-card--dark">
@@ -256,7 +652,7 @@ const greet = (name) =&gt; `Hello, ${name}!`;</code></pre>
256
652
  <p class="pp-card__title">Midnight surface</p>
257
653
  <p class="pp-card__body">Deep neutral background with a primary-light eyebrow. Pairs well with dark sections.</p>
258
654
  <div class="pp-card__footer">
259
- <button class="button font-sans font-400">Learn more</button>
655
+ <button class="pp-button font-sans font-400">Learn more</button>
260
656
  </div>
261
657
  </div>
262
658
  <div class="pp-card pp-card--gradient">
@@ -264,7 +660,7 @@ const greet = (name) =&gt; `Hello, ${name}!`;</code></pre>
264
660
  <p class="pp-card__title">A little spice</p>
265
661
  <p class="pp-card__body">The signature PeppertinoCSS gradient — warm gold to red. Use sparingly for emphasis.</p>
266
662
  <div class="pp-card__footer">
267
- <button class="button font-sans font-400" style="background:#fff;color:#ea5753;">Learn more</button>
663
+ <button class="pp-button font-sans font-400" style="background:#fff;color:#ea5753;">Learn more</button>
268
664
  </div>
269
665
  </div>
270
666
  </div>
@@ -275,7 +671,7 @@ const greet = (name) =&gt; `Hello, ${name}!`;</code></pre>
275
671
  <p class="pp-card__title">Solid red card</p>
276
672
  <p class="pp-card__body">Full primary background. Strong call-to-action surface — use for featured content.</p>
277
673
  <div class="pp-card__footer">
278
- <button class="button-outline font-sans font-400" style="border-color:rgba(255,255,255,0.5);color:#fff;">Explore</button>
674
+ <button class="pp-button--outline font-sans font-400" style="border-color:rgba(255,255,255,0.5);color:#fff;">Explore</button>
279
675
  </div>
280
676
  </div>
281
677
  <div class="pp-card pp-card--ghost">
@@ -283,7 +679,31 @@ const greet = (name) =&gt; `Hello, ${name}!`;</code></pre>
283
679
  <p class="pp-card__title">Transparent surface</p>
284
680
  <p class="pp-card__body">No background, border only. Fills white and gains a shadow on hover. Great for secondary content.</p>
285
681
  <div class="pp-card__footer">
286
- <button class="button-outline font-sans font-400">Explore</button>
682
+ <button class="pp-button--outline font-sans font-400">Explore</button>
683
+ </div>
684
+ </div>
685
+ </div>
686
+
687
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:2.5rem;">Dark mode preview</p>
688
+ <div class="dark" style="margin-top:0.5rem;background:#18181b;border-radius:20px;padding:1.5rem;">
689
+ <div class="pp-card-grid pp-card-grid--3">
690
+ <div class="pp-card">
691
+ <p class="pp-card__eyebrow">Framework</p>
692
+ <p class="pp-card__title">Clean by default</p>
693
+ <p class="pp-card__body">Dark mode flips the surface — same classes, zero extra markup.</p>
694
+ <div class="pp-card__footer"><button class="pp-button font-sans font-400">Learn more</button></div>
695
+ </div>
696
+ <div class="pp-card pp-card--dark">
697
+ <p class="pp-card__eyebrow">Dark variant</p>
698
+ <p class="pp-card__title">Midnight surface</p>
699
+ <p class="pp-card__body">Explicit dark variant stays dark regardless of the global toggle.</p>
700
+ <div class="pp-card__footer"><button class="pp-button font-sans font-400">Learn more</button></div>
701
+ </div>
702
+ <div class="pp-card pp-card--ghost">
703
+ <p class="pp-card__eyebrow">Ghost variant</p>
704
+ <p class="pp-card__title">Border only</p>
705
+ <p class="pp-card__body">Ghost card adapts its hover fill to the dark surface token.</p>
706
+ <div class="pp-card__footer"><button class="pp-button--outline font-sans font-400">Explore</button></div>
287
707
  </div>
288
708
  </div>
289
709
  </div>
@@ -433,8 +853,8 @@ const greet = (name) =&gt; `Hello, ${name}!`;</code></pre>
433
853
  <section id="gradient" class="pp-section pp-section--dark">
434
854
  <div class="pp-section__inner">
435
855
  <h2 class="font-sans font-700 tracking-tight" style="color:#fff;">Gradient Text</h2>
436
- <h1 class="gradient-txt font-sans font-700 tracking-tight">PeppertinoCSS</h1>
437
- <p class="gradient-txt font-sans font-400 text-xl leading-relaxed">The quick brown fox jumps over the lazy dog.</p>
856
+ <h1 class="pp-gradient-text font-sans font-700 tracking-tight">PeppertinoCSS</h1>
857
+ <p class="pp-gradient-text font-sans font-400 text-xl leading-relaxed">The quick brown fox jumps over the lazy dog.</p>
438
858
  </div>
439
859
  </section>
440
860
 
@@ -444,9 +864,9 @@ const greet = (name) =&gt; `Hello, ${name}!`;</code></pre>
444
864
  <h2 class="font-sans font-700 tracking-tight" style="color:#fff;">Modals</h2>
445
865
  <p class="font-sans font-400 text-sm" style="color:rgba(255,255,255,0.6);">Glassmorphic backdrop blur with frosted container.</p>
446
866
  <div class="row">
447
- <button class="button font-sans" data-modal-open="modal-basic">Basic</button>
448
- <button class="button font-sans" data-modal-open="modal-destructive">Destructive</button>
449
- <button class="button-outline font-sans" style="border-color:rgba(255,255,255,0.4);color:#fff;" data-modal-open="modal-confirm">Confirm</button>
867
+ <button class="pp-button font-sans" data-modal-open="modal-basic">Basic</button>
868
+ <button class="pp-button font-sans" data-modal-open="modal-destructive">Destructive</button>
869
+ <button class="pp-button--outline font-sans" style="border-color:rgba(255,255,255,0.4);color:#fff;" data-modal-open="modal-confirm">Confirm</button>
450
870
  </div>
451
871
  </div>
452
872
  </section>
@@ -548,6 +968,26 @@ const greet = (name) =&gt; `Hello, ${name}!`;</code></pre>
548
968
  <li role="option"><button class="pp-select__option font-sans">Option B</button></li>
549
969
  </ul>
550
970
  </div>
971
+
972
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:2rem;">Dark mode preview</p>
973
+ <div class="dark" style="margin-top:0.5rem;background:#18181b;border-radius:16px;padding:1.5rem;display:flex;flex-direction:column;gap:1rem;">
974
+ <select class="font-sans">
975
+ <option>Native select in dark mode</option>
976
+ <option>Option B</option>
977
+ <option>Option C</option>
978
+ </select>
979
+ <div class="pp-select">
980
+ <button class="pp-select__trigger font-sans" type="button" aria-label="Custom select dark">
981
+ <span class="pp-select__value">Custom .pp-select in dark</span>
982
+ <span class="pp-select__chevron"></span>
983
+ </button>
984
+ <ul class="pp-select__panel" role="listbox">
985
+ <li role="option"><button class="pp-select__option font-sans">Primary Red</button></li>
986
+ <li role="option"><button class="pp-select__option font-sans is-selected">Dark</button></li>
987
+ <li role="option"><button class="pp-select__option font-sans">Gradient Gold</button></li>
988
+ </ul>
989
+ </div>
990
+ </div>
551
991
  </div>
552
992
  </section>
553
993
 
@@ -602,6 +1042,58 @@ const greet = (name) =&gt; `Hello, ${name}!`;</code></pre>
602
1042
  </div>
603
1043
  </section>
604
1044
 
1045
+ <!-- Switch -->
1046
+ <section id="switches" class="pp-section">
1047
+ <div class="pp-section__inner text-left" style="align-items:flex-start;max-width:720px;">
1048
+ <h2 class="font-sans font-700 tracking-tight">Switch</h2>
1049
+ <p class="font-sans font-400 text-sm" style="color:#71717a;">iOS-style toggle. JS wires <code class="font-mono">aria-checked</code> and Space key. CSS provides the full visual baseline.</p>
1050
+
1051
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:1.5rem;">Default</p>
1052
+ <div style="display:flex;flex-wrap:wrap;gap:1.5rem;margin-top:0.75rem;align-items:center;">
1053
+ <div style="display:flex;flex-direction:column;align-items:center;gap:0.5rem;">
1054
+ <button class="pp-switch" role="switch" aria-checked="false" aria-label="Notifications off"></button>
1055
+ <span class="font-sans text-xs" style="color:#71717a;">Off</span>
1056
+ </div>
1057
+ <div style="display:flex;flex-direction:column;align-items:center;gap:0.5rem;">
1058
+ <button class="pp-switch" role="switch" aria-checked="true" aria-label="Notifications on"></button>
1059
+ <span class="font-sans text-xs" style="color:#71717a;">On</span>
1060
+ </div>
1061
+ </div>
1062
+
1063
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:1.5rem;">Sizes</p>
1064
+ <div style="display:flex;flex-wrap:wrap;gap:2rem;margin-top:0.75rem;align-items:center;">
1065
+ <div style="display:flex;flex-direction:column;align-items:center;gap:0.5rem;">
1066
+ <button class="pp-switch pp-switch--sm" role="switch" aria-checked="true" aria-label="Compact mode"></button>
1067
+ <span class="font-sans text-xs" style="color:#71717a;">Small</span>
1068
+ </div>
1069
+ <div style="display:flex;flex-direction:column;align-items:center;gap:0.5rem;">
1070
+ <button class="pp-switch" role="switch" aria-checked="true" aria-label="Default size"></button>
1071
+ <span class="font-sans text-xs" style="color:#71717a;">Default</span>
1072
+ </div>
1073
+ <div style="display:flex;flex-direction:column;align-items:center;gap:0.5rem;">
1074
+ <button class="pp-switch pp-switch--lg" role="switch" aria-checked="true" aria-label="Large mode"></button>
1075
+ <span class="font-sans text-xs" style="color:#71717a;">Large</span>
1076
+ </div>
1077
+ </div>
1078
+
1079
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:1.5rem;">In a settings row</p>
1080
+ <div style="display:flex;flex-direction:column;gap:0;margin-top:0.5rem;border:1px solid var(--pp-neutral-200);border-radius:12px;overflow:hidden;">
1081
+ <label style="display:flex;justify-content:space-between;align-items:center;padding:0.875rem 1rem;border-bottom:1px solid var(--pp-neutral-200);">
1082
+ <span class="font-sans font-500 text-sm" style="color:var(--pp-on-surface);">Push notifications</span>
1083
+ <button class="pp-switch" role="switch" aria-checked="true" aria-label="Push notifications"></button>
1084
+ </label>
1085
+ <label style="display:flex;justify-content:space-between;align-items:center;padding:0.875rem 1rem;border-bottom:1px solid var(--pp-neutral-200);">
1086
+ <span class="font-sans font-500 text-sm" style="color:var(--pp-on-surface);">Email digest</span>
1087
+ <button class="pp-switch" role="switch" aria-checked="false" aria-label="Email digest"></button>
1088
+ </label>
1089
+ <label style="display:flex;justify-content:space-between;align-items:center;padding:0.875rem 1rem;">
1090
+ <span class="font-sans font-500 text-sm" style="color:var(--pp-on-surface);">Dark mode</span>
1091
+ <button class="pp-switch" role="switch" aria-checked="false" aria-label="Dark mode" data-theme-toggle></button>
1092
+ </label>
1093
+ </div>
1094
+ </div>
1095
+ </section>
1096
+
605
1097
  <!-- Tables -->
606
1098
  <section id="tables" class="pp-section">
607
1099
  <div class="pp-section__inner text-left" style="align-items:flex-start;max-width:1100px;">
@@ -635,6 +1127,106 @@ const greet = (name) =&gt; `Hello, ${name}!`;</code></pre>
635
1127
  <tr><td>Weight</td><td>1.24 kg</td></tr>
636
1128
  </tbody>
637
1129
  </table>
1130
+
1131
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:2rem;">Dark mode preview</p>
1132
+ <div class="dark" style="margin-top:0.5rem;background:#18181b;border-radius:16px;padding:1.5rem;">
1133
+ <table class="pp-table pp-table--cols-3" style="width:100%;">
1134
+ <thead><tr><th class="font-sans font-600">Spec</th><th class="font-sans font-600">MacBook Air</th><th class="font-sans font-600">MacBook Pro</th></tr></thead>
1135
+ <tbody>
1136
+ <tr><td>Chip</td><td>M3</td><td>M4 Pro</td></tr>
1137
+ <tr><td>RAM</td><td>8 GB</td><td>24 GB</td></tr>
1138
+ <tr><td>Storage</td><td>256 GB</td><td>512 GB</td></tr>
1139
+ <tr><td>Price</td><td>₹99,900</td><td>₹199,900</td></tr>
1140
+ </tbody>
1141
+ </table>
1142
+ </div>
1143
+ </div>
1144
+ </section>
1145
+
1146
+ <!-- Toast -->
1147
+ <section id="toasts" class="pp-section pp-section--muted">
1148
+ <div class="pp-section__inner text-left" style="align-items:flex-start;max-width:720px;">
1149
+ <h2 class="font-sans font-700 tracking-tight">Toast</h2>
1150
+ <p class="font-sans font-400 text-sm" style="color:#71717a;">Auto-dismissing notification toasts. <code class="font-mono">ppToast.show()</code> creates and injects them on demand.</p>
1151
+
1152
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:1.5rem;">Trigger examples</p>
1153
+ <div style="display:flex;flex-wrap:wrap;gap:0.75rem;margin-top:0.75rem;">
1154
+ <button class="pp-button font-sans" onclick="ppToast.show({ message: 'Changes saved successfully.', variant: 'success' })">
1155
+ Success toast
1156
+ </button>
1157
+ <button class="pp-button--outline pp-button--error font-sans" onclick="ppToast.show({ message: 'Network error — please retry.', title: 'Connection failed', variant: 'error', duration: 6000 })">
1158
+ Error toast
1159
+ </button>
1160
+ <button class="pp-button--outline font-sans" onclick="ppToast.show({ message: 'Review required before publishing.', variant: 'warning' })">
1161
+ Warning toast
1162
+ </button>
1163
+ <button class="pp-button--outline font-sans" onclick="ppToast.show({ message: 'v0.5.0 is now available.', title: 'Update', variant: 'info', position: 'bottom-center' })">
1164
+ Info (bottom)
1165
+ </button>
1166
+ <button class="pp-button--ghost font-sans" onclick="ppToast.show({ message: 'Action completed.', variant: 'neutral' })">
1167
+ Neutral toast
1168
+ </button>
1169
+ </div>
1170
+
1171
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:1.5rem;">Positions</p>
1172
+ <div style="display:flex;flex-wrap:wrap;gap:0.5rem;margin-top:0.5rem;">
1173
+ <code class="font-mono text-xs" style="background:var(--pp-neutral-100);color:var(--pp-on-surface);padding:0.25rem 0.5rem;border-radius:6px;">top-right</code>
1174
+ <code class="font-mono text-xs" style="background:var(--pp-neutral-100);color:var(--pp-on-surface);padding:0.25rem 0.5rem;border-radius:6px;">top-left</code>
1175
+ <code class="font-mono text-xs" style="background:var(--pp-neutral-100);color:var(--pp-on-surface);padding:0.25rem 0.5rem;border-radius:6px;">top-center</code>
1176
+ <code class="font-mono text-xs" style="background:var(--pp-neutral-100);color:var(--pp-on-surface);padding:0.25rem 0.5rem;border-radius:6px;">bottom-right</code>
1177
+ <code class="font-mono text-xs" style="background:var(--pp-neutral-100);color:var(--pp-on-surface);padding:0.25rem 0.5rem;border-radius:6px;">bottom-left</code>
1178
+ <code class="font-mono text-xs" style="background:var(--pp-neutral-100);color:var(--pp-on-surface);padding:0.25rem 0.5rem;border-radius:6px;">bottom-center</code>
1179
+ </div>
1180
+ </div>
1181
+ </section>
1182
+
1183
+ <!-- Tooltip -->
1184
+ <section id="tooltips" class="pp-section">
1185
+ <div class="pp-section__inner text-left" style="align-items:flex-start;max-width:720px;">
1186
+ <h2 class="font-sans font-700 tracking-tight">Tooltip</h2>
1187
+ <p class="font-sans font-400 text-sm" style="color:#71717a;">CSS-only. Shows on <code class="font-mono">:hover</code> and <code class="font-mono">:focus-within</code> — no JavaScript required. Four placements.</p>
1188
+
1189
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:1.5rem;">Placements</p>
1190
+ <div style="display:flex;flex-wrap:wrap;gap:3rem;margin-top:2.5rem;padding-bottom:2rem;align-items:center;justify-content:flex-start;">
1191
+ <span class="pp-tooltip">
1192
+ <button class="pp-button--outline font-sans">Top (default)</button>
1193
+ <span class="pp-tooltip__content" role="tooltip">Default placement</span>
1194
+ </span>
1195
+ <span class="pp-tooltip">
1196
+ <button class="pp-button--outline font-sans">Bottom</button>
1197
+ <span class="pp-tooltip__content pp-tooltip__content--bottom" role="tooltip">Shown below</span>
1198
+ </span>
1199
+ <span class="pp-tooltip">
1200
+ <button class="pp-button--outline font-sans">Left</button>
1201
+ <span class="pp-tooltip__content pp-tooltip__content--left" role="tooltip">Shown left</span>
1202
+ </span>
1203
+ <span class="pp-tooltip">
1204
+ <button class="pp-button--outline font-sans">Right</button>
1205
+ <span class="pp-tooltip__content pp-tooltip__content--right" role="tooltip">Shown right</span>
1206
+ </span>
1207
+ </div>
1208
+
1209
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:0.5rem;">On icon buttons</p>
1210
+ <div style="display:flex;gap:1.5rem;margin-top:1.25rem;align-items:center;">
1211
+ <span class="pp-tooltip">
1212
+ <button class="pp-button--ghost font-sans" style="padding:0.5rem;" aria-label="Settings">
1213
+ <i data-lucide="settings" aria-hidden="true"></i>
1214
+ </button>
1215
+ <span class="pp-tooltip__content pp-tooltip__content--bottom" role="tooltip">Settings</span>
1216
+ </span>
1217
+ <span class="pp-tooltip">
1218
+ <button class="pp-button--ghost font-sans" style="padding:0.5rem;" aria-label="Notifications">
1219
+ <i data-lucide="bell" aria-hidden="true"></i>
1220
+ </button>
1221
+ <span class="pp-tooltip__content pp-tooltip__content--bottom" role="tooltip">Notifications</span>
1222
+ </span>
1223
+ <span class="pp-tooltip">
1224
+ <button class="pp-button--ghost font-sans" style="padding:0.5rem;" aria-label="Delete">
1225
+ <i data-lucide="trash-2" aria-hidden="true"></i>
1226
+ </button>
1227
+ <span class="pp-tooltip__content pp-tooltip__content--bottom" role="tooltip" style="background:var(--pp-error);">Delete</span>
1228
+ </span>
1229
+ </div>
638
1230
  </div>
639
1231
  </section>
640
1232
 
@@ -1128,7 +1720,7 @@ const greet = (name) =&gt; `Hello, ${name}!`;</code></pre>
1128
1720
  I have checked that the amount I wish to transfer is correct and understand this action cannot be undone.
1129
1721
  </span>
1130
1722
  </label>
1131
- <button class="button font-sans pp-submit--gated" type="button">Confirm transfer</button>
1723
+ <button class="pp-button font-sans pp-submit--gated" type="button">Confirm transfer</button>
1132
1724
  </div>
1133
1725
 
1134
1726
  <!-- Destructive confirmation -->
@@ -1140,7 +1732,7 @@ const greet = (name) =&gt; `Hello, ${name}!`;</code></pre>
1140
1732
  I understand that deleting my account is permanent and all my data will be removed.
1141
1733
  </span>
1142
1734
  </label>
1143
- <button class="button-error font-sans pp-submit--gated" type="button">Delete account</button>
1735
+ <button class="pp-button--error font-sans pp-submit--gated" type="button">Delete account</button>
1144
1736
  </div>
1145
1737
 
1146
1738
  <!-- ppValidation API demo -->
@@ -1153,15 +1745,15 @@ const greet = (name) =&gt; `Hello, ${name}!`;</code></pre>
1153
1745
  <span class="pp-field__hint" id="api-field-hint">3–20 characters, letters and underscores only.</span>
1154
1746
  </div>
1155
1747
  <div class="row" style="justify-content:flex-start;">
1156
- <button class="button-error font-sans font-400" type="button"
1748
+ <button class="pp-button--error font-sans font-400" type="button"
1157
1749
  onclick="ppValidation.setError(document.getElementById('api-field'), 'Username already taken.')">
1158
1750
  Set error
1159
1751
  </button>
1160
- <button class="button-success font-sans font-400" type="button"
1752
+ <button class="pp-button--success font-sans font-400" type="button"
1161
1753
  onclick="ppValidation.setSuccess(document.getElementById('api-field'), 'Username is available.')">
1162
1754
  Set success
1163
1755
  </button>
1164
- <button class="button-ghost font-sans font-400" type="button"
1756
+ <button class="pp-button--ghost font-sans font-400" type="button"
1165
1757
  onclick="ppValidation.clearError(document.getElementById('api-field'))">
1166
1758
  Clear
1167
1759
  </button>
@@ -1200,6 +1792,149 @@ const greet = (name) =&gt; `Hello, ${name}!`;</code></pre>
1200
1792
  <tr><td><code class="font-mono">setSummary(errors[], summaryEl)</code></td><td>Populates summary, shows it, moves focus to it</td></tr>
1201
1793
  </tbody>
1202
1794
  </table>
1795
+
1796
+ <!-- ── Dark mode preview ──────────────────────────────────────────────── -->
1797
+ <h3 class="font-sans font-600 text-xl" style="margin-top:2rem;">Dark mode preview</h3>
1798
+ <p class="font-sans font-400 text-sm" style="color:#71717a;">All form components respond to a <code class="font-mono">.dark</code> ancestor — no extra classes required.</p>
1799
+ <div class="dark" style="margin-top:1rem;background:#18181b;border-radius:16px;padding:2rem;display:flex;flex-direction:column;gap:1.5rem;">
1800
+
1801
+ <fieldset class="pp-fieldset">
1802
+ <legend>Account settings</legend>
1803
+ <div class="pp-field">
1804
+ <label class="pp-field__label font-sans" for="dm-name">Display name <abbr class="pp-field__required" title="required"></abbr></label>
1805
+ <div class="pp-field__input-wrap">
1806
+ <span class="pp-field__icon"><i data-lucide="user" aria-hidden="true"></i></span>
1807
+ <input class="pp-field__input font-sans" type="text" id="dm-name" placeholder="e.g. Debaditya" />
1808
+ </div>
1809
+ <span class="pp-field__hint">This is what others will see on your profile.</span>
1810
+ </div>
1811
+ <div class="pp-field pp-field--error">
1812
+ <label class="pp-field__label font-sans" for="dm-email">Email <abbr class="pp-field__required" title="required"></abbr></label>
1813
+ <input class="pp-field__input font-sans" type="email" id="dm-email" placeholder="you@example.com" aria-invalid="true" aria-describedby="dm-email-err" />
1814
+ <span class="pp-field__message" id="dm-email-err"><i data-lucide="circle-x" aria-hidden="true"></i> Enter a valid email address.</span>
1815
+ </div>
1816
+ <div class="pp-field pp-field--success">
1817
+ <label class="pp-field__label font-sans" for="dm-handle">Username</label>
1818
+ <input class="pp-field__input font-sans" type="text" id="dm-handle" value="@debaditya" aria-invalid="false" />
1819
+ <span class="pp-field__message"><i data-lucide="circle-check" aria-hidden="true"></i> Username is available.</span>
1820
+ </div>
1821
+ <div class="pp-field">
1822
+ <label class="pp-field__label font-sans" for="dm-bio">Bio <span class="pp-field__optional">(optional)</span></label>
1823
+ <textarea class="pp-field__textarea font-sans" id="dm-bio" rows="3" placeholder="Tell us a bit about yourself…"></textarea>
1824
+ </div>
1825
+ </fieldset>
1826
+
1827
+ <div class="pp-alert pp-alert--info font-sans" role="note">
1828
+ <span class="pp-alert__icon"><i data-lucide="info" aria-hidden="true"></i></span>
1829
+ <div class="pp-alert__body"><p class="pp-alert__title">Dark form alert</p><p class="pp-alert__message">Token overrides cascade from the <code class="font-mono">.dark</code> ancestor — no modifier classes needed.</p></div>
1830
+ </div>
1831
+
1832
+ <select class="font-sans">
1833
+ <option>Notification frequency</option>
1834
+ <option>Immediately</option>
1835
+ <option>Daily digest</option>
1836
+ <option>Weekly</option>
1837
+ </select>
1838
+ </div>
1839
+ </div>
1840
+ </section>
1841
+
1842
+ <!-- Utilities -->
1843
+ <section id="utilities" class="pp-section">
1844
+ <div class="pp-section__inner text-left" style="align-items:flex-start;max-width:860px;">
1845
+ <h2 class="font-sans font-700 tracking-tight">Utilities</h2>
1846
+ <p class="font-sans font-400 text-sm" style="color:#71717a;">Low-level single-purpose classes for spacing, layout, display, and visibility. No JavaScript.</p>
1847
+
1848
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:1.5rem;">Display</p>
1849
+ <div class="row" style="justify-content:flex-start;flex-wrap:wrap;gap:0.5rem;margin-top:0.5rem;">
1850
+ <code class="font-mono" style="background:var(--pp-neutral-100);color:var(--pp-on-surface);padding:0.25rem 0.5rem;border-radius:6px;">.d-block</code>
1851
+ <code class="font-mono" style="background:var(--pp-neutral-100);color:var(--pp-on-surface);padding:0.25rem 0.5rem;border-radius:6px;">.d-inline</code>
1852
+ <code class="font-mono" style="background:var(--pp-neutral-100);color:var(--pp-on-surface);padding:0.25rem 0.5rem;border-radius:6px;">.d-inline-block</code>
1853
+ <code class="font-mono" style="background:var(--pp-neutral-100);color:var(--pp-on-surface);padding:0.25rem 0.5rem;border-radius:6px;">.d-flex</code>
1854
+ <code class="font-mono" style="background:var(--pp-neutral-100);color:var(--pp-on-surface);padding:0.25rem 0.5rem;border-radius:6px;">.d-inline-flex</code>
1855
+ <code class="font-mono" style="background:var(--pp-neutral-100);color:var(--pp-on-surface);padding:0.25rem 0.5rem;border-radius:6px;">.d-grid</code>
1856
+ <code class="font-mono" style="background:var(--pp-neutral-100);color:var(--pp-on-surface);padding:0.25rem 0.5rem;border-radius:6px;">.d-inline-grid</code>
1857
+ <code class="font-mono" style="background:var(--pp-neutral-100);color:var(--pp-on-surface);padding:0.25rem 0.5rem;border-radius:6px;">.d-none</code>
1858
+ <code class="font-mono" style="background:var(--pp-neutral-100);color:var(--pp-on-surface);padding:0.25rem 0.5rem;border-radius:6px;">.d-contents</code>
1859
+ </div>
1860
+
1861
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:2rem;">Visibility &amp; screen-reader</p>
1862
+ <div class="row" style="justify-content:flex-start;gap:0.5rem;margin-top:0.5rem;">
1863
+ <code class="font-mono" style="background:var(--pp-neutral-100);color:var(--pp-on-surface);padding:0.25rem 0.5rem;border-radius:6px;">.visible</code>
1864
+ <code class="font-mono" style="background:var(--pp-neutral-100);color:var(--pp-on-surface);padding:0.25rem 0.5rem;border-radius:6px;">.invisible</code>
1865
+ <code class="font-mono" style="background:var(--pp-neutral-100);color:var(--pp-on-surface);padding:0.25rem 0.5rem;border-radius:6px;">.sr-only</code>
1866
+ <code class="font-mono" style="background:var(--pp-neutral-100);color:var(--pp-on-surface);padding:0.25rem 0.5rem;border-radius:6px;">.not-sr-only</code>
1867
+ </div>
1868
+
1869
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:2rem;">Spacing — margin &amp; padding</p>
1870
+ <p class="font-sans font-400 text-sm" style="color:#71717a;margin-top:0.25rem;">Pattern: <code class="font-mono">{m|p}{side?}-{key}</code>. Side: <code class="font-mono">t b l r x y</code>. Key: <code class="font-mono">0 1 2 3 4 5 6 8 10 12 16 20 24 32</code>. Margin also takes <code class="font-mono">auto</code>.</p>
1871
+ <div style="display:flex;flex-direction:column;gap:0.75rem;margin-top:1rem;">
1872
+ <div style="display:flex;align-items:center;gap:1rem;">
1873
+ <div class="d-flex items-center justify-center" style="background:var(--pp-neutral-200);border-radius:6px;min-width:120px;min-height:40px;">
1874
+ <div class="p-4" style="background:#e90111;border-radius:4px;color:#fff;font-size:0.75rem;font-family:var(--font-mono, monospace);">.p-4</div>
1875
+ </div>
1876
+ <div class="d-flex items-center justify-center" style="background:var(--pp-neutral-200);border-radius:6px;min-width:120px;min-height:40px;">
1877
+ <div class="px-6 py-2" style="background:#e90111;border-radius:4px;color:#fff;font-size:0.75rem;font-family:var(--font-mono, monospace);">.px-6.py-2</div>
1878
+ </div>
1879
+ <div class="d-flex items-center justify-center" style="background:var(--pp-info, #3b82f6);opacity:0.18;border-radius:6px;min-width:120px;min-height:40px;position:relative;">
1880
+ <div class="d-flex items-center justify-center" style="position:absolute;inset:0;">
1881
+ <div class="mx-auto" style="background:#3b82f6;border-radius:4px;color:#fff;padding:0.25rem 0.75rem;font-size:0.75rem;font-family:var(--font-mono, monospace);width:80px;">.mx-auto</div>
1882
+ </div>
1883
+ </div>
1884
+ </div>
1885
+ </div>
1886
+
1887
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:2rem;">Flex utilities demo</p>
1888
+ <div class="d-flex gap-3 flex-wrap items-center justify-between" style="background:var(--pp-neutral-100);padding:1rem;border-radius:10px;margin-top:0.5rem;">
1889
+ <div style="background:#e90111;color:#fff;padding:0.5rem 1rem;border-radius:6px;font-size:0.75rem;font-family:monospace;">Item 1</div>
1890
+ <div style="background:#e90111;color:#fff;padding:0.5rem 1rem;border-radius:6px;font-size:0.75rem;font-family:monospace;">Item 2</div>
1891
+ <div style="background:#e90111;color:#fff;padding:0.5rem 1rem;border-radius:6px;font-size:0.75rem;font-family:monospace;">Item 3</div>
1892
+ <div style="background:#e90111;color:#fff;padding:0.5rem 1rem;border-radius:6px;font-size:0.75rem;font-family:monospace;">Item 4</div>
1893
+ </div>
1894
+ <p class="font-sans font-400 text-xs" style="color:#71717a;margin-top:0.5rem;"><code class="font-mono">.d-flex.gap-3.flex-wrap.items-center.justify-between</code></p>
1895
+
1896
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:2rem;">Grid utilities demo</p>
1897
+ <div class="d-grid grid-cols-4 gap-3" style="margin-top:0.5rem;">
1898
+ <div style="background:#ffcf67;border-radius:8px;height:60px;"></div>
1899
+ <div class="col-span-2" style="background:linear-gradient(135deg,#ffcf67,#ea5753);border-radius:8px;height:60px;"></div>
1900
+ <div style="background:#ea5753;border-radius:8px;height:60px;"></div>
1901
+ <div class="col-span-full" style="background:var(--pp-neutral-900);border-radius:8px;height:40px;display:flex;align-items:center;justify-content:center;color:var(--pp-neutral-50);font-size:0.75rem;font-family:monospace;">.col-span-full</div>
1902
+ </div>
1903
+ <p class="font-sans font-400 text-xs" style="color:#71717a;margin-top:0.5rem;"><code class="font-mono">.d-grid.grid-cols-4.gap-3</code> with <code class="font-mono">.col-span-2</code> and <code class="font-mono">.col-span-full</code></p>
1904
+
1905
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:2rem;">Reference — all utility groups</p>
1906
+ <table class="pp-table pp-table--cols-2" style="width:100%;">
1907
+ <thead><tr><th class="font-sans font-600">Group</th><th class="font-sans font-600">Classes</th></tr></thead>
1908
+ <tbody>
1909
+ <tr><td>Display</td><td><code class="font-mono">.d-{block|inline|inline-block|flex|inline-flex|grid|inline-grid|none|contents}</code></td></tr>
1910
+ <tr><td>Visibility</td><td><code class="font-mono">.visible .invisible .sr-only .not-sr-only</code></td></tr>
1911
+ <tr><td>Opacity</td><td><code class="font-mono">.opacity-{0|25|50|75|100}</code></td></tr>
1912
+ <tr><td>Margin</td><td><code class="font-mono">.m-* .mt-* .mb-* .ml-* .mr-* .mx-* .my-*</code> (keys 0–32, auto)</td></tr>
1913
+ <tr><td>Padding</td><td><code class="font-mono">.p-* .pt-* .pb-* .pl-* .pr-* .px-* .py-*</code> (keys 0–32)</td></tr>
1914
+ <tr><td>Gap</td><td><code class="font-mono">.gap-* .gap-x-* .gap-y-*</code> (keys 0–32)</td></tr>
1915
+ <tr><td>Flex direction</td><td><code class="font-mono">.flex-row .flex-col .flex-row-reverse .flex-col-reverse</code></td></tr>
1916
+ <tr><td>Flex wrap</td><td><code class="font-mono">.flex-wrap .flex-nowrap .flex-wrap-reverse</code></td></tr>
1917
+ <tr><td>Flex grow/shrink</td><td><code class="font-mono">.flex-1 .flex-auto .flex-none .flex-shrink-0 .flex-grow .flex-grow-0</code></td></tr>
1918
+ <tr><td>Justify content</td><td><code class="font-mono">.justify-{start|end|center|between|around|evenly}</code></td></tr>
1919
+ <tr><td>Align items</td><td><code class="font-mono">.items-{start|end|center|baseline|stretch}</code></td></tr>
1920
+ <tr><td>Align self</td><td><code class="font-mono">.self-{auto|start|end|center|stretch}</code></td></tr>
1921
+ <tr><td>Grid columns</td><td><code class="font-mono">.grid-cols-{1–6,12}</code></td></tr>
1922
+ <tr><td>Grid rows</td><td><code class="font-mono">.grid-rows-{1–4}</code></td></tr>
1923
+ <tr><td>Column span</td><td><code class="font-mono">.col-span-{1|2|3|4|6|full}</code></td></tr>
1924
+ <tr><td>Row span</td><td><code class="font-mono">.row-span-{1|2|3|full}</code></td></tr>
1925
+ <tr><td>Width</td><td><code class="font-mono">.w-full .w-screen .w-auto .w-fit .w-min .w-max .w-half</code></td></tr>
1926
+ <tr><td>Height</td><td><code class="font-mono">.h-full .h-screen .h-auto .h-fit</code></td></tr>
1927
+ <tr><td>Overflow</td><td><code class="font-mono">.overflow-{auto|hidden|visible|scroll} .overflow-x-* .overflow-y-*</code></td></tr>
1928
+ <tr><td>Position</td><td><code class="font-mono">.static .relative .absolute .fixed .sticky</code></td></tr>
1929
+ <tr><td>Z-index</td><td><code class="font-mono">.z-{below|base|raised|overlay|modal|toast|tooltip}</code></td></tr>
1930
+ <tr><td>Border radius</td><td><code class="font-mono">.rounded .rounded-{none|sm|base|md|lg|xl|2xl|full}</code></td></tr>
1931
+ <tr><td>Shadow</td><td><code class="font-mono">.shadow-none .shadow-sm .shadow .shadow-md .shadow-lg .shadow-xl</code></td></tr>
1932
+ <tr><td>Cursor</td><td><code class="font-mono">.cursor-{default|pointer|not-allowed|grab|text}</code></td></tr>
1933
+ <tr><td>Pointer events</td><td><code class="font-mono">.pointer-events-none .pointer-events-auto</code></td></tr>
1934
+ <tr><td>User select</td><td><code class="font-mono">.select-{none|text|all|auto}</code></td></tr>
1935
+ <tr><td>Responsive prefix</td><td><code class="font-mono">.sm-{class} .md-{class} .lg-{class} .xl-{class} .w2xl-{class}</code> (display only, e.g. <code class="font-mono">.md-d-flex</code>)</td></tr>
1936
+ </tbody>
1937
+ </table>
1203
1938
  </div>
1204
1939
  </section>
1205
1940
 
@@ -1208,19 +1943,50 @@ const greet = (name) =&gt; `Hello, ${name}!`;</code></pre>
1208
1943
  <div class="pp-section__inner text-left" style="align-items:flex-start;max-width:720px;">
1209
1944
  <h2 class="font-sans font-700 tracking-tight">Changelog</h2>
1210
1945
 
1211
- <!-- v0.3.0 -->
1946
+ <!-- v0.4.0 -->
1212
1947
  <div style="margin-top:2rem;">
1213
- <p class="font-sans font-600 text-lg" style="color:#18181b;">v0.3.0 <span class="font-400 text-sm" style="color:#71717a;">— 2026-06-05</span></p>
1948
+ <p class="font-sans font-600 text-lg" style="color:var(--pp-on-surface);">v0.4.0 <span class="font-400 text-sm" style="color:var(--pp-neutral-500);">— 2026-06-11</span></p>
1949
+
1950
+ <p class="font-sans font-600 text-xs uppercase tracking-wider" style="color:#e90111;margin-top:1rem;">New components</p>
1951
+ <ul class="font-sans font-400 text-sm" style="color:var(--pp-neutral-600);line-height:1.8;margin-top:0.5rem;padding-left:1.25rem;">
1952
+ <li><strong>Accordion</strong> — CSS max-height transition; variants: <code class="font-mono">--flush</code>, <code class="font-mono">--dark</code>, <code class="font-mono">--primary</code>; JS shim adds <code class="font-mono">aria-expanded</code>, keyboard nav (↑ ↓ Home End), <code class="font-mono">data-allow-multiple</code>.</li>
1953
+ <li><strong>Alert</strong> — inline feedback; variants: <code class="font-mono">--info</code>, <code class="font-mono">--success</code>, <code class="font-mono">--warning</code>, <code class="font-mono">--error</code>, <code class="font-mono">--primary</code>, <code class="font-mono">--neutral</code>; modifier: <code class="font-mono">--filled</code>; dismissible with slide-out animation.</li>
1954
+ </ul>
1955
+
1956
+ <p class="font-sans font-600 text-xs uppercase tracking-wider" style="color:#e90111;margin-top:1.25rem;">Utilities</p>
1957
+ <ul class="font-sans font-400 text-sm" style="color:var(--pp-neutral-600);line-height:1.8;margin-top:0.5rem;padding-left:1.25rem;">
1958
+ <li>New <code class="font-mono">utilities.scss</code> layer — display, visibility, opacity, margin, padding, gap, flex, grid, width, height, overflow, position, z-index, border-radius, shadow, cursor, pointer-events, user-select, responsive display prefixes.</li>
1959
+ </ul>
1960
+
1961
+ <p class="font-sans font-600 text-xs uppercase tracking-wider" style="color:#e90111;margin-top:1.25rem;">Dark mode</p>
1962
+ <ul class="font-sans font-400 text-sm" style="color:var(--pp-neutral-600);line-height:1.8;margin-top:0.5rem;padding-left:1.25rem;">
1963
+ <li>Class-based dark mode via <code class="font-mono">.dark</code> on <code class="font-mono">&lt;html&gt;</code> — never <code class="font-mono">prefers-color-scheme</code>. Toggle persists to <code class="font-mono">localStorage</code>.</li>
1964
+ <li>All design tokens in <code class="font-mono">base.scss</code> now exposed as <code class="font-mono">--pp-*</code> CSS custom properties on <code class="font-mono">:root</code>. <code class="font-mono">dark-mode.scss</code> overrides them under <code class="font-mono">.dark</code> — neutral scale fully inverted, surfaces swapped, shadows strengthened.</li>
1965
+ <li>Component SCSS updated to consume CSS vars instead of hardcoded color literals throughout.</li>
1966
+ <li>Demo: moon/sun toggle in header; every component section shows a <code class="font-mono">.dark</code>-wrapped preview alongside the light demo.</li>
1967
+ </ul>
1968
+
1969
+ <p class="font-sans font-600 text-xs uppercase tracking-wider" style="color:#e90111;margin-top:1.25rem;">Bug fixes</p>
1970
+ <ul class="font-sans font-400 text-sm" style="color:var(--pp-neutral-600);line-height:1.8;margin-top:0.5rem;padding-left:1.25rem;">
1971
+ <li>Table row borders now use <code class="font-mono">var(--pp-border)</code> instead of the static SCSS neutral-200 value.</li>
1972
+ <li>Utilities demo chips and containers use CSS vars — readable in dark mode.</li>
1973
+ <li>Changelog and inline section-label colors replaced with CSS vars throughout the demo page.</li>
1974
+ </ul>
1975
+ </div>
1976
+
1977
+ <!-- v0.3.0 -->
1978
+ <div style="margin-top:2.5rem;padding-top:2rem;border-top:1px solid var(--pp-border);">
1979
+ <p class="font-sans font-600 text-lg" style="color:var(--pp-on-surface);">v0.3.0 <span class="font-400 text-sm" style="color:var(--pp-neutral-500);">— 2026-06-05</span></p>
1214
1980
 
1215
1981
  <p class="font-sans font-600 text-xs uppercase tracking-wider" style="color:#e90111;margin-top:1rem;">New components</p>
1216
- <ul class="font-sans font-400 text-sm" style="color:#52525b;line-height:1.8;margin-top:0.5rem;padding-left:1.25rem;">
1982
+ <ul class="font-sans font-400 text-sm" style="color:var(--pp-neutral-600);line-height:1.8;margin-top:0.5rem;padding-left:1.25rem;">
1217
1983
  <li><strong>Carousel</strong> — CSS scroll-snap driven; variants: <code class="font-mono">--peek-2</code>, <code class="font-mono">--peek-3</code>, <code class="font-mono">--dark</code>, <code class="font-mono">--flush</code>; <code class="font-mono">ppCarousel</code> JS API.</li>
1218
1984
  <li><strong>Footer</strong> — multi-column layout, <code class="font-mono">--dark</code> and <code class="font-mono">--accent</code> variants; CSS only.</li>
1219
1985
  <li><strong>Forms</strong> — five new form components: Fieldset &amp; Legend, Form Instructions, Label, Text Field, Validation.</li>
1220
1986
  </ul>
1221
1987
 
1222
1988
  <p class="font-sans font-600 text-xs uppercase tracking-wider" style="color:#e90111;margin-top:1.25rem;">Forms detail</p>
1223
- <ul class="font-sans font-400 text-sm" style="color:#52525b;line-height:1.8;margin-top:0.5rem;padding-left:1.25rem;">
1989
+ <ul class="font-sans font-400 text-sm" style="color:var(--pp-neutral-600);line-height:1.8;margin-top:0.5rem;padding-left:1.25rem;">
1224
1990
  <li><strong>Label</strong> — four importance tiers (primary → quaternary); Apple Dynamic Type scale (headline → caption); <code class="font-mono">--selectable</code>, <code class="font-mono">--truncate</code>, icon row.</li>
1225
1991
  <li><strong>Fieldset</strong> — variants: default, <code class="font-mono">--ghost</code>, <code class="font-mono">--filled</code>, <code class="font-mono">--primary</code>, <code class="font-mono">--error</code>; legend modifiers: <code class="font-mono">--sm</code>, <code class="font-mono">--lg</code>, <code class="font-mono">--inline</code>.</li>
1226
1992
  <li><strong>Form Instructions</strong> — pre-<code class="font-mono">&lt;form&gt;</code> block for screen reader Forms Mode; variants: <code class="font-mono">--neutral</code>, <code class="font-mono">--warning</code>, <code class="font-mono">--error</code>; in-form hint and required note.</li>
@@ -1229,24 +1995,24 @@ const greet = (name) =&gt; `Hello, ${name}!`;</code></pre>
1229
1995
  </ul>
1230
1996
 
1231
1997
  <p class="font-sans font-600 text-xs uppercase tracking-wider" style="color:#e90111;margin-top:1.25rem;">Breakpoints</p>
1232
- <ul class="font-sans font-400 text-sm" style="color:#52525b;line-height:1.8;margin-top:0.5rem;padding-left:1.25rem;">
1998
+ <ul class="font-sans font-400 text-sm" style="color:var(--pp-neutral-600);line-height:1.8;margin-top:0.5rem;padding-left:1.25rem;">
1233
1999
  <li>Tailwind-compatible map: <code class="font-mono">sm</code> / <code class="font-mono">md</code> / <code class="font-mono">lg</code> / <code class="font-mono">xl</code> / <code class="font-mono">2xl</code>.</li>
1234
2000
  <li>Apple device map: 12 named breakpoints from <code class="font-mono">iphone-se</code> to <code class="font-mono">imac</code>.</li>
1235
2001
  <li><code class="font-mono">respond-below()</code> and <code class="font-mono">respond-between()</code> mixins added.</li>
1236
2002
  </ul>
1237
2003
 
1238
2004
  <p class="font-sans font-600 text-xs uppercase tracking-wider" style="color:#e90111;margin-top:1.25rem;">Icons &amp; demo</p>
1239
- <ul class="font-sans font-400 text-sm" style="color:#52525b;line-height:1.8;margin-top:0.5rem;padding-left:1.25rem;">
2005
+ <ul class="font-sans font-400 text-sm" style="color:var(--pp-neutral-600);line-height:1.8;margin-top:0.5rem;padding-left:1.25rem;">
1240
2006
  <li>Switched from Feather Icons to Lucide Icons (<code class="font-mono">lucide.createIcons()</code>).</li>
1241
2007
  <li>Demo: Installation section, Carousel, Footer, and Forms sections added; nav dropdowns for Components and Forms; Changelog section.</li>
1242
2008
  </ul>
1243
2009
  </div>
1244
2010
 
1245
2011
  <!-- v0.2.0 -->
1246
- <div style="margin-top:2.5rem;padding-top:2rem;border-top:1px solid #e4e4e7;">
1247
- <p class="font-sans font-600 text-lg" style="color:#18181b;">v0.2.0 <span class="font-400 text-sm" style="color:#71717a;">— 2026-06-01</span></p>
2012
+ <div style="margin-top:2.5rem;padding-top:2rem;border-top:1px solid var(--pp-border);">
2013
+ <p class="font-sans font-600 text-lg" style="color:var(--pp-on-surface);">v0.2.0 <span class="font-400 text-sm" style="color:var(--pp-neutral-500);">— 2026-06-01</span></p>
1248
2014
  <p class="font-sans font-600 text-xs uppercase tracking-wider" style="color:#e90111;margin-top:1rem;">Accessibility — full ARIA pass across all components</p>
1249
- <ul class="font-sans font-400 text-sm" style="color:#52525b;line-height:1.8;margin-top:0.5rem;padding-left:1.25rem;">
2015
+ <ul class="font-sans font-400 text-sm" style="color:var(--pp-neutral-600);line-height:1.8;margin-top:0.5rem;padding-left:1.25rem;">
1250
2016
  <li><strong>Header:</strong> <code class="font-mono">role="menubar"</code>, <code class="font-mono">role="menu"</code>, <code class="font-mono">role="menuitem"</code>; <code class="font-mono">aria-haspopup</code> + <code class="font-mono">aria-expanded</code> on triggers; <code class="font-mono">aria-hidden</code> on mobile drawer.</li>
1251
2017
  <li><strong>Modal:</strong> <code class="font-mono">role="dialog"</code> + <code class="font-mono">aria-modal</code>; <code class="font-mono">aria-labelledby</code> + <code class="font-mono">aria-describedby</code> auto-wired; focus trap; focus restored on close.</li>
1252
2018
  <li><strong>Select:</strong> <code class="font-mono">role="combobox"</code>, <code class="font-mono">role="listbox"</code>, <code class="font-mono">role="option"</code> + <code class="font-mono">aria-selected</code>; <code class="font-mono">aria-activedescendant</code> kept in sync.</li>
@@ -1257,9 +2023,9 @@ const greet = (name) =&gt; `Hello, ${name}!`;</code></pre>
1257
2023
  </div>
1258
2024
 
1259
2025
  <!-- v0.1.1 -->
1260
- <div style="margin-top:2.5rem;padding-top:2rem;border-top:1px solid #e4e4e7;">
1261
- <p class="font-sans font-600 text-lg" style="color:#18181b;">v0.1.1 <span class="font-400 text-sm" style="color:#71717a;">— initial release</span></p>
1262
- <ul class="font-sans font-400 text-sm" style="color:#52525b;line-height:1.8;margin-top:0.75rem;padding-left:1.25rem;">
2026
+ <div style="margin-top:2.5rem;padding-top:2rem;border-top:1px solid var(--pp-border);">
2027
+ <p class="font-sans font-600 text-lg" style="color:var(--pp-on-surface);">v0.1.1 <span class="font-400 text-sm" style="color:var(--pp-neutral-500);">— initial release</span></p>
2028
+ <ul class="font-sans font-400 text-sm" style="color:var(--pp-neutral-600);line-height:1.8;margin-top:0.75rem;padding-left:1.25rem;">
1263
2029
  <li>Reset, base tokens, button, card, gradient text, header, modal, section, select, table, tabs, typography.</li>
1264
2030
  <li>Progressive enhancement — CSS-only baseline; JS adds keyboard nav, animations, outside-click close.</li>
1265
2031
  <li>Inter + Kode Mono via Google Fonts; esbuild bundler with per-component files + <code class="font-mono">peppertino.js</code> aggregator.</li>
@@ -1291,11 +2057,10 @@ const greet = (name) =&gt; `Hello, ${name}!`;</code></pre>
1291
2057
  <div class="pp-footer__col">
1292
2058
  <p class="pp-footer__col-title font-sans">Components</p>
1293
2059
  <ul class="pp-footer__nav" aria-label="Component links">
2060
+ <li><a href="#accordion" class="pp-footer__nav-link font-sans">Accordion</a></li>
2061
+ <li><a href="#alert" class="pp-footer__nav-link font-sans">Alert</a></li>
1294
2062
  <li><a href="#buttons" class="pp-footer__nav-link font-sans">Buttons</a></li>
1295
- <li><a href="#cards" class="pp-footer__nav-link font-sans">Cards</a></li>
1296
- <li><a href="#carousel" class="pp-footer__nav-link font-sans">Carousel</a></li>
1297
2063
  <li><a href="#modals" class="pp-footer__nav-link font-sans">Modals</a></li>
1298
- <li><a href="#tabs" class="pp-footer__nav-link font-sans">Tabs</a></li>
1299
2064
  </ul>
1300
2065
  </div>
1301
2066