@auriel/peppertino 0.3.0 → 0.4.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.
package/index.html CHANGED
@@ -32,6 +32,8 @@
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>
35
37
  <li role="none"><a href="#buttons" class="pp-header__dropdown-link font-sans font-400" role="menuitem">Buttons</a></li>
36
38
  <li role="none"><a href="#cards" class="pp-header__dropdown-link font-sans font-400" role="menuitem">Cards</a></li>
37
39
  <li role="none"><a href="#carousel" class="pp-header__dropdown-link font-sans font-400" role="menuitem">Carousel</a></li>
@@ -53,16 +55,46 @@
53
55
  <li role="none"><a href="#form-validation" class="pp-header__dropdown-link font-sans font-400" role="menuitem">Validation</a></li>
54
56
  </ul>
55
57
  </li>
58
+ <li class="pp-header__nav-item" role="none">
59
+ <a href="#utilities" class="pp-header__nav-link font-sans font-400" role="menuitem">Utilities</a>
60
+ </li>
56
61
  <li class="pp-header__nav-item" role="none">
57
62
  <a href="#changelog" class="pp-header__nav-link font-sans font-400" role="menuitem">Changelog</a>
58
63
  </li>
59
64
  </ul>
60
65
  </nav>
61
- <button class="pp-header__toggle" aria-expanded="false" aria-label="Toggle navigation">
62
- <span></span><span></span><span></span>
63
- </button>
66
+ <div style="display:flex;align-items:center;gap:0.5rem;flex-shrink:0;">
67
+ <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">
68
+ <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>
69
+ <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>
70
+ </button>
71
+ <button class="pp-header__toggle" aria-expanded="false" aria-label="Toggle navigation">
72
+ <span></span><span></span><span></span>
73
+ </button>
74
+ </div>
64
75
  </header>
65
76
 
77
+ <script>
78
+ (function() {
79
+ var btn = document.getElementById('dark-toggle');
80
+ var sun = document.getElementById('dark-icon-sun');
81
+ var moon = document.getElementById('dark-icon-moon');
82
+ function apply(dark) {
83
+ document.documentElement.classList.toggle('dark', dark);
84
+ sun.style.display = dark ? 'block' : 'none';
85
+ moon.style.display = dark ? 'none' : 'block';
86
+ btn.style.background = dark ? 'rgba(255,255,255,0.08)' : '';
87
+ }
88
+ var stored = localStorage.getItem('pp-dark');
89
+ apply(stored === 'true');
90
+ btn.addEventListener('click', function() {
91
+ var isDark = document.documentElement.classList.contains('dark');
92
+ apply(!isDark);
93
+ localStorage.setItem('pp-dark', !isDark);
94
+ });
95
+ })();
96
+ </script>
97
+
66
98
  <!-- Hero -->
67
99
  <section id="hero" class="pp-section pp-section--gradient">
68
100
  <div class="pp-section__inner">
@@ -210,6 +242,293 @@ const greet = (name) =&gt; `Hello, ${name}!`;</code></pre>
210
242
  </div>
211
243
  </section>
212
244
 
245
+ <!-- Accordion -->
246
+ <section id="accordion" class="pp-section">
247
+ <div class="pp-section__inner text-left" style="align-items:flex-start;max-width:720px;">
248
+ <h2 class="font-sans font-700 tracking-tight">Accordion</h2>
249
+ <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>
250
+
251
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:1.5rem;">Default (single open)</p>
252
+ <div class="pp-accordion" style="margin-top:0.5rem;">
253
+ <div class="pp-accordion__item">
254
+ <button class="pp-accordion__trigger font-sans" aria-expanded="true" aria-controls="acc-1">
255
+ What is PeppertinoCSS?
256
+ <svg class="pp-accordion__icon" viewBox="0 0 24 24" aria-hidden="true"><polyline points="6 9 12 15 18 9"/></svg>
257
+ </button>
258
+ <div class="pp-accordion__panel is-open" id="acc-1" aria-hidden="false">
259
+ <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>
260
+ </div>
261
+ </div>
262
+ <div class="pp-accordion__item">
263
+ <button class="pp-accordion__trigger font-sans" aria-expanded="false" aria-controls="acc-2">
264
+ Does it require JavaScript?
265
+ <svg class="pp-accordion__icon" viewBox="0 0 24 24" aria-hidden="true"><polyline points="6 9 12 15 18 9"/></svg>
266
+ </button>
267
+ <div class="pp-accordion__panel" id="acc-2" aria-hidden="true">
268
+ <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>
269
+ </div>
270
+ </div>
271
+ <div class="pp-accordion__item">
272
+ <button class="pp-accordion__trigger font-sans" aria-expanded="false" aria-controls="acc-3">
273
+ Can I use it with any framework?
274
+ <svg class="pp-accordion__icon" viewBox="0 0 24 24" aria-hidden="true"><polyline points="6 9 12 15 18 9"/></svg>
275
+ </button>
276
+ <div class="pp-accordion__panel" id="acc-3" aria-hidden="true">
277
+ <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>
278
+ </div>
279
+ </div>
280
+ </div>
281
+
282
+ <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>
283
+ <div class="pp-accordion" data-allow-multiple style="margin-top:0.5rem;">
284
+ <div class="pp-accordion__item">
285
+ <button class="pp-accordion__trigger font-sans" aria-expanded="false" aria-controls="accm-1">
286
+ Spacing system
287
+ <svg class="pp-accordion__icon" viewBox="0 0 24 24" aria-hidden="true"><polyline points="6 9 12 15 18 9"/></svg>
288
+ </button>
289
+ <div class="pp-accordion__panel" id="accm-1" aria-hidden="true">
290
+ <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>
291
+ </div>
292
+ </div>
293
+ <div class="pp-accordion__item">
294
+ <button class="pp-accordion__trigger font-sans" aria-expanded="false" aria-controls="accm-2">
295
+ Color tokens
296
+ <svg class="pp-accordion__icon" viewBox="0 0 24 24" aria-hidden="true"><polyline points="6 9 12 15 18 9"/></svg>
297
+ </button>
298
+ <div class="pp-accordion__panel" id="accm-2" aria-hidden="true">
299
+ <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>
300
+ </div>
301
+ </div>
302
+ </div>
303
+
304
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:2rem;">Dark variant</p>
305
+ <div class="pp-accordion pp-accordion--dark" style="margin-top:0.5rem;">
306
+ <div class="pp-accordion__item">
307
+ <button class="pp-accordion__trigger font-sans" aria-expanded="true" aria-controls="accd-1">
308
+ MacBook Pro M4
309
+ <svg class="pp-accordion__icon" viewBox="0 0 24 24" aria-hidden="true"><polyline points="6 9 12 15 18 9"/></svg>
310
+ </button>
311
+ <div class="pp-accordion__panel is-open" id="accd-1" aria-hidden="false">
312
+ <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>
313
+ </div>
314
+ </div>
315
+ <div class="pp-accordion__item">
316
+ <button class="pp-accordion__trigger font-sans" aria-expanded="false" aria-controls="accd-2">
317
+ MacBook Air M3
318
+ <svg class="pp-accordion__icon" viewBox="0 0 24 24" aria-hidden="true"><polyline points="6 9 12 15 18 9"/></svg>
319
+ </button>
320
+ <div class="pp-accordion__panel" id="accd-2" aria-hidden="true">
321
+ <p class="pp-accordion__content">Impossibly thin. Apple M3, all-day battery, 13.6" Liquid Retina display. The world's best consumer laptop.</p>
322
+ </div>
323
+ </div>
324
+ </div>
325
+
326
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:2rem;">Flush variant</p>
327
+ <div class="pp-accordion pp-accordion--flush" style="margin-top:0.5rem;">
328
+ <div class="pp-accordion__item">
329
+ <button class="pp-accordion__trigger font-sans" aria-expanded="false" aria-controls="accf-1">
330
+ Is this flush?
331
+ <svg class="pp-accordion__icon" viewBox="0 0 24 24" aria-hidden="true"><polyline points="6 9 12 15 18 9"/></svg>
332
+ </button>
333
+ <div class="pp-accordion__panel" id="accf-1" aria-hidden="true">
334
+ <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>
335
+ </div>
336
+ </div>
337
+ <div class="pp-accordion__item">
338
+ <button class="pp-accordion__trigger font-sans" aria-expanded="false" aria-controls="accf-2">
339
+ When to use flush?
340
+ <svg class="pp-accordion__icon" viewBox="0 0 24 24" aria-hidden="true"><polyline points="6 9 12 15 18 9"/></svg>
341
+ </button>
342
+ <div class="pp-accordion__panel" id="accf-2" aria-hidden="true">
343
+ <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>
344
+ </div>
345
+ </div>
346
+ </div>
347
+
348
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:2rem;">Dark mode preview</p>
349
+ <div class="dark" style="margin-top:0.5rem;background:#18181b;border-radius:16px;padding:1.5rem;">
350
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-bottom:0.75rem;">.dark on ancestor</p>
351
+ <div class="pp-accordion">
352
+ <div class="pp-accordion__item">
353
+ <button class="pp-accordion__trigger font-sans" aria-expanded="true" aria-controls="acc-dm-1">
354
+ What is PeppertinoCSS?
355
+ <svg class="pp-accordion__icon" viewBox="0 0 24 24" aria-hidden="true"><polyline points="6 9 12 15 18 9"/></svg>
356
+ </button>
357
+ <div class="pp-accordion__panel is-open" id="acc-dm-1" aria-hidden="false">
358
+ <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>
359
+ </div>
360
+ </div>
361
+ <div class="pp-accordion__item">
362
+ <button class="pp-accordion__trigger font-sans" aria-expanded="false" aria-controls="acc-dm-2">
363
+ Does it require extra markup?
364
+ <svg class="pp-accordion__icon" viewBox="0 0 24 24" aria-hidden="true"><polyline points="6 9 12 15 18 9"/></svg>
365
+ </button>
366
+ <div class="pp-accordion__panel" id="acc-dm-2" aria-hidden="true">
367
+ <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>
368
+ </div>
369
+ </div>
370
+ </div>
371
+ </div>
372
+
373
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:2rem;">Usage</p>
374
+ <table class="pp-table pp-table--cols-2" style="width:100%;">
375
+ <thead><tr><th class="font-sans font-600">Class / attribute</th><th class="font-sans font-600">What it does</th></tr></thead>
376
+ <tbody>
377
+ <tr><td><code class="font-mono">.pp-accordion</code></td><td>Outer wrapper — bordered, rounded-16, white bg</td></tr>
378
+ <tr><td><code class="font-mono">.pp-accordion__item</code></td><td>Individual row — bottom border except last</td></tr>
379
+ <tr><td><code class="font-mono">.pp-accordion__trigger</code></td><td>Full-width button — icon rotates when open</td></tr>
380
+ <tr><td><code class="font-mono">.pp-accordion__panel</code></td><td>Collapsible region — max-height transition</td></tr>
381
+ <tr><td><code class="font-mono">.pp-accordion__content</code></td><td>Inner text wrapper</td></tr>
382
+ <tr><td><code class="font-mono">.pp-accordion__icon</code></td><td>Inline SVG chevron — 180° rotation when open</td></tr>
383
+ <tr><td><code class="font-mono">.pp-accordion--flush</code></td><td>No outer border / radius / shadow</td></tr>
384
+ <tr><td><code class="font-mono">.pp-accordion--dark</code></td><td>Dark neutral surface</td></tr>
385
+ <tr><td><code class="font-mono">.pp-accordion--primary</code></td><td>Open trigger gets primary red background</td></tr>
386
+ <tr><td><code class="font-mono">data-allow-multiple</code></td><td>Allow multiple items open simultaneously</td></tr>
387
+ <tr><td><code class="font-mono">aria-expanded</code></td><td>Drives open/closed state — the JS shim sets this</td></tr>
388
+ <tr><td><code class="font-mono">aria-controls</code></td><td>Links trigger to panel by id</td></tr>
389
+ <tr><td><code class="font-mono">.is-open</code></td><td>CSS class applied to panel when open (drives max-height)</td></tr>
390
+ </tbody>
391
+ </table>
392
+ </div>
393
+ </section>
394
+
395
+ <!-- Alert -->
396
+ <section id="alert" class="pp-section pp-section--muted">
397
+ <div class="pp-section__inner text-left" style="align-items:flex-start;max-width:720px;">
398
+ <h2 class="font-sans font-700 tracking-tight">Alert</h2>
399
+ <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>
400
+
401
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:1.5rem;">Soft (default)</p>
402
+ <div style="display:flex;flex-direction:column;gap:0.75rem;margin-top:0.5rem;">
403
+ <div class="pp-alert pp-alert--info font-sans" role="note">
404
+ <span class="pp-alert__icon"><i data-lucide="info" aria-hidden="true"></i></span>
405
+ <div class="pp-alert__body">
406
+ <p class="pp-alert__title">Info</p>
407
+ <p class="pp-alert__message">Your session will expire in 10 minutes. Save your work to avoid losing progress.</p>
408
+ </div>
409
+ </div>
410
+ <div class="pp-alert pp-alert--success font-sans" role="status">
411
+ <span class="pp-alert__icon"><i data-lucide="circle-check" aria-hidden="true"></i></span>
412
+ <div class="pp-alert__body">
413
+ <p class="pp-alert__title">Success</p>
414
+ <p class="pp-alert__message">Your changes have been saved and published successfully.</p>
415
+ </div>
416
+ </div>
417
+ <div class="pp-alert pp-alert--warning font-sans" role="note">
418
+ <span class="pp-alert__icon"><i data-lucide="triangle-alert" aria-hidden="true"></i></span>
419
+ <div class="pp-alert__body">
420
+ <p class="pp-alert__title">Warning</p>
421
+ <p class="pp-alert__message">This action will affect all linked accounts. Review before proceeding.</p>
422
+ </div>
423
+ </div>
424
+ <div class="pp-alert pp-alert--error font-sans" role="alert">
425
+ <span class="pp-alert__icon"><i data-lucide="circle-x" aria-hidden="true"></i></span>
426
+ <div class="pp-alert__body">
427
+ <p class="pp-alert__title">Error</p>
428
+ <p class="pp-alert__message">Payment failed. Check your card details and try again.</p>
429
+ </div>
430
+ </div>
431
+ <div class="pp-alert pp-alert--primary font-sans" role="note">
432
+ <span class="pp-alert__icon"><i data-lucide="zap" aria-hidden="true"></i></span>
433
+ <div class="pp-alert__body">
434
+ <p class="pp-alert__title">Primary</p>
435
+ <p class="pp-alert__message">PeppertinoCSS v0.3 is now available on npm. Check the changelog for what's new.</p>
436
+ </div>
437
+ </div>
438
+ <div class="pp-alert pp-alert--neutral font-sans" role="note">
439
+ <span class="pp-alert__icon"><i data-lucide="message-square" aria-hidden="true"></i></span>
440
+ <div class="pp-alert__body">
441
+ <p class="pp-alert__title">Neutral</p>
442
+ <p class="pp-alert__message">No issues detected. All systems are operating normally.</p>
443
+ </div>
444
+ </div>
445
+ </div>
446
+
447
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:2rem;">Filled</p>
448
+ <div style="display:flex;flex-direction:column;gap:0.75rem;margin-top:0.5rem;">
449
+ <div class="pp-alert pp-alert--filled pp-alert--info font-sans" role="note">
450
+ <span class="pp-alert__icon"><i data-lucide="info" aria-hidden="true"></i></span>
451
+ <div class="pp-alert__body"><p class="pp-alert__message">Filled info — your session expires in 10 minutes.</p></div>
452
+ </div>
453
+ <div class="pp-alert pp-alert--filled pp-alert--success font-sans" role="status">
454
+ <span class="pp-alert__icon"><i data-lucide="circle-check" aria-hidden="true"></i></span>
455
+ <div class="pp-alert__body"><p class="pp-alert__message">Filled success — changes saved and published.</p></div>
456
+ </div>
457
+ <div class="pp-alert pp-alert--filled pp-alert--warning font-sans" role="note">
458
+ <span class="pp-alert__icon"><i data-lucide="triangle-alert" aria-hidden="true"></i></span>
459
+ <div class="pp-alert__body"><p class="pp-alert__message">Filled warning — this will affect linked accounts.</p></div>
460
+ </div>
461
+ <div class="pp-alert pp-alert--filled pp-alert--error font-sans" role="alert">
462
+ <span class="pp-alert__icon"><i data-lucide="circle-x" aria-hidden="true"></i></span>
463
+ <div class="pp-alert__body"><p class="pp-alert__message">Filled error — payment failed. Check your card details.</p></div>
464
+ </div>
465
+ </div>
466
+
467
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:2rem;">Dismissible</p>
468
+ <div style="display:flex;flex-direction:column;gap:0.75rem;margin-top:0.5rem;">
469
+ <div class="pp-alert pp-alert--info is-dismissible font-sans" role="note" id="alert-dismiss-demo">
470
+ <span class="pp-alert__icon"><i data-lucide="info" aria-hidden="true"></i></span>
471
+ <div class="pp-alert__body">
472
+ <p class="pp-alert__title">Dismissible alert</p>
473
+ <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>
474
+ </div>
475
+ <button class="pp-alert__dismiss font-sans" aria-label="Dismiss alert"
476
+ onclick="const el=document.getElementById('alert-dismiss-demo');el.classList.add('is-dismissing');setTimeout(()=>el.remove(),200);">
477
+ <i data-lucide="x" aria-hidden="true"></i>
478
+ </button>
479
+ </div>
480
+ </div>
481
+
482
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:2rem;">Dark mode preview</p>
483
+ <div class="dark" style="margin-top:0.5rem;background:#18181b;border-radius:16px;padding:1.5rem;display:flex;flex-direction:column;gap:0.75rem;">
484
+ <div class="pp-alert pp-alert--info font-sans" role="note">
485
+ <span class="pp-alert__icon"><i data-lucide="info" aria-hidden="true"></i></span>
486
+ <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>
487
+ </div>
488
+ <div class="pp-alert pp-alert--success font-sans" role="status">
489
+ <span class="pp-alert__icon"><i data-lucide="circle-check" aria-hidden="true"></i></span>
490
+ <div class="pp-alert__body"><p class="pp-alert__title">Success</p><p class="pp-alert__message">Changes saved and published.</p></div>
491
+ </div>
492
+ <div class="pp-alert pp-alert--warning font-sans" role="note">
493
+ <span class="pp-alert__icon"><i data-lucide="triangle-alert" aria-hidden="true"></i></span>
494
+ <div class="pp-alert__body"><p class="pp-alert__title">Warning</p><p class="pp-alert__message">This will affect linked accounts.</p></div>
495
+ </div>
496
+ <div class="pp-alert pp-alert--error font-sans" role="alert">
497
+ <span class="pp-alert__icon"><i data-lucide="circle-x" aria-hidden="true"></i></span>
498
+ <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>
499
+ </div>
500
+ <div class="pp-alert pp-alert--primary font-sans" role="note">
501
+ <span class="pp-alert__icon"><i data-lucide="zap" aria-hidden="true"></i></span>
502
+ <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>
503
+ </div>
504
+ </div>
505
+
506
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:2rem;">Usage</p>
507
+ <table class="pp-table pp-table--cols-2" style="width:100%;">
508
+ <thead><tr><th class="font-sans font-600">Class</th><th class="font-sans font-600">What it does</th></tr></thead>
509
+ <tbody>
510
+ <tr><td><code class="font-mono">.pp-alert</code></td><td>Base wrapper — flex row, border, radius-12</td></tr>
511
+ <tr><td><code class="font-mono">.pp-alert--info</code></td><td>Blue tint</td></tr>
512
+ <tr><td><code class="font-mono">.pp-alert--success</code></td><td>Green tint</td></tr>
513
+ <tr><td><code class="font-mono">.pp-alert--warning</code></td><td>Amber tint</td></tr>
514
+ <tr><td><code class="font-mono">.pp-alert--error</code></td><td>Red tint — use <code>role="alert"</code></td></tr>
515
+ <tr><td><code class="font-mono">.pp-alert--primary</code></td><td>Spicy red tint</td></tr>
516
+ <tr><td><code class="font-mono">.pp-alert--neutral</code></td><td>Grey tint</td></tr>
517
+ <tr><td><code class="font-mono">.pp-alert--filled</code></td><td>Solid background instead of tinted</td></tr>
518
+ <tr><td><code class="font-mono">.pp-alert__icon</code></td><td>Leading icon slot — 18px</td></tr>
519
+ <tr><td><code class="font-mono">.pp-alert__title</code></td><td>Semibold label line</td></tr>
520
+ <tr><td><code class="font-mono">.pp-alert__message</code></td><td>Body text (85% opacity)</td></tr>
521
+ <tr><td><code class="font-mono">.is-dismissible</code></td><td>Adds right padding for the close button</td></tr>
522
+ <tr><td><code class="font-mono">.pp-alert__dismiss</code></td><td>Absolute-positioned close × button</td></tr>
523
+ <tr><td><code class="font-mono">.is-dismissing</code></td><td>Slide-out animation before DOM removal</td></tr>
524
+ <tr><td><code class="font-mono">role="alert"</code></td><td>Use on error alerts — announces immediately</td></tr>
525
+ <tr><td><code class="font-mono">role="status"</code></td><td>Use on success — polite announcement</td></tr>
526
+ <tr><td><code class="font-mono">role="note"</code></td><td>Use on info / warning — supplemental context</td></tr>
527
+ </tbody>
528
+ </table>
529
+ </div>
530
+ </section>
531
+
213
532
  <!-- Buttons -->
214
533
  <section id="buttons" class="pp-section">
215
534
  <div class="pp-section__inner" style="align-items:flex-start;">
@@ -234,6 +553,26 @@ const greet = (name) =&gt; `Hello, ${name}!`;</code></pre>
234
553
  <button class="button-outline-error font-sans">Error</button>
235
554
  <button class="button-outline-dark font-sans">Dark</button>
236
555
  </div>
556
+
557
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:2rem;">Dark mode preview</p>
558
+ <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;">
559
+ <div class="row" style="justify-content:flex-start;">
560
+ <button class="button font-sans">Primary</button>
561
+ <button class="button-success font-sans">Success</button>
562
+ <button class="button-warning font-sans">Warning</button>
563
+ <button class="button-error font-sans">Error</button>
564
+ <button class="button-dark font-sans">Dark</button>
565
+ <button class="button-gradient font-sans">Gradient</button>
566
+ <button class="button-ghost font-sans">Ghost</button>
567
+ </div>
568
+ <div class="row" style="justify-content:flex-start;">
569
+ <button class="button-outline font-sans">Primary</button>
570
+ <button class="button-outline-success font-sans">Success</button>
571
+ <button class="button-outline-warning font-sans">Warning</button>
572
+ <button class="button-outline-error font-sans">Error</button>
573
+ <button class="button-outline-dark font-sans">Dark</button>
574
+ </div>
575
+ </div>
237
576
  </div>
238
577
  </section>
239
578
 
@@ -287,6 +626,30 @@ const greet = (name) =&gt; `Hello, ${name}!`;</code></pre>
287
626
  </div>
288
627
  </div>
289
628
  </div>
629
+
630
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:2.5rem;">Dark mode preview</p>
631
+ <div class="dark" style="margin-top:0.5rem;background:#18181b;border-radius:20px;padding:1.5rem;">
632
+ <div class="pp-card-grid pp-card-grid--3">
633
+ <div class="pp-card">
634
+ <p class="pp-card__eyebrow">Framework</p>
635
+ <p class="pp-card__title">Clean by default</p>
636
+ <p class="pp-card__body">Dark mode flips the surface — same classes, zero extra markup.</p>
637
+ <div class="pp-card__footer"><button class="button font-sans font-400">Learn more</button></div>
638
+ </div>
639
+ <div class="pp-card pp-card--dark">
640
+ <p class="pp-card__eyebrow">Dark variant</p>
641
+ <p class="pp-card__title">Midnight surface</p>
642
+ <p class="pp-card__body">Explicit dark variant stays dark regardless of the global toggle.</p>
643
+ <div class="pp-card__footer"><button class="button font-sans font-400">Learn more</button></div>
644
+ </div>
645
+ <div class="pp-card pp-card--ghost">
646
+ <p class="pp-card__eyebrow">Ghost variant</p>
647
+ <p class="pp-card__title">Border only</p>
648
+ <p class="pp-card__body">Ghost card adapts its hover fill to the dark surface token.</p>
649
+ <div class="pp-card__footer"><button class="button-outline font-sans font-400">Explore</button></div>
650
+ </div>
651
+ </div>
652
+ </div>
290
653
  </div>
291
654
  </section>
292
655
 
@@ -548,6 +911,26 @@ const greet = (name) =&gt; `Hello, ${name}!`;</code></pre>
548
911
  <li role="option"><button class="pp-select__option font-sans">Option B</button></li>
549
912
  </ul>
550
913
  </div>
914
+
915
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:2rem;">Dark mode preview</p>
916
+ <div class="dark" style="margin-top:0.5rem;background:#18181b;border-radius:16px;padding:1.5rem;display:flex;flex-direction:column;gap:1rem;">
917
+ <select class="font-sans">
918
+ <option>Native select in dark mode</option>
919
+ <option>Option B</option>
920
+ <option>Option C</option>
921
+ </select>
922
+ <div class="pp-select">
923
+ <button class="pp-select__trigger font-sans" type="button" aria-label="Custom select dark">
924
+ <span class="pp-select__value">Custom .pp-select in dark</span>
925
+ <span class="pp-select__chevron"></span>
926
+ </button>
927
+ <ul class="pp-select__panel" role="listbox">
928
+ <li role="option"><button class="pp-select__option font-sans">Primary Red</button></li>
929
+ <li role="option"><button class="pp-select__option font-sans is-selected">Dark</button></li>
930
+ <li role="option"><button class="pp-select__option font-sans">Gradient Gold</button></li>
931
+ </ul>
932
+ </div>
933
+ </div>
551
934
  </div>
552
935
  </section>
553
936
 
@@ -635,6 +1018,19 @@ const greet = (name) =&gt; `Hello, ${name}!`;</code></pre>
635
1018
  <tr><td>Weight</td><td>1.24 kg</td></tr>
636
1019
  </tbody>
637
1020
  </table>
1021
+
1022
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:2rem;">Dark mode preview</p>
1023
+ <div class="dark" style="margin-top:0.5rem;background:#18181b;border-radius:16px;padding:1.5rem;">
1024
+ <table class="pp-table pp-table--cols-3" style="width:100%;">
1025
+ <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>
1026
+ <tbody>
1027
+ <tr><td>Chip</td><td>M3</td><td>M4 Pro</td></tr>
1028
+ <tr><td>RAM</td><td>8 GB</td><td>24 GB</td></tr>
1029
+ <tr><td>Storage</td><td>256 GB</td><td>512 GB</td></tr>
1030
+ <tr><td>Price</td><td>₹99,900</td><td>₹199,900</td></tr>
1031
+ </tbody>
1032
+ </table>
1033
+ </div>
638
1034
  </div>
639
1035
  </section>
640
1036
 
@@ -1200,6 +1596,149 @@ const greet = (name) =&gt; `Hello, ${name}!`;</code></pre>
1200
1596
  <tr><td><code class="font-mono">setSummary(errors[], summaryEl)</code></td><td>Populates summary, shows it, moves focus to it</td></tr>
1201
1597
  </tbody>
1202
1598
  </table>
1599
+
1600
+ <!-- ── Dark mode preview ──────────────────────────────────────────────── -->
1601
+ <h3 class="font-sans font-600 text-xl" style="margin-top:2rem;">Dark mode preview</h3>
1602
+ <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>
1603
+ <div class="dark" style="margin-top:1rem;background:#18181b;border-radius:16px;padding:2rem;display:flex;flex-direction:column;gap:1.5rem;">
1604
+
1605
+ <fieldset class="pp-fieldset">
1606
+ <legend>Account settings</legend>
1607
+ <div class="pp-field">
1608
+ <label class="pp-field__label font-sans" for="dm-name">Display name <abbr class="pp-field__required" title="required"></abbr></label>
1609
+ <div class="pp-field__input-wrap">
1610
+ <span class="pp-field__icon"><i data-lucide="user" aria-hidden="true"></i></span>
1611
+ <input class="pp-field__input font-sans" type="text" id="dm-name" placeholder="e.g. Debaditya" />
1612
+ </div>
1613
+ <span class="pp-field__hint">This is what others will see on your profile.</span>
1614
+ </div>
1615
+ <div class="pp-field pp-field--error">
1616
+ <label class="pp-field__label font-sans" for="dm-email">Email <abbr class="pp-field__required" title="required"></abbr></label>
1617
+ <input class="pp-field__input font-sans" type="email" id="dm-email" placeholder="you@example.com" aria-invalid="true" aria-describedby="dm-email-err" />
1618
+ <span class="pp-field__message" id="dm-email-err"><i data-lucide="circle-x" aria-hidden="true"></i> Enter a valid email address.</span>
1619
+ </div>
1620
+ <div class="pp-field pp-field--success">
1621
+ <label class="pp-field__label font-sans" for="dm-handle">Username</label>
1622
+ <input class="pp-field__input font-sans" type="text" id="dm-handle" value="@debaditya" aria-invalid="false" />
1623
+ <span class="pp-field__message"><i data-lucide="circle-check" aria-hidden="true"></i> Username is available.</span>
1624
+ </div>
1625
+ <div class="pp-field">
1626
+ <label class="pp-field__label font-sans" for="dm-bio">Bio <span class="pp-field__optional">(optional)</span></label>
1627
+ <textarea class="pp-field__textarea font-sans" id="dm-bio" rows="3" placeholder="Tell us a bit about yourself…"></textarea>
1628
+ </div>
1629
+ </fieldset>
1630
+
1631
+ <div class="pp-alert pp-alert--info font-sans" role="note">
1632
+ <span class="pp-alert__icon"><i data-lucide="info" aria-hidden="true"></i></span>
1633
+ <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>
1634
+ </div>
1635
+
1636
+ <select class="font-sans">
1637
+ <option>Notification frequency</option>
1638
+ <option>Immediately</option>
1639
+ <option>Daily digest</option>
1640
+ <option>Weekly</option>
1641
+ </select>
1642
+ </div>
1643
+ </div>
1644
+ </section>
1645
+
1646
+ <!-- Utilities -->
1647
+ <section id="utilities" class="pp-section">
1648
+ <div class="pp-section__inner text-left" style="align-items:flex-start;max-width:860px;">
1649
+ <h2 class="font-sans font-700 tracking-tight">Utilities</h2>
1650
+ <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>
1651
+
1652
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:1.5rem;">Display</p>
1653
+ <div class="row" style="justify-content:flex-start;flex-wrap:wrap;gap:0.5rem;margin-top:0.5rem;">
1654
+ <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>
1655
+ <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>
1656
+ <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>
1657
+ <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>
1658
+ <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>
1659
+ <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>
1660
+ <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>
1661
+ <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>
1662
+ <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>
1663
+ </div>
1664
+
1665
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:2rem;">Visibility &amp; screen-reader</p>
1666
+ <div class="row" style="justify-content:flex-start;gap:0.5rem;margin-top:0.5rem;">
1667
+ <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>
1668
+ <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>
1669
+ <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>
1670
+ <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>
1671
+ </div>
1672
+
1673
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:2rem;">Spacing — margin &amp; padding</p>
1674
+ <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>
1675
+ <div style="display:flex;flex-direction:column;gap:0.75rem;margin-top:1rem;">
1676
+ <div style="display:flex;align-items:center;gap:1rem;">
1677
+ <div class="d-flex items-center justify-center" style="background:var(--pp-neutral-200);border-radius:6px;min-width:120px;min-height:40px;">
1678
+ <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>
1679
+ </div>
1680
+ <div class="d-flex items-center justify-center" style="background:var(--pp-neutral-200);border-radius:6px;min-width:120px;min-height:40px;">
1681
+ <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>
1682
+ </div>
1683
+ <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;">
1684
+ <div class="d-flex items-center justify-center" style="position:absolute;inset:0;">
1685
+ <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>
1686
+ </div>
1687
+ </div>
1688
+ </div>
1689
+ </div>
1690
+
1691
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:2rem;">Flex utilities demo</p>
1692
+ <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;">
1693
+ <div style="background:#e90111;color:#fff;padding:0.5rem 1rem;border-radius:6px;font-size:0.75rem;font-family:monospace;">Item 1</div>
1694
+ <div style="background:#e90111;color:#fff;padding:0.5rem 1rem;border-radius:6px;font-size:0.75rem;font-family:monospace;">Item 2</div>
1695
+ <div style="background:#e90111;color:#fff;padding:0.5rem 1rem;border-radius:6px;font-size:0.75rem;font-family:monospace;">Item 3</div>
1696
+ <div style="background:#e90111;color:#fff;padding:0.5rem 1rem;border-radius:6px;font-size:0.75rem;font-family:monospace;">Item 4</div>
1697
+ </div>
1698
+ <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>
1699
+
1700
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:2rem;">Grid utilities demo</p>
1701
+ <div class="d-grid grid-cols-4 gap-3" style="margin-top:0.5rem;">
1702
+ <div style="background:#ffcf67;border-radius:8px;height:60px;"></div>
1703
+ <div class="col-span-2" style="background:linear-gradient(135deg,#ffcf67,#ea5753);border-radius:8px;height:60px;"></div>
1704
+ <div style="background:#ea5753;border-radius:8px;height:60px;"></div>
1705
+ <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>
1706
+ </div>
1707
+ <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>
1708
+
1709
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:2rem;">Reference — all utility groups</p>
1710
+ <table class="pp-table pp-table--cols-2" style="width:100%;">
1711
+ <thead><tr><th class="font-sans font-600">Group</th><th class="font-sans font-600">Classes</th></tr></thead>
1712
+ <tbody>
1713
+ <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>
1714
+ <tr><td>Visibility</td><td><code class="font-mono">.visible .invisible .sr-only .not-sr-only</code></td></tr>
1715
+ <tr><td>Opacity</td><td><code class="font-mono">.opacity-{0|25|50|75|100}</code></td></tr>
1716
+ <tr><td>Margin</td><td><code class="font-mono">.m-* .mt-* .mb-* .ml-* .mr-* .mx-* .my-*</code> (keys 0–32, auto)</td></tr>
1717
+ <tr><td>Padding</td><td><code class="font-mono">.p-* .pt-* .pb-* .pl-* .pr-* .px-* .py-*</code> (keys 0–32)</td></tr>
1718
+ <tr><td>Gap</td><td><code class="font-mono">.gap-* .gap-x-* .gap-y-*</code> (keys 0–32)</td></tr>
1719
+ <tr><td>Flex direction</td><td><code class="font-mono">.flex-row .flex-col .flex-row-reverse .flex-col-reverse</code></td></tr>
1720
+ <tr><td>Flex wrap</td><td><code class="font-mono">.flex-wrap .flex-nowrap .flex-wrap-reverse</code></td></tr>
1721
+ <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>
1722
+ <tr><td>Justify content</td><td><code class="font-mono">.justify-{start|end|center|between|around|evenly}</code></td></tr>
1723
+ <tr><td>Align items</td><td><code class="font-mono">.items-{start|end|center|baseline|stretch}</code></td></tr>
1724
+ <tr><td>Align self</td><td><code class="font-mono">.self-{auto|start|end|center|stretch}</code></td></tr>
1725
+ <tr><td>Grid columns</td><td><code class="font-mono">.grid-cols-{1–6,12}</code></td></tr>
1726
+ <tr><td>Grid rows</td><td><code class="font-mono">.grid-rows-{1–4}</code></td></tr>
1727
+ <tr><td>Column span</td><td><code class="font-mono">.col-span-{1|2|3|4|6|full}</code></td></tr>
1728
+ <tr><td>Row span</td><td><code class="font-mono">.row-span-{1|2|3|full}</code></td></tr>
1729
+ <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>
1730
+ <tr><td>Height</td><td><code class="font-mono">.h-full .h-screen .h-auto .h-fit</code></td></tr>
1731
+ <tr><td>Overflow</td><td><code class="font-mono">.overflow-{auto|hidden|visible|scroll} .overflow-x-* .overflow-y-*</code></td></tr>
1732
+ <tr><td>Position</td><td><code class="font-mono">.static .relative .absolute .fixed .sticky</code></td></tr>
1733
+ <tr><td>Z-index</td><td><code class="font-mono">.z-{below|base|raised|overlay|modal|toast|tooltip}</code></td></tr>
1734
+ <tr><td>Border radius</td><td><code class="font-mono">.rounded .rounded-{none|sm|base|md|lg|xl|2xl|full}</code></td></tr>
1735
+ <tr><td>Shadow</td><td><code class="font-mono">.shadow-none .shadow-sm .shadow .shadow-md .shadow-lg .shadow-xl</code></td></tr>
1736
+ <tr><td>Cursor</td><td><code class="font-mono">.cursor-{default|pointer|not-allowed|grab|text}</code></td></tr>
1737
+ <tr><td>Pointer events</td><td><code class="font-mono">.pointer-events-none .pointer-events-auto</code></td></tr>
1738
+ <tr><td>User select</td><td><code class="font-mono">.select-{none|text|all|auto}</code></td></tr>
1739
+ <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>
1740
+ </tbody>
1741
+ </table>
1203
1742
  </div>
1204
1743
  </section>
1205
1744
 
@@ -1208,19 +1747,50 @@ const greet = (name) =&gt; `Hello, ${name}!`;</code></pre>
1208
1747
  <div class="pp-section__inner text-left" style="align-items:flex-start;max-width:720px;">
1209
1748
  <h2 class="font-sans font-700 tracking-tight">Changelog</h2>
1210
1749
 
1211
- <!-- v0.3.0 -->
1750
+ <!-- v0.4.0 -->
1212
1751
  <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>
1752
+ <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>
1753
+
1754
+ <p class="font-sans font-600 text-xs uppercase tracking-wider" style="color:#e90111;margin-top:1rem;">New components</p>
1755
+ <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;">
1756
+ <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>
1757
+ <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>
1758
+ </ul>
1759
+
1760
+ <p class="font-sans font-600 text-xs uppercase tracking-wider" style="color:#e90111;margin-top:1.25rem;">Utilities</p>
1761
+ <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;">
1762
+ <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>
1763
+ </ul>
1764
+
1765
+ <p class="font-sans font-600 text-xs uppercase tracking-wider" style="color:#e90111;margin-top:1.25rem;">Dark mode</p>
1766
+ <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;">
1767
+ <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>
1768
+ <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>
1769
+ <li>Component SCSS updated to consume CSS vars instead of hardcoded color literals throughout.</li>
1770
+ <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>
1771
+ </ul>
1772
+
1773
+ <p class="font-sans font-600 text-xs uppercase tracking-wider" style="color:#e90111;margin-top:1.25rem;">Bug fixes</p>
1774
+ <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;">
1775
+ <li>Table row borders now use <code class="font-mono">var(--pp-border)</code> instead of the static SCSS neutral-200 value.</li>
1776
+ <li>Utilities demo chips and containers use CSS vars — readable in dark mode.</li>
1777
+ <li>Changelog and inline section-label colors replaced with CSS vars throughout the demo page.</li>
1778
+ </ul>
1779
+ </div>
1780
+
1781
+ <!-- v0.3.0 -->
1782
+ <div style="margin-top:2.5rem;padding-top:2rem;border-top:1px solid var(--pp-border);">
1783
+ <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
1784
 
1215
1785
  <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;">
1786
+ <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
1787
  <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
1788
  <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
1789
  <li><strong>Forms</strong> — five new form components: Fieldset &amp; Legend, Form Instructions, Label, Text Field, Validation.</li>
1220
1790
  </ul>
1221
1791
 
1222
1792
  <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;">
1793
+ <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
1794
  <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
1795
  <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
1796
  <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 +1799,24 @@ const greet = (name) =&gt; `Hello, ${name}!`;</code></pre>
1229
1799
  </ul>
1230
1800
 
1231
1801
  <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;">
1802
+ <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
1803
  <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
1804
  <li>Apple device map: 12 named breakpoints from <code class="font-mono">iphone-se</code> to <code class="font-mono">imac</code>.</li>
1235
1805
  <li><code class="font-mono">respond-below()</code> and <code class="font-mono">respond-between()</code> mixins added.</li>
1236
1806
  </ul>
1237
1807
 
1238
1808
  <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;">
1809
+ <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
1810
  <li>Switched from Feather Icons to Lucide Icons (<code class="font-mono">lucide.createIcons()</code>).</li>
1241
1811
  <li>Demo: Installation section, Carousel, Footer, and Forms sections added; nav dropdowns for Components and Forms; Changelog section.</li>
1242
1812
  </ul>
1243
1813
  </div>
1244
1814
 
1245
1815
  <!-- 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>
1816
+ <div style="margin-top:2.5rem;padding-top:2rem;border-top:1px solid var(--pp-border);">
1817
+ <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
1818
  <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;">
1819
+ <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
1820
  <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
1821
  <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
1822
  <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 +1827,9 @@ const greet = (name) =&gt; `Hello, ${name}!`;</code></pre>
1257
1827
  </div>
1258
1828
 
1259
1829
  <!-- 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;">
1830
+ <div style="margin-top:2.5rem;padding-top:2rem;border-top:1px solid var(--pp-border);">
1831
+ <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>
1832
+ <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
1833
  <li>Reset, base tokens, button, card, gradient text, header, modal, section, select, table, tabs, typography.</li>
1264
1834
  <li>Progressive enhancement — CSS-only baseline; JS adds keyboard nav, animations, outside-click close.</li>
1265
1835
  <li>Inter + Kode Mono via Google Fonts; esbuild bundler with per-component files + <code class="font-mono">peppertino.js</code> aggregator.</li>
@@ -1291,11 +1861,10 @@ const greet = (name) =&gt; `Hello, ${name}!`;</code></pre>
1291
1861
  <div class="pp-footer__col">
1292
1862
  <p class="pp-footer__col-title font-sans">Components</p>
1293
1863
  <ul class="pp-footer__nav" aria-label="Component links">
1864
+ <li><a href="#accordion" class="pp-footer__nav-link font-sans">Accordion</a></li>
1865
+ <li><a href="#alert" class="pp-footer__nav-link font-sans">Alert</a></li>
1294
1866
  <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
1867
  <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
1868
  </ul>
1300
1869
  </div>
1301
1870