@auriel/peppertino 0.1.1 → 0.3.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 (45) hide show
  1. package/CHANGELOG.txt +136 -0
  2. package/README.md +343 -30
  3. package/build.js +27 -12
  4. package/dist/carousel.js +152 -0
  5. package/dist/carousel.js.map +7 -0
  6. package/dist/header.js +69 -0
  7. package/dist/header.js.map +7 -0
  8. package/dist/main.css +2780 -0
  9. package/dist/main.css.map +1 -0
  10. package/dist/modal.js +112 -0
  11. package/dist/modal.js.map +7 -0
  12. package/dist/peppertino.js +637 -0
  13. package/dist/peppertino.js.map +7 -0
  14. package/dist/select.js +99 -0
  15. package/dist/select.js.map +7 -0
  16. package/dist/tabs.js +79 -0
  17. package/dist/tabs.js.map +7 -0
  18. package/dist/validation.js +130 -0
  19. package/dist/validation.js.map +7 -0
  20. package/index.html +1137 -22
  21. package/package.json +1 -1
  22. package/src/js/carousel.js +148 -0
  23. package/src/js/header.js +43 -4
  24. package/src/js/modal.js +134 -0
  25. package/src/js/peppertino.js +9 -0
  26. package/src/js/select.js +103 -0
  27. package/src/js/tabs.js +94 -0
  28. package/src/js/validation.js +132 -0
  29. package/src/scss/base.scss +26 -6
  30. package/src/scss/button.scss +87 -20
  31. package/src/scss/card.scss +121 -0
  32. package/src/scss/carousel.scss +313 -0
  33. package/src/scss/footer.scss +224 -0
  34. package/src/scss/forms/fieldset.scss +127 -0
  35. package/src/scss/forms/form-instructions.scss +133 -0
  36. package/src/scss/forms/label.scss +115 -0
  37. package/src/scss/forms/text-field.scss +240 -0
  38. package/src/scss/forms/validation.scss +215 -0
  39. package/src/scss/forms.scss +8 -0
  40. package/src/scss/header.scss +27 -6
  41. package/src/scss/main.scss +7 -0
  42. package/src/scss/modal.scss +188 -0
  43. package/src/scss/section.scss +1 -1
  44. package/src/scss/select.scss +210 -0
  45. package/src/scss/tabs.scss +156 -0
package/index.html CHANGED
@@ -4,8 +4,10 @@
4
4
  <meta charset="UTF-8" />
5
5
  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
6
6
  <title>PeppertinoCSS — Dev Sandbox</title>
7
- <link rel="stylesheet" href="dist/main.css" />
8
- <script src="dist/header.js" defer></script>
7
+ <link rel="stylesheet" href="dist/main.css?v=1780286329" />
8
+ <script src="https://unpkg.com/lucide@latest/dist/umd/lucide.min.js"></script>
9
+ <script src="dist/peppertino.js" defer></script>
10
+ <script>document.addEventListener('DOMContentLoaded', () => lucide.createIcons());</script>
9
11
  <style>
10
12
  /* Sandbox-only helpers — not part of the framework */
11
13
  .row { display: flex; flex-wrap: wrap; gap: 0.5rem; align-items: center; justify-content: center; }
@@ -16,22 +18,44 @@
16
18
 
17
19
  <header class="pp-header">
18
20
  <a href="#hero" class="pp-header__brand font-sans font-600">PeppertinoCSS</a>
19
- <nav>
20
- <ul class="pp-header__nav">
21
- <li class="pp-header__nav-item">
22
- <a href="#colors" class="pp-header__nav-link font-sans font-400">Colors</a>
21
+ <nav aria-label="Main navigation">
22
+ <ul class="pp-header__nav" role="menubar">
23
+ <li class="pp-header__nav-item" role="none">
24
+ <a href="#installation" class="pp-header__nav-link font-sans font-400" role="menuitem">Install</a>
23
25
  </li>
24
- <li class="pp-header__nav-item">
25
- <a href="#typography" class="pp-header__nav-link font-sans font-400">Typography</a>
26
+ <li class="pp-header__nav-item" role="none">
27
+ <a href="#colors" class="pp-header__nav-link font-sans font-400" role="menuitem">Colors</a>
26
28
  </li>
27
- <li class="pp-header__nav-item">
28
- <a href="#components" class="pp-header__nav-link font-sans font-400">Components</a>
29
- <ul class="pp-header__dropdown">
30
- <li><a href="#buttons" class="pp-header__dropdown-link font-sans font-400">Buttons</a></li>
31
- <li><a href="#gradient" class="pp-header__dropdown-link font-sans font-400">Gradient</a></li>
32
- <li><a href="#tables" class="pp-header__dropdown-link font-sans font-400">Tables</a></li>
29
+ <li class="pp-header__nav-item" role="none">
30
+ <a href="#typography" class="pp-header__nav-link font-sans font-400" role="menuitem">Typography</a>
31
+ </li>
32
+ <li class="pp-header__nav-item" role="none">
33
+ <a href="#components" class="pp-header__nav-link font-sans font-400" role="menuitem" aria-haspopup="true" aria-expanded="false">Components</a>
34
+ <ul class="pp-header__dropdown" role="menu" aria-label="Components">
35
+ <li role="none"><a href="#buttons" class="pp-header__dropdown-link font-sans font-400" role="menuitem">Buttons</a></li>
36
+ <li role="none"><a href="#cards" class="pp-header__dropdown-link font-sans font-400" role="menuitem">Cards</a></li>
37
+ <li role="none"><a href="#carousel" class="pp-header__dropdown-link font-sans font-400" role="menuitem">Carousel</a></li>
38
+ <li role="none"><a href="#footer" class="pp-header__dropdown-link font-sans font-400" role="menuitem">Footer</a></li>
39
+ <li role="none"><a href="#gradient" class="pp-header__dropdown-link font-sans font-400" role="menuitem">Gradient</a></li>
40
+ <li role="none"><a href="#modals" class="pp-header__dropdown-link font-sans font-400" role="menuitem">Modals</a></li>
41
+ <li role="none"><a href="#selects" class="pp-header__dropdown-link font-sans font-400" role="menuitem">Selects</a></li>
42
+ <li role="none"><a href="#tabs" class="pp-header__dropdown-link font-sans font-400" role="menuitem">Tabs</a></li>
43
+ <li role="none"><a href="#tables" class="pp-header__dropdown-link font-sans font-400" role="menuitem">Tables</a></li>
44
+ </ul>
45
+ </li>
46
+ <li class="pp-header__nav-item" role="none">
47
+ <a href="#forms" class="pp-header__nav-link font-sans font-400" role="menuitem" aria-haspopup="true" aria-expanded="false">Forms</a>
48
+ <ul class="pp-header__dropdown" role="menu" aria-label="Forms">
49
+ <li role="none"><a href="#form-fieldset" class="pp-header__dropdown-link font-sans font-400" role="menuitem">Fieldset</a></li>
50
+ <li role="none"><a href="#form-instructions" class="pp-header__dropdown-link font-sans font-400" role="menuitem">Form Instructions</a></li>
51
+ <li role="none"><a href="#form-label" class="pp-header__dropdown-link font-sans font-400" role="menuitem">Label</a></li>
52
+ <li role="none"><a href="#form-text-field" class="pp-header__dropdown-link font-sans font-400" role="menuitem">Text Field</a></li>
53
+ <li role="none"><a href="#form-validation" class="pp-header__dropdown-link font-sans font-400" role="menuitem">Validation</a></li>
33
54
  </ul>
34
55
  </li>
56
+ <li class="pp-header__nav-item" role="none">
57
+ <a href="#changelog" class="pp-header__nav-link font-sans font-400" role="menuitem">Changelog</a>
58
+ </li>
35
59
  </ul>
36
60
  </nav>
37
61
  <button class="pp-header__toggle" aria-expanded="false" aria-label="Toggle navigation">
@@ -51,8 +75,39 @@
51
75
  </div>
52
76
  </section>
53
77
 
78
+ <!-- Installation -->
79
+ <section id="installation" class="pp-section pp-section--muted">
80
+ <div class="pp-section__inner text-left" style="align-items:flex-start;max-width:720px;">
81
+ <h2 class="font-sans font-700 tracking-tight">Installation</h2>
82
+
83
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;">npm / bun</p>
84
+ <pre class="font-mono"><code>npm install @auriel/peppertino</code></pre>
85
+
86
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:2rem;">CDN — single stylesheet</p>
87
+ <pre class="font-mono"><code>&lt;link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@auriel/peppertino@latest/dist/main.min.css" /&gt;</code></pre>
88
+
89
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:2rem;">CDN — with JS components</p>
90
+ <pre class="font-mono"><code>&lt;link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@auriel/peppertino@latest/dist/main.min.css" /&gt;
91
+ &lt;script src="https://cdn.jsdelivr.net/npm/@auriel/peppertino@latest/dist/peppertino.js" defer&gt;&lt;/script&gt;</code></pre>
92
+
93
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:2rem;">Clone &amp; build locally</p>
94
+ <pre class="font-mono"><code>git clone https://codeberg.org/debaditya/Peppertino
95
+ cd Peppertino
96
+ npm install
97
+ npm run dev</code></pre>
98
+
99
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:2rem;">SCSS — import into your own build</p>
100
+ <pre class="font-mono"><code>@use '@auriel/peppertino/src/scss/main';</code></pre>
101
+
102
+ <p class="font-sans font-400 text-sm" style="color:#71717a;margin-top:1rem;">
103
+ See the full build script reference on
104
+ <a href="https://codeberg.org/debaditya/Peppertino" target="_blank" rel="noopener noreferrer">Codeberg</a>.
105
+ </p>
106
+ </div>
107
+ </section>
108
+
54
109
  <!-- Colors -->
55
- <section id="colors" class="pp-section pp-section--muted">
110
+ <section id="colors" class="pp-section">
56
111
  <div class="pp-section__inner">
57
112
  <h2 class="font-sans font-700 tracking-tight">Color Palette</h2>
58
113
 
@@ -64,7 +119,6 @@
64
119
  <span class="swatch" style="background:#a8000c" title="primary-dark"></span>
65
120
  </div>
66
121
  </div>
67
-
68
122
  <div>
69
123
  <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;">Gradient</p>
70
124
  <div class="row">
@@ -73,7 +127,6 @@
73
127
  <span class="swatch" style="background:linear-gradient(135deg,#ffcf67,#ea5753)" title="gradient"></span>
74
128
  </div>
75
129
  </div>
76
-
77
130
  <div>
78
131
  <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;">Neutrals</p>
79
132
  <div class="row">
@@ -89,7 +142,6 @@
89
142
  <span class="swatch" style="background:#18181b"></span>
90
143
  </div>
91
144
  </div>
92
-
93
145
  <div>
94
146
  <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;">Semantic</p>
95
147
  <div class="row">
@@ -160,11 +212,219 @@ const greet = (name) =&gt; `Hello, ${name}!`;</code></pre>
160
212
 
161
213
  <!-- Buttons -->
162
214
  <section id="buttons" class="pp-section">
163
- <div class="pp-section__inner">
215
+ <div class="pp-section__inner" style="align-items:flex-start;">
164
216
  <h2 class="font-sans font-700 tracking-tight">Buttons</h2>
165
- <div class="row">
166
- <button class="button font-sans font-400">Filled</button>
167
- <button class="button-outline font-sans font-400">Outline</button>
217
+
218
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;">Filled</p>
219
+ <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>
227
+ </div>
228
+
229
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:1.5rem;">Outline</p>
230
+ <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>
236
+ </div>
237
+ </div>
238
+ </section>
239
+
240
+ <!-- Cards -->
241
+ <section id="cards" class="pp-section pp-section--muted">
242
+ <div class="pp-section__inner" style="max-width:1100px;">
243
+ <h2 class="font-sans font-700 tracking-tight">Cards</h2>
244
+
245
+ <div class="pp-card-grid pp-card-grid--3">
246
+ <div class="pp-card">
247
+ <p class="pp-card__eyebrow">Framework</p>
248
+ <p class="pp-card__title">Clean by default</p>
249
+ <p class="pp-card__body">White background, subtle shadow, 16px radius. The base card — works for anything.</p>
250
+ <div class="pp-card__footer">
251
+ <button class="button font-sans font-400">Learn more</button>
252
+ </div>
253
+ </div>
254
+ <div class="pp-card pp-card--dark">
255
+ <p class="pp-card__eyebrow">Dark variant</p>
256
+ <p class="pp-card__title">Midnight surface</p>
257
+ <p class="pp-card__body">Deep neutral background with a primary-light eyebrow. Pairs well with dark sections.</p>
258
+ <div class="pp-card__footer">
259
+ <button class="button font-sans font-400">Learn more</button>
260
+ </div>
261
+ </div>
262
+ <div class="pp-card pp-card--gradient">
263
+ <p class="pp-card__eyebrow">Gradient variant</p>
264
+ <p class="pp-card__title">A little spice</p>
265
+ <p class="pp-card__body">The signature PeppertinoCSS gradient — warm gold to red. Use sparingly for emphasis.</p>
266
+ <div class="pp-card__footer">
267
+ <button class="button font-sans font-400" style="background:#fff;color:#ea5753;">Learn more</button>
268
+ </div>
269
+ </div>
270
+ </div>
271
+
272
+ <div class="pp-card-grid pp-card-grid--2" style="margin-top:1.5rem;">
273
+ <div class="pp-card pp-card--primary">
274
+ <p class="pp-card__eyebrow">Primary variant</p>
275
+ <p class="pp-card__title">Solid red card</p>
276
+ <p class="pp-card__body">Full primary background. Strong call-to-action surface — use for featured content.</p>
277
+ <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>
279
+ </div>
280
+ </div>
281
+ <div class="pp-card pp-card--ghost">
282
+ <p class="pp-card__eyebrow">Ghost variant</p>
283
+ <p class="pp-card__title">Transparent surface</p>
284
+ <p class="pp-card__body">No background, border only. Fills white and gains a shadow on hover. Great for secondary content.</p>
285
+ <div class="pp-card__footer">
286
+ <button class="button-outline font-sans font-400">Explore</button>
287
+ </div>
288
+ </div>
289
+ </div>
290
+ </div>
291
+ </section>
292
+
293
+ <!-- Carousel -->
294
+ <section id="carousel" class="pp-section">
295
+ <div class="pp-section__inner" style="max-width:860px;">
296
+ <h2 class="font-sans font-700 tracking-tight">Carousel</h2>
297
+
298
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;">Default — full width, with captions</p>
299
+
300
+ <div class="pp-carousel" id="carousel-default" data-label="Featured slides" style="margin-bottom:2rem;">
301
+ <div class="pp-carousel__track">
302
+ <div class="pp-carousel__slide" id="carousel-default-slide-0">
303
+ <div style="background:linear-gradient(135deg,#ffcf67,#ea5753);width:100%;height:360px;border-radius:16px;display:flex;align-items:flex-end;">
304
+ <div class="pp-carousel__caption">
305
+ <p class="pp-carousel__caption-title font-sans font-600">The signature gradient</p>
306
+ <p class="pp-carousel__caption-body font-sans font-400">Warm gold to spicy red — the PeppertinoCSS identity.</p>
307
+ </div>
308
+ </div>
309
+ </div>
310
+ <div class="pp-carousel__slide" id="carousel-default-slide-1">
311
+ <div style="background:linear-gradient(135deg,#18181b,#3f3f46);width:100%;height:360px;border-radius:16px;display:flex;align-items:flex-end;">
312
+ <div class="pp-carousel__caption">
313
+ <p class="pp-carousel__caption-title font-sans font-600">Midnight surface</p>
314
+ <p class="pp-carousel__caption-body font-sans font-400">Deep neutral tones for focused, editorial layouts.</p>
315
+ </div>
316
+ </div>
317
+ </div>
318
+ <div class="pp-carousel__slide" id="carousel-default-slide-2">
319
+ <div style="background:linear-gradient(135deg,#3b82f6,#6366f1);width:100%;height:360px;border-radius:16px;display:flex;align-items:flex-end;">
320
+ <div class="pp-carousel__caption">
321
+ <p class="pp-carousel__caption-title font-sans font-600">Cool contrast</p>
322
+ <p class="pp-carousel__caption-body font-sans font-400">A break from red — blue to indigo for variety.</p>
323
+ </div>
324
+ </div>
325
+ </div>
326
+ </div>
327
+
328
+ <!-- Prev / Next -->
329
+ <button class="pp-carousel__prev" type="button" aria-label="Previous slide">
330
+ <svg viewBox="0 0 24 24" aria-hidden="true"><polyline points="15 18 9 12 15 6"/></svg>
331
+ </button>
332
+ <button class="pp-carousel__next" type="button" aria-label="Next slide">
333
+ <svg viewBox="0 0 24 24" aria-hidden="true"><polyline points="9 6 15 12 9 18"/></svg>
334
+ </button>
335
+
336
+ <!-- Dots — plain div/button, no list role to avoid ownership conflicts -->
337
+ <div class="pp-carousel__dots" aria-label="Slide navigation">
338
+ <button class="pp-carousel__dot" type="button" aria-label="Go to slide 1" aria-controls="carousel-default-slide-0"></button>
339
+ <button class="pp-carousel__dot" type="button" aria-label="Go to slide 2" aria-controls="carousel-default-slide-1"></button>
340
+ <button class="pp-carousel__dot" type="button" aria-label="Go to slide 3" aria-controls="carousel-default-slide-2"></button>
341
+ </div>
342
+
343
+ <!-- Screen-reader live region -->
344
+ <div class="pp-carousel__announcer" aria-live="polite" aria-atomic="true"></div>
345
+ </div>
346
+
347
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:2rem;">Peek variant — partial next slide visible</p>
348
+
349
+ <div class="pp-carousel pp-carousel--peek-2" id="carousel-peek" data-label="Peek carousel" style="margin-bottom:2rem;">
350
+ <div class="pp-carousel__track" style="gap:1rem;padding:0 0.5rem;">
351
+ <div class="pp-carousel__slide" id="carousel-peek-slide-0">
352
+ <div style="background:#e90111;width:100%;height:240px;border-radius:16px;display:flex;align-items:center;justify-content:center;">
353
+ <span class="font-sans font-600 text-xl" style="color:#fff;">Slide 1</span>
354
+ </div>
355
+ </div>
356
+ <div class="pp-carousel__slide" id="carousel-peek-slide-1">
357
+ <div style="background:#f77f00;width:100%;height:240px;border-radius:16px;display:flex;align-items:center;justify-content:center;">
358
+ <span class="font-sans font-600 text-xl" style="color:#fff;">Slide 2</span>
359
+ </div>
360
+ </div>
361
+ <div class="pp-carousel__slide" id="carousel-peek-slide-2">
362
+ <div style="background:#18181b;width:100%;height:240px;border-radius:16px;display:flex;align-items:center;justify-content:center;">
363
+ <span class="font-sans font-600 text-xl" style="color:#fff;">Slide 3</span>
364
+ </div>
365
+ </div>
366
+ <div class="pp-carousel__slide" id="carousel-peek-slide-3">
367
+ <div style="background:linear-gradient(135deg,#ffcf67,#ea5753);width:100%;height:240px;border-radius:16px;display:flex;align-items:center;justify-content:center;">
368
+ <span class="font-sans font-600 text-xl" style="color:#fff;">Slide 4</span>
369
+ </div>
370
+ </div>
371
+ </div>
372
+
373
+ <button class="pp-carousel__prev" type="button" aria-label="Previous slide">
374
+ <svg viewBox="0 0 24 24" aria-hidden="true"><polyline points="15 18 9 12 15 6"/></svg>
375
+ </button>
376
+ <button class="pp-carousel__next" type="button" aria-label="Next slide">
377
+ <svg viewBox="0 0 24 24" aria-hidden="true"><polyline points="9 6 15 12 9 18"/></svg>
378
+ </button>
379
+
380
+ <div class="pp-carousel__dots" aria-label="Slide navigation">
381
+ <button class="pp-carousel__dot" type="button" aria-label="Go to slide 1" aria-controls="carousel-peek-slide-0"></button>
382
+ <button class="pp-carousel__dot" type="button" aria-label="Go to slide 2" aria-controls="carousel-peek-slide-1"></button>
383
+ <button class="pp-carousel__dot" type="button" aria-label="Go to slide 3" aria-controls="carousel-peek-slide-2"></button>
384
+ <button class="pp-carousel__dot" type="button" aria-label="Go to slide 4" aria-controls="carousel-peek-slide-3"></button>
385
+ </div>
386
+
387
+ <div class="pp-carousel__announcer" aria-live="polite" aria-atomic="true"></div>
388
+ </div>
389
+
390
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:2rem;">Dark variant</p>
391
+
392
+ <div class="pp-carousel pp-carousel--dark" id="carousel-dark" data-label="Dark carousel">
393
+ <div class="pp-carousel__track">
394
+ <div class="pp-carousel__slide" id="carousel-dark-slide-0">
395
+ <div style="background:#27272a;width:100%;height:280px;border-radius:16px;display:flex;flex-direction:column;align-items:center;justify-content:center;gap:0.5rem;">
396
+ <span class="font-sans font-700 text-3xl" style="color:#fff;">M4 Pro</span>
397
+ <span class="font-sans font-400 text-sm" style="color:#a1a1aa;">MacBook Pro 14"</span>
398
+ </div>
399
+ </div>
400
+ <div class="pp-carousel__slide" id="carousel-dark-slide-1">
401
+ <div style="background:#18181b;width:100%;height:280px;border-radius:16px;display:flex;flex-direction:column;align-items:center;justify-content:center;gap:0.5rem;">
402
+ <span class="font-sans font-700 text-3xl" style="color:#fff;">M4 Max</span>
403
+ <span class="font-sans font-400 text-sm" style="color:#a1a1aa;">MacBook Pro 16"</span>
404
+ </div>
405
+ </div>
406
+ <div class="pp-carousel__slide" id="carousel-dark-slide-2">
407
+ <div style="background:#0f0f10;width:100%;height:280px;border-radius:16px;display:flex;flex-direction:column;align-items:center;justify-content:center;gap:0.5rem;">
408
+ <span class="font-sans font-700 text-3xl" style="color:#fff;">M4 Ultra</span>
409
+ <span class="font-sans font-400 text-sm" style="color:#a1a1aa;">Mac Pro</span>
410
+ </div>
411
+ </div>
412
+ </div>
413
+
414
+ <button class="pp-carousel__prev" type="button" aria-label="Previous slide">
415
+ <svg viewBox="0 0 24 24" aria-hidden="true"><polyline points="15 18 9 12 15 6"/></svg>
416
+ </button>
417
+ <button class="pp-carousel__next" type="button" aria-label="Next slide">
418
+ <svg viewBox="0 0 24 24" aria-hidden="true"><polyline points="9 6 15 12 9 18"/></svg>
419
+ </button>
420
+
421
+ <div class="pp-carousel__dots" aria-label="Slide navigation">
422
+ <button class="pp-carousel__dot" type="button" aria-label="Go to slide 1" aria-controls="carousel-dark-slide-0"></button>
423
+ <button class="pp-carousel__dot" type="button" aria-label="Go to slide 2" aria-controls="carousel-dark-slide-1"></button>
424
+ <button class="pp-carousel__dot" type="button" aria-label="Go to slide 3" aria-controls="carousel-dark-slide-2"></button>
425
+ </div>
426
+
427
+ <div class="pp-carousel__announcer" aria-live="polite" aria-atomic="true"></div>
168
428
  </div>
169
429
  </div>
170
430
  </section>
@@ -178,6 +438,170 @@ const greet = (name) =&gt; `Hello, ${name}!`;</code></pre>
178
438
  </div>
179
439
  </section>
180
440
 
441
+ <!-- Modals -->
442
+ <section id="modals" class="pp-section pp-section--dark">
443
+ <div class="pp-section__inner">
444
+ <h2 class="font-sans font-700 tracking-tight" style="color:#fff;">Modals</h2>
445
+ <p class="font-sans font-400 text-sm" style="color:rgba(255,255,255,0.6);">Glassmorphic backdrop blur with frosted container.</p>
446
+ <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>
450
+ </div>
451
+ </div>
452
+ </section>
453
+
454
+ <!-- Modal: basic -->
455
+ <div id="modal-basic" class="pp-modal-backdrop" role="dialog" aria-modal="true" aria-labelledby="modal-basic-title" aria-describedby="modal-basic-desc" aria-hidden="true">
456
+ <div class="pp-modal">
457
+ <button class="pp-modal__close font-sans" data-modal-close="modal-basic" aria-label="Close">✕</button>
458
+ <p class="pp-modal__title font-sans" id="modal-basic-title">Action Title</p>
459
+ <p class="pp-modal__description font-sans" id="modal-basic-desc">A short description of the action you are about to take.</p>
460
+ <ul class="pp-modal__actions">
461
+ <li><button class="pp-modal__action font-sans">Action 1</button></li>
462
+ <li><button class="pp-modal__action font-sans">Action 2</button></li>
463
+ <li><button class="pp-modal__action font-sans">Action 3</button></li>
464
+ <li><button class="pp-modal__action pp-modal__action--cancel font-sans" data-modal-close="modal-basic">Cancel</button></li>
465
+ </ul>
466
+ </div>
467
+ </div>
468
+
469
+ <!-- Modal: destructive -->
470
+ <div id="modal-destructive" class="pp-modal-backdrop" role="dialog" aria-modal="true" aria-labelledby="modal-destructive-title" aria-describedby="modal-destructive-desc" aria-hidden="true">
471
+ <div class="pp-modal">
472
+ <button class="pp-modal__close font-sans" data-modal-close="modal-destructive" aria-label="Close">✕</button>
473
+ <p class="pp-modal__title font-sans" id="modal-destructive-title">Delete Item</p>
474
+ <p class="pp-modal__description font-sans" id="modal-destructive-desc">This action cannot be undone. The item will be permanently removed.</p>
475
+ <ul class="pp-modal__actions">
476
+ <li><button class="pp-modal__action pp-modal__action--destructive font-sans">Delete permanently</button></li>
477
+ <li><button class="pp-modal__action pp-modal__action--cancel font-sans" data-modal-close="modal-destructive">Cancel</button></li>
478
+ </ul>
479
+ </div>
480
+ </div>
481
+
482
+ <!-- Modal: confirm -->
483
+ <div id="modal-confirm" class="pp-modal-backdrop" role="dialog" aria-modal="true" aria-labelledby="modal-confirm-title" aria-describedby="modal-confirm-desc" aria-hidden="true">
484
+ <div class="pp-modal">
485
+ <button class="pp-modal__close font-sans" data-modal-close="modal-confirm" aria-label="Close">✕</button>
486
+ <p class="pp-modal__title font-sans" id="modal-confirm-title">Confirm Changes</p>
487
+ <p class="pp-modal__description font-sans" id="modal-confirm-desc">Save and publish your changes? They will be visible immediately.</p>
488
+ <ul class="pp-modal__actions">
489
+ <li><button class="pp-modal__action font-sans">Save &amp; Publish</button></li>
490
+ <li><button class="pp-modal__action font-sans">Save as Draft</button></li>
491
+ <li><button class="pp-modal__action pp-modal__action--cancel font-sans" data-modal-close="modal-confirm">Discard</button></li>
492
+ </ul>
493
+ </div>
494
+ </div>
495
+
496
+ <!-- Selects -->
497
+ <section id="selects" class="pp-section">
498
+ <div class="pp-section__inner text-left" style="align-items:flex-start;max-width:560px;">
499
+ <h2 class="font-sans font-700 tracking-tight">Selects</h2>
500
+
501
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;">Native &lt;select&gt;</p>
502
+ <select>
503
+ <option value="">Choose a framework</option>
504
+ <option value="peppertino">PeppertinoCSS</option>
505
+ <option value="tailwind">Tailwind</option>
506
+ <option value="bootstrap">Bootstrap</option>
507
+ </select>
508
+
509
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:2rem;">Custom .pp-select</p>
510
+ <div class="pp-select">
511
+ <button class="pp-select__trigger font-sans" type="button" aria-label="Choose a color">
512
+ <span class="pp-select__value">Choose a color</span>
513
+ <span class="pp-select__chevron"></span>
514
+ </button>
515
+ <ul class="pp-select__panel" role="listbox">
516
+ <li role="option"><button class="pp-select__option font-sans" data-value="primary">Primary Red</button></li>
517
+ <li role="option"><button class="pp-select__option font-sans" data-value="gradient-start">Gradient Gold</button></li>
518
+ <li role="option"><button class="pp-select__option font-sans" data-value="gradient-end">Gradient Red</button></li>
519
+ <li role="separator" class="pp-select__divider"></li>
520
+ <li role="group" aria-label="Neutrals" style="list-style:none;">
521
+ <span class="pp-select__group-label font-sans">Neutrals</span>
522
+ <ul role="group" style="list-style:none;padding:0;margin:0;">
523
+ <li role="option"><button class="pp-select__option font-sans" data-value="light">Light</button></li>
524
+ <li role="option" aria-selected="true"><button class="pp-select__option font-sans is-selected" data-value="dark">Dark</button></li>
525
+ </ul>
526
+ </li>
527
+ </ul>
528
+ </div>
529
+
530
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:2rem;">Sizes</p>
531
+ <div class="pp-select pp-select--sm" style="margin-bottom:1rem;">
532
+ <button class="pp-select__trigger font-sans" type="button" aria-label="Small">
533
+ <span class="pp-select__value">Small</span>
534
+ <span class="pp-select__chevron"></span>
535
+ </button>
536
+ <ul class="pp-select__panel" role="listbox">
537
+ <li role="option"><button class="pp-select__option font-sans">Option A</button></li>
538
+ <li role="option"><button class="pp-select__option font-sans">Option B</button></li>
539
+ </ul>
540
+ </div>
541
+ <div class="pp-select pp-select--lg">
542
+ <button class="pp-select__trigger font-sans" type="button" aria-label="Large">
543
+ <span class="pp-select__value">Large</span>
544
+ <span class="pp-select__chevron"></span>
545
+ </button>
546
+ <ul class="pp-select__panel" role="listbox">
547
+ <li role="option"><button class="pp-select__option font-sans">Option A</button></li>
548
+ <li role="option"><button class="pp-select__option font-sans">Option B</button></li>
549
+ </ul>
550
+ </div>
551
+ </div>
552
+ </section>
553
+
554
+ <!-- Tabs -->
555
+ <section id="tabs" class="pp-section pp-section--dark">
556
+ <div class="pp-section__inner">
557
+ <h2 class="font-sans font-700 tracking-tight" style="color:#fff;">Tabs</h2>
558
+
559
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:rgba(255,255,255,0.6);">Normal (filled primary)</p>
560
+ <div class="pp-tabs" role="tablist">
561
+ <button class="pp-tabs__item is-active font-sans" role="tab" aria-selected="true"><i data-lucide="home"></i>Home</button>
562
+ <button class="pp-tabs__item font-sans" role="tab" aria-selected="false"><i data-lucide="star"></i>Starred</button>
563
+ <button class="pp-tabs__item font-sans" role="tab" aria-selected="false"><i data-lucide="settings"></i>Settings</button>
564
+ <button class="pp-tabs__item font-sans" role="tab" aria-selected="false"><i data-lucide="user"></i>Profile</button>
565
+ </div>
566
+
567
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:rgba(255,255,255,0.6);margin-top:2rem;">Outline</p>
568
+ <div class="pp-tabs pp-tabs--outline" role="tablist">
569
+ <button class="pp-tabs__item is-active font-sans" role="tab" aria-selected="true"><i data-lucide="home"></i>Home</button>
570
+ <button class="pp-tabs__item font-sans" role="tab" aria-selected="false"><i data-lucide="star"></i>Starred</button>
571
+ <button class="pp-tabs__item font-sans" role="tab" aria-selected="false"><i data-lucide="settings"></i>Settings</button>
572
+ <button class="pp-tabs__item font-sans" role="tab" aria-selected="false"><i data-lucide="user"></i>Profile</button>
573
+ </div>
574
+
575
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:rgba(255,255,255,0.6);margin-top:2rem;">Gradient</p>
576
+ <div class="pp-tabs pp-tabs--gradient" role="tablist">
577
+ <button class="pp-tabs__item is-active font-sans" role="tab" aria-selected="true"><i data-lucide="zap"></i>Speed</button>
578
+ <button class="pp-tabs__item font-sans" role="tab" aria-selected="false"><i data-lucide="shield"></i>Security</button>
579
+ <button class="pp-tabs__item font-sans" role="tab" aria-selected="false"><i data-lucide="layers"></i>Design</button>
580
+ <button class="pp-tabs__item font-sans" role="tab" aria-selected="false"><i data-lucide="cpu"></i>System</button>
581
+ </div>
582
+
583
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:rgba(255,255,255,0.6);margin-top:2rem;">Gradient Outline</p>
584
+ <div class="pp-tabs pp-tabs--gradient-outline" role="tablist">
585
+ <button class="pp-tabs__item is-active font-sans" role="tab" aria-selected="true"><i data-lucide="zap"></i>Speed</button>
586
+ <button class="pp-tabs__item font-sans" role="tab" aria-selected="false"><i data-lucide="shield"></i>Security</button>
587
+ <button class="pp-tabs__item font-sans" role="tab" aria-selected="false"><i data-lucide="layers"></i>Design</button>
588
+ <button class="pp-tabs__item font-sans" role="tab" aria-selected="false"><i data-lucide="cpu"></i>System</button>
589
+ </div>
590
+
591
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:rgba(255,255,255,0.6);margin-top:2rem;">Sizes — sm / lg</p>
592
+ <div class="pp-tabs pp-tabs--sm" role="tablist" style="margin-bottom:1rem;">
593
+ <button class="pp-tabs__item is-active font-sans" role="tab" aria-selected="true"><i data-lucide="home"></i>Home</button>
594
+ <button class="pp-tabs__item font-sans" role="tab" aria-selected="false"><i data-lucide="search"></i>Search</button>
595
+ <button class="pp-tabs__item font-sans" role="tab" aria-selected="false"><i data-lucide="bell"></i>Alerts</button>
596
+ </div>
597
+ <div class="pp-tabs pp-tabs--lg" role="tablist">
598
+ <button class="pp-tabs__item is-active font-sans" role="tab" aria-selected="true"><i data-lucide="home"></i>Home</button>
599
+ <button class="pp-tabs__item font-sans" role="tab" aria-selected="false"><i data-lucide="search"></i>Search</button>
600
+ <button class="pp-tabs__item font-sans" role="tab" aria-selected="false"><i data-lucide="bell"></i>Alerts</button>
601
+ </div>
602
+ </div>
603
+ </section>
604
+
181
605
  <!-- Tables -->
182
606
  <section id="tables" class="pp-section">
183
607
  <div class="pp-section__inner text-left" style="align-items:flex-start;max-width:1100px;">
@@ -214,5 +638,696 @@ const greet = (name) =&gt; `Hello, ${name}!`;</code></pre>
214
638
  </div>
215
639
  </section>
216
640
 
641
+ <!-- Forms -->
642
+ <section id="forms" class="pp-section">
643
+ <div class="pp-section__inner text-left" style="align-items:flex-start;max-width:860px;">
644
+ <h2 class="font-sans font-700 tracking-tight">Forms</h2>
645
+ <p class="font-sans font-400 text-sm" style="color:#71717a;">Apple HIG-aligned form components. WCAG AA contrast on all tiers. Full ARIA labelling.</p>
646
+
647
+ <!-- ── Fieldset & Legend ──────────────────────────────────────────────── -->
648
+ <h3 id="form-fieldset" class="font-sans font-600 text-xl" style="margin-top:1rem;">Fieldset &amp; Legend</h3>
649
+ <p class="font-sans font-400 text-sm" style="color:#71717a;max-width:600px;">
650
+ Groups related controls under a named legend. Native <code class="font-mono">&lt;fieldset&gt;</code> + <code class="font-mono">&lt;legend&gt;</code> gives screen readers automatic group context before announcing each child control.
651
+ </p>
652
+
653
+ <!-- Default -->
654
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:1.5rem;">Default</p>
655
+ <fieldset class="pp-fieldset">
656
+ <legend>Notification preferences</legend>
657
+ <p class="pp-label pp-label--body">Choose how you'd like to be notified about activity.</p>
658
+ <p class="pp-label pp-label--secondary pp-label--callout">Settings can be changed at any time from your account.</p>
659
+ </fieldset>
660
+
661
+ <!-- Ghost -->
662
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:2rem;">Ghost</p>
663
+ <fieldset class="pp-fieldset pp-fieldset--ghost">
664
+ <legend>Appearance</legend>
665
+ <p class="pp-label pp-label--body">Controls how the interface looks across all your devices.</p>
666
+ <p class="pp-label pp-label--tertiary pp-label--callout">Requires app restart to take full effect.</p>
667
+ </fieldset>
668
+
669
+ <!-- Filled -->
670
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:2rem;">Filled</p>
671
+ <fieldset class="pp-fieldset pp-fieldset--filled">
672
+ <legend>Privacy</legend>
673
+ <p class="pp-label pp-label--body">Manage how your data is collected and used.</p>
674
+ <p class="pp-label pp-label--secondary pp-label--callout">Review our privacy policy for full details.</p>
675
+ </fieldset>
676
+
677
+ <!-- Primary -->
678
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:2rem;">Primary</p>
679
+ <fieldset class="pp-fieldset pp-fieldset--primary">
680
+ <legend>Account details</legend>
681
+ <p class="pp-label pp-label--body">Your personal information is used to personalise your experience.</p>
682
+ </fieldset>
683
+
684
+ <!-- Error -->
685
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:2rem;">Error</p>
686
+ <fieldset class="pp-fieldset pp-fieldset--error">
687
+ <legend>Payment information</legend>
688
+ <p class="pp-label pp-label--body">One or more fields contain errors. Please review and try again.</p>
689
+ </fieldset>
690
+
691
+ <!-- Disabled -->
692
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:2rem;">Disabled</p>
693
+ <fieldset class="pp-fieldset" disabled aria-disabled="true">
694
+ <legend>Billing address</legend>
695
+ <p class="pp-label pp-label--body">Billing address is locked to your verified payment method.</p>
696
+ </fieldset>
697
+
698
+ <!-- Legend sizes -->
699
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:2rem;">Legend sizes</p>
700
+ <div style="display:flex;flex-direction:column;gap:1rem;">
701
+ <fieldset class="pp-fieldset pp-fieldset--ghost">
702
+ <legend class="pp-legend pp-legend--sm">Small legend</legend>
703
+ <p class="pp-label pp-label--callout">Compact group heading for dense layouts.</p>
704
+ </fieldset>
705
+ <fieldset class="pp-fieldset pp-fieldset--ghost">
706
+ <legend>Default legend</legend>
707
+ <p class="pp-label pp-label--body">Standard group heading.</p>
708
+ </fieldset>
709
+ <fieldset class="pp-fieldset pp-fieldset--ghost">
710
+ <legend class="pp-legend pp-legend--lg">Large legend</legend>
711
+ <p class="pp-label pp-label--body">Prominent group heading for top-level sections.</p>
712
+ </fieldset>
713
+ </div>
714
+
715
+ <!-- Inline legend with icon -->
716
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:2rem;">Inline legend with icon</p>
717
+ <fieldset class="pp-fieldset">
718
+ <legend class="pp-legend pp-legend--inline">
719
+ <i data-lucide="shield" aria-hidden="true"></i>
720
+ Security settings
721
+ </legend>
722
+ <p class="pp-label pp-label--body">Two-factor authentication and session management.</p>
723
+ <p class="pp-label pp-label--secondary pp-label--callout">Last updated 3 days ago.</p>
724
+ </fieldset>
725
+
726
+ <!-- Usage table -->
727
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:2rem;">Usage</p>
728
+ <table class="pp-table pp-table--cols-2" style="width:100%;">
729
+ <thead>
730
+ <tr><th class="font-sans font-600">Class</th><th class="font-sans font-600">What it does</th></tr>
731
+ </thead>
732
+ <tbody>
733
+ <tr><td><code class="font-mono">.pp-fieldset</code></td><td>Base group — white bg, border, 12px radius</td></tr>
734
+ <tr><td><code class="font-mono">.pp-fieldset--ghost</code></td><td>Transparent border, neutral-50 background</td></tr>
735
+ <tr><td><code class="font-mono">.pp-fieldset--filled</code></td><td>Neutral-100 tinted surface</td></tr>
736
+ <tr><td><code class="font-mono">.pp-fieldset--primary</code></td><td>Primary accent border + glow</td></tr>
737
+ <tr><td><code class="font-mono">.pp-fieldset--error</code></td><td>Error border + glow, legend turns red</td></tr>
738
+ <tr><td><code class="font-mono">disabled / aria-disabled</code></td><td>Mutes entire group, blocks interaction</td></tr>
739
+ <tr><td><code class="font-mono">.pp-legend--sm</code></td><td>Compact legend — xs, uppercase</td></tr>
740
+ <tr><td><code class="font-mono">.pp-legend--lg</code></td><td>Large legend — base size, bold, no uppercase</td></tr>
741
+ <tr><td><code class="font-mono">.pp-legend--inline</code></td><td>Flex row for icon + legend text pairing</td></tr>
742
+ </tbody>
743
+ </table>
744
+
745
+ <!-- ── Form Instructions ──────────────────────────────────────────────── -->
746
+ <h3 id="form-instructions" class="font-sans font-600 text-xl" style="margin-top:2rem;">Form Instructions</h3>
747
+ <p class="font-sans font-400 text-sm" style="color:#71717a;max-width:600px;">
748
+ Place overall instructions <strong>before</strong> the <code class="font-mono">&lt;form&gt;</code> element so screen readers announce them before switching to Forms Mode. Field-level hints use <code class="font-mono">aria-describedby</code> and stay inside the form.
749
+ </p>
750
+
751
+ <!-- Pre-form instructions — default -->
752
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:1.5rem;">Default (primary)</p>
753
+ <div class="pp-form-instructions" role="note" aria-label="Form completion instructions">
754
+ <p class="pp-form-instructions__title">Before you begin</p>
755
+ <ul class="pp-form-instructions__list">
756
+ <li class="pp-form-instructions__item">Fields marked <abbr aria-label="required" title="required">*</abbr> are required.</li>
757
+ <li class="pp-form-instructions__item">Dates must be entered as <code class="font-mono">DD/MM/YYYY</code>.</li>
758
+ <li class="pp-form-instructions__item">Passwords must be at least 8 characters.</li>
759
+ <li class="pp-form-instructions__item">Extra guidance appears directly below each field.</li>
760
+ </ul>
761
+ </div>
762
+
763
+ <!-- Neutral -->
764
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:2rem;">Neutral</p>
765
+ <div class="pp-form-instructions pp-form-instructions--neutral" role="note" aria-label="Form information">
766
+ <p class="pp-form-instructions__title">Information</p>
767
+ <ul class="pp-form-instructions__list">
768
+ <li class="pp-form-instructions__item">All changes are saved automatically.</li>
769
+ <li class="pp-form-instructions__item">You can return to this form at any time.</li>
770
+ </ul>
771
+ </div>
772
+
773
+ <!-- Warning -->
774
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:2rem;">Warning</p>
775
+ <div class="pp-form-instructions pp-form-instructions--warning" role="note" aria-label="Form warning">
776
+ <p class="pp-form-instructions__title">Review carefully</p>
777
+ <ul class="pp-form-instructions__list">
778
+ <li class="pp-form-instructions__item">Submitted details cannot be edited for 30 days.</li>
779
+ <li class="pp-form-instructions__item">Ensure your contact information is correct before submitting.</li>
780
+ </ul>
781
+ </div>
782
+
783
+ <!-- Error -->
784
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:2rem;">Error</p>
785
+ <div class="pp-form-instructions pp-form-instructions--error" role="alert" aria-label="Form errors">
786
+ <p class="pp-form-instructions__title">Please fix the following errors</p>
787
+ <ul class="pp-form-instructions__list">
788
+ <li class="pp-form-instructions__item">Email address is not valid.</li>
789
+ <li class="pp-form-instructions__item">Password must contain at least one number.</li>
790
+ </ul>
791
+ </div>
792
+
793
+ <!-- In-form hint + required note -->
794
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:2rem;">In-form hint &amp; required note</p>
795
+ <p class="pp-form-required-note font-sans">
796
+ Fields marked <abbr aria-label="required" title="required">*</abbr> are required.
797
+ </p>
798
+ <p class="pp-form-hint">
799
+ <i data-lucide="info" aria-hidden="true"></i>
800
+ Your data is encrypted in transit and never shared with third parties.
801
+ </p>
802
+
803
+ <!-- Usage table -->
804
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:2rem;">Usage</p>
805
+ <table class="pp-table pp-table--cols-2" style="width:100%;">
806
+ <thead>
807
+ <tr><th class="font-sans font-600">Class</th><th class="font-sans font-600">What it does</th></tr>
808
+ </thead>
809
+ <tbody>
810
+ <tr><td><code class="font-mono">.pp-form-instructions</code></td><td>Pre-form block with left accent border — place before <code class="font-mono">&lt;form&gt;</code></td></tr>
811
+ <tr><td><code class="font-mono">role="note"</code></td><td>Marks block as supplemental info for AT</td></tr>
812
+ <tr><td><code class="font-mono">role="alert"</code></td><td>Use instead of note for error summaries — announced immediately</td></tr>
813
+ <tr><td><code class="font-mono">.pp-form-instructions--neutral</code></td><td>Grey border, neutral background</td></tr>
814
+ <tr><td><code class="font-mono">.pp-form-instructions--warning</code></td><td>Amber border, amber text</td></tr>
815
+ <tr><td><code class="font-mono">.pp-form-instructions--error</code></td><td>Red border, primary-dark text</td></tr>
816
+ <tr><td><code class="font-mono">.pp-form-required-note</code></td><td>Small "* = required" line</td></tr>
817
+ <tr><td><code class="font-mono">.pp-form-hint</code></td><td>Inline contextual note inside the form</td></tr>
818
+ </tbody>
819
+ </table>
820
+
821
+ <!-- ── Label ─────────────────────────────────────────────────────────── -->
822
+ <h3 id="form-label" class="font-sans font-600 text-xl" style="margin-top:2rem;">Label</h3>
823
+ <p class="font-sans font-400 text-sm" style="color:#71717a;max-width:600px;">
824
+ Static, uneditable text. Four semantic tiers mirror Apple's <code class="font-mono">label</code>, <code class="font-mono">secondaryLabel</code>, <code class="font-mono">tertiaryLabel</code>, and <code class="font-mono">quaternaryLabel</code> system colors.
825
+ </p>
826
+
827
+ <!-- Importance tiers -->
828
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:1.5rem;">Importance tiers</p>
829
+ <div style="display:flex;flex-direction:column;gap:0.5rem;">
830
+ <span class="pp-label pp-label--primary">Primary label — main readable content</span>
831
+ <span class="pp-label pp-label--secondary">Secondary label — subheading or supplemental text</span>
832
+ <span class="pp-label pp-label--tertiary">Tertiary label — unavailable item or hint text</span>
833
+ <span class="pp-label pp-label--quaternary">Quaternary label — watermark or placeholder copy</span>
834
+ </div>
835
+
836
+ <!-- Dynamic type scale -->
837
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:2rem;">Dynamic Type scale</p>
838
+ <div style="display:flex;flex-direction:column;gap:0.5rem;">
839
+ <span class="pp-label pp-label--headline">Headline — semibold 20px</span>
840
+ <span class="pp-label pp-label--subheadline">Subheadline — medium 16px</span>
841
+ <span class="pp-label pp-label--body">Body — regular 16px</span>
842
+ <span class="pp-label pp-label--callout">Callout — regular 14px</span>
843
+ <span class="pp-label pp-label--footnote">Footnote — regular 12px</span>
844
+ <span class="pp-label pp-label--caption">Caption — medium 12px uppercase</span>
845
+ </div>
846
+
847
+ <!-- Tiers × scale cross-reference -->
848
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:2rem;">Tiers × scale</p>
849
+ <div style="display:flex;flex-direction:column;gap:0.35rem;">
850
+ <span class="pp-label pp-label--headline pp-label--primary">Headline / Primary</span>
851
+ <span class="pp-label pp-label--subheadline pp-label--secondary">Subheadline / Secondary</span>
852
+ <span class="pp-label pp-label--callout pp-label--tertiary">Callout / Tertiary</span>
853
+ <span class="pp-label pp-label--caption pp-label--quaternary">Caption / Quaternary</span>
854
+ </div>
855
+
856
+ <!-- Selectable -->
857
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:2rem;">Selectable — <span style="text-transform:none;letter-spacing:0;" class="font-400">try highlighting this text</span></p>
858
+ <span class="pp-label pp-label--selectable">192.168.1.1 — IP addresses, error messages, and codes should be selectable.</span>
859
+
860
+ <!-- Truncation -->
861
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:2rem;">Truncation</p>
862
+ <span class="pp-label pp-label--truncate" style="max-width:320px;">This label is far too long to fit in the available space and will be truncated with an ellipsis at the end.</span>
863
+
864
+ <!-- Icon + label row -->
865
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:2rem;">Icon + label row</p>
866
+ <div style="display:flex;flex-direction:column;gap:0.5rem;">
867
+ <span class="pp-label-row pp-label">
868
+ <i data-lucide="wifi" aria-hidden="true"></i>
869
+ Wi-Fi Connected
870
+ </span>
871
+ <span class="pp-label-row pp-label pp-label--secondary pp-label--callout">
872
+ <i data-lucide="battery-charging" aria-hidden="true"></i>
873
+ Charging — 84%
874
+ </span>
875
+ <span class="pp-label-row pp-label pp-label--tertiary pp-label--callout">
876
+ <i data-lucide="bluetooth" aria-hidden="true"></i>
877
+ Bluetooth unavailable
878
+ </span>
879
+ </div>
880
+
881
+ <!-- Usage table -->
882
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:2rem;">Usage</p>
883
+ <table class="pp-table pp-table--cols-2" style="width:100%;">
884
+ <thead>
885
+ <tr><th class="font-sans font-600">Class</th><th class="font-sans font-600">What it does</th></tr>
886
+ </thead>
887
+ <tbody>
888
+ <tr><td><code class="font-mono">.pp-label</code></td><td>Base — primary color, body size, no user-select</td></tr>
889
+ <tr><td><code class="font-mono">.pp-label--primary</code></td><td>Full-opacity text (default)</td></tr>
890
+ <tr><td><code class="font-mono">.pp-label--secondary</code></td><td>Reduced-opacity supplemental text</td></tr>
891
+ <tr><td><code class="font-mono">.pp-label--tertiary</code></td><td>Muted hint / unavailable state text</td></tr>
892
+ <tr><td><code class="font-mono">.pp-label--quaternary</code></td><td>Watermark / decorative text</td></tr>
893
+ <tr><td><code class="font-mono">.pp-label--headline</code></td><td>Semibold 20px, tight tracking</td></tr>
894
+ <tr><td><code class="font-mono">.pp-label--subheadline</code></td><td>Medium 16px</td></tr>
895
+ <tr><td><code class="font-mono">.pp-label--body</code></td><td>Regular 16px (default size)</td></tr>
896
+ <tr><td><code class="font-mono">.pp-label--callout</code></td><td>Regular 14px</td></tr>
897
+ <tr><td><code class="font-mono">.pp-label--footnote</code></td><td>Regular 12px</td></tr>
898
+ <tr><td><code class="font-mono">.pp-label--caption</code></td><td>Medium 12px uppercase</td></tr>
899
+ <tr><td><code class="font-mono">.pp-label--selectable</code></td><td>Enables text selection + text cursor</td></tr>
900
+ <tr><td><code class="font-mono">.pp-label--truncate</code></td><td>Single-line ellipsis overflow</td></tr>
901
+ <tr><td><code class="font-mono">.pp-label-row</code></td><td>Flex row for icon + label pairing</td></tr>
902
+ </tbody>
903
+ </table>
904
+
905
+ <!-- ── Text Field ──────────────────────────────────────────────────────── -->
906
+ <h3 id="form-text-field" class="font-sans font-600 text-xl" style="margin-top:2rem;">Text Field</h3>
907
+ <p class="font-sans font-400 text-sm" style="color:#71717a;max-width:600px;">
908
+ Labelled <code class="font-mono">&lt;input&gt;</code> or <code class="font-mono">&lt;textarea&gt;</code> with hint text via <code class="font-mono">aria-describedby</code>, required/optional markers, placeholder, validation states, and icon slots.
909
+ </p>
910
+
911
+ <!-- Basic -->
912
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:1.5rem;">Basic</p>
913
+ <div class="pp-field" style="max-width:480px;">
914
+ <label class="pp-field__label" for="tf-basic">Full name</label>
915
+ <input class="pp-field__input" type="text" id="tf-basic" name="tf-basic" placeholder="e.g. Ada Lovelace" autocomplete="name" />
916
+ </div>
917
+
918
+ <!-- With hint -->
919
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:2rem;">With hint text</p>
920
+ <div class="pp-field" style="max-width:480px;">
921
+ <label class="pp-field__label" for="tf-email">Email address</label>
922
+ <input class="pp-field__input" type="email" id="tf-email" name="tf-email" placeholder="you@example.com" autocomplete="email" aria-describedby="tf-email-hint" />
923
+ <span class="pp-field__hint" id="tf-email-hint">We'll only use this to send account notifications.</span>
924
+ </div>
925
+
926
+ <!-- Required -->
927
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:2rem;">Required field</p>
928
+ <div class="pp-field" style="max-width:480px;">
929
+ <label class="pp-field__label" for="tf-required">
930
+ Password
931
+ <abbr class="pp-field__required" aria-label="required" title="required"></abbr>
932
+ </label>
933
+ <input class="pp-field__input" type="password" id="tf-required" name="tf-required" required aria-required="true" aria-describedby="tf-required-hint" />
934
+ <span class="pp-field__hint" id="tf-required-hint">At least 8 characters including a number.</span>
935
+ </div>
936
+
937
+ <!-- Optional -->
938
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:2rem;">Optional field</p>
939
+ <div class="pp-field" style="max-width:480px;">
940
+ <label class="pp-field__label" for="tf-optional">
941
+ Company
942
+ <span class="pp-field__optional">optional</span>
943
+ </label>
944
+ <input class="pp-field__input" type="text" id="tf-optional" name="tf-optional" placeholder="Your organisation" autocomplete="organization" />
945
+ </div>
946
+
947
+ <!-- With leading icon -->
948
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:2rem;">With icon</p>
949
+ <div class="pp-field" style="max-width:480px;">
950
+ <label class="pp-field__label" for="tf-search">Search</label>
951
+ <div class="pp-field__input-wrap">
952
+ <span class="pp-field__icon" aria-hidden="true"><i data-lucide="search"></i></span>
953
+ <input class="pp-field__input" type="search" id="tf-search" name="tf-search" placeholder="Search components…" />
954
+ </div>
955
+ </div>
956
+
957
+ <!-- Validation — error -->
958
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:2rem;">Error state</p>
959
+ <div class="pp-field pp-field--error" style="max-width:480px;">
960
+ <label class="pp-field__label" for="tf-error">
961
+ Expiry date
962
+ <abbr class="pp-field__required" aria-label="required" title="required"></abbr>
963
+ </label>
964
+ <input class="pp-field__input" type="text" id="tf-error" name="tf-error" value="13/50" aria-invalid="true" aria-describedby="tf-error-msg tf-error-hint" />
965
+ <span class="pp-field__hint" id="tf-error-hint">Enter as MM/YYYY.</span>
966
+ <span class="pp-field__message" id="tf-error-msg" role="alert">
967
+ <i data-lucide="circle-x" aria-hidden="true"></i>
968
+ That date is invalid. Please use the format MM/YYYY.
969
+ </span>
970
+ </div>
971
+
972
+ <!-- Validation — success -->
973
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:2rem;">Success state</p>
974
+ <div class="pp-field pp-field--success" style="max-width:480px;">
975
+ <label class="pp-field__label" for="tf-success">Username</label>
976
+ <input class="pp-field__input" type="text" id="tf-success" name="tf-success" value="ada_lovelace" aria-describedby="tf-success-msg" />
977
+ <span class="pp-field__message" id="tf-success-msg">
978
+ <i data-lucide="circle-check" aria-hidden="true"></i>
979
+ Username is available.
980
+ </span>
981
+ </div>
982
+
983
+ <!-- Validation — warning -->
984
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:2rem;">Warning state</p>
985
+ <div class="pp-field pp-field--warning" style="max-width:480px;">
986
+ <label class="pp-field__label" for="tf-warning">Bio</label>
987
+ <textarea class="pp-field__textarea" id="tf-warning" name="tf-warning" rows="3" aria-describedby="tf-warning-msg tf-warning-count">This is my bio and it is getting close to the character limit now.</textarea>
988
+ <div style="display:flex;justify-content:space-between;align-items:center;">
989
+ <span class="pp-field__message" id="tf-warning-msg">
990
+ <i data-lucide="triangle-alert" aria-hidden="true"></i>
991
+ Approaching the 100-character limit.
992
+ </span>
993
+ <span class="pp-field__count pp-field__count--warn" id="tf-warning-count" aria-live="polite">67 / 100</span>
994
+ </div>
995
+ </div>
996
+
997
+ <!-- Disabled / Readonly -->
998
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:2rem;">Disabled &amp; readonly</p>
999
+ <div style="display:flex;flex-direction:column;gap:1rem;max-width:480px;">
1000
+ <div class="pp-field">
1001
+ <label class="pp-field__label" for="tf-disabled">Disabled</label>
1002
+ <input class="pp-field__input" type="text" id="tf-disabled" name="tf-disabled" value="Cannot be changed" disabled aria-disabled="true" />
1003
+ </div>
1004
+ <div class="pp-field">
1005
+ <label class="pp-field__label" for="tf-readonly">Read-only</label>
1006
+ <input class="pp-field__input" type="text" id="tf-readonly" name="tf-readonly" value="user@example.com" readonly aria-readonly="true" />
1007
+ </div>
1008
+ </div>
1009
+
1010
+ <!-- Sizes -->
1011
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:2rem;">Sizes</p>
1012
+ <div style="display:flex;flex-direction:column;gap:1rem;max-width:480px;">
1013
+ <div class="pp-field pp-field--sm">
1014
+ <label class="pp-field__label" for="tf-sm">Small</label>
1015
+ <input class="pp-field__input" type="text" id="tf-sm" name="tf-sm" placeholder="Small input" />
1016
+ </div>
1017
+ <div class="pp-field">
1018
+ <label class="pp-field__label" for="tf-md">Default</label>
1019
+ <input class="pp-field__input" type="text" id="tf-md" name="tf-md" placeholder="Default input" />
1020
+ </div>
1021
+ <div class="pp-field pp-field--lg">
1022
+ <label class="pp-field__label" for="tf-lg">Large</label>
1023
+ <input class="pp-field__input" type="text" id="tf-lg" name="tf-lg" placeholder="Large input" />
1024
+ </div>
1025
+ </div>
1026
+
1027
+ <!-- Usage table -->
1028
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:2rem;">Usage</p>
1029
+ <table class="pp-table pp-table--cols-2" style="width:100%;">
1030
+ <thead>
1031
+ <tr><th class="font-sans font-600">Class / attribute</th><th class="font-sans font-600">What it does</th></tr>
1032
+ </thead>
1033
+ <tbody>
1034
+ <tr><td><code class="font-mono">.pp-field</code></td><td>Flex column wrapper — label, input, hint, message</td></tr>
1035
+ <tr><td><code class="font-mono">.pp-field__label</code></td><td>Visible label row — medium sm text</td></tr>
1036
+ <tr><td><code class="font-mono">.pp-field__required</code></td><td><code class="font-mono">&lt;abbr&gt;</code> asterisk with <code class="font-mono">aria-label="required"</code></td></tr>
1037
+ <tr><td><code class="font-mono">.pp-field__optional</code></td><td>Muted "optional" badge</td></tr>
1038
+ <tr><td><code class="font-mono">.pp-field__input</code></td><td>Styled <code class="font-mono">&lt;input&gt;</code></td></tr>
1039
+ <tr><td><code class="font-mono">.pp-field__textarea</code></td><td>Styled <code class="font-mono">&lt;textarea&gt;</code></td></tr>
1040
+ <tr><td><code class="font-mono">.pp-field__hint</code></td><td>Helper text — wire to input via <code class="font-mono">aria-describedby</code></td></tr>
1041
+ <tr><td><code class="font-mono">.pp-field__message</code></td><td>Validation message row with icon slot</td></tr>
1042
+ <tr><td><code class="font-mono">.pp-field--error</code></td><td>Red border + primary-dark message text</td></tr>
1043
+ <tr><td><code class="font-mono">.pp-field--success</code></td><td>Green border + green-700 message text</td></tr>
1044
+ <tr><td><code class="font-mono">.pp-field--warning</code></td><td>Amber border + amber-800 message text</td></tr>
1045
+ <tr><td><code class="font-mono">.pp-field--sm / --lg</code></td><td>Compact / large size variants</td></tr>
1046
+ <tr><td><code class="font-mono">.pp-field__input-wrap</code></td><td>Wrapper for icon + input pairing</td></tr>
1047
+ <tr><td><code class="font-mono">.pp-field__icon</code></td><td>Leading icon — <code class="font-mono">--trail</code> modifier for trailing</td></tr>
1048
+ <tr><td><code class="font-mono">.pp-field__count</code></td><td>Character counter — <code class="font-mono">--warn</code> / <code class="font-mono">--over</code> states</td></tr>
1049
+ </tbody>
1050
+ </table>
1051
+
1052
+ <!-- ── Validation ─────────────────────────────────────────────────────── -->
1053
+ <h3 id="form-validation" class="font-sans font-600 text-xl" style="margin-top:2rem;">Validation</h3>
1054
+ <p class="font-sans font-400 text-sm" style="color:#71717a;max-width:600px;">
1055
+ All visual states are driven by CSS classes and ARIA attributes — the optional <code class="font-mono">ppValidation</code> JS API just toggles them. You can drive the same states from your own code without loading our shim.
1056
+ </p>
1057
+
1058
+ <!-- Validation summary -->
1059
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:1.5rem;">Validation summary</p>
1060
+ <div class="pp-validation-summary is-visible" role="alert" aria-label="Form errors" id="demo-summary">
1061
+ <p class="pp-validation-summary__title">
1062
+ <i data-lucide="circle-x" aria-hidden="true"></i>
1063
+ 2 errors prevented this form from being submitted
1064
+ </p>
1065
+ <ul class="pp-validation-summary__list">
1066
+ <li class="pp-validation-summary__item"><a href="#vs-email">Email address is not valid.</a></li>
1067
+ <li class="pp-validation-summary__item"><a href="#vs-password">Password must be at least 8 characters.</a></li>
1068
+ </ul>
1069
+ </div>
1070
+
1071
+ <!-- Fields linked from summary -->
1072
+ <div style="display:flex;flex-direction:column;gap:1rem;max-width:480px;margin-top:1rem;">
1073
+ <div class="pp-field pp-field--error">
1074
+ <label class="pp-field__label" for="vs-email">
1075
+ Email address
1076
+ <abbr class="pp-field__required" aria-label="required" title="required"></abbr>
1077
+ </label>
1078
+ <input class="pp-field__input" type="email" id="vs-email" name="vs-email" value="not-an-email" aria-invalid="true" aria-describedby="vs-email-msg" />
1079
+ <span class="pp-field__message" id="vs-email-msg" role="alert">
1080
+ <i data-lucide="circle-x" aria-hidden="true"></i>
1081
+ Enter a valid email address, e.g. you@example.com.
1082
+ </span>
1083
+ </div>
1084
+ <div class="pp-field pp-field--error">
1085
+ <label class="pp-field__label" for="vs-password">
1086
+ Password
1087
+ <abbr class="pp-field__required" aria-label="required" title="required"></abbr>
1088
+ </label>
1089
+ <input class="pp-field__input" type="password" id="vs-password" name="vs-password" value="abc" aria-invalid="true" aria-describedby="vs-password-hint vs-password-msg" />
1090
+ <span class="pp-field__hint" id="vs-password-hint">At least 8 characters including a number.</span>
1091
+ <span class="pp-field__message" id="vs-password-msg" role="alert">
1092
+ <i data-lucide="circle-x" aria-hidden="true"></i>
1093
+ Password is too short.
1094
+ </span>
1095
+ </div>
1096
+ </div>
1097
+
1098
+ <!-- Native pseudo-class validation -->
1099
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:2rem;">Native HTML5 validation (<code class="font-mono">.pp-field--validate</code>)</p>
1100
+ <p class="font-sans font-400 text-sm" style="color:#71717a;">Add <code class="font-mono">.pp-field--validate</code> to opt in to <code class="font-mono">:valid</code> / <code class="font-mono">:invalid</code> pseudo-class styling. Browser handles validation; CSS handles the visual.</p>
1101
+ <div style="display:flex;flex-direction:column;gap:1rem;max-width:480px;margin-top:0.5rem;">
1102
+ <div class="pp-field pp-field--validate">
1103
+ <label class="pp-field__label" for="nv-email">
1104
+ Email
1105
+ <abbr class="pp-field__required" aria-label="required" title="required"></abbr>
1106
+ </label>
1107
+ <input class="pp-field__input" type="email" id="nv-email" name="nv-email" required aria-required="true" placeholder="Type an invalid email to see the state" />
1108
+ <span class="pp-field__hint">Try typing something that isn't an email address.</span>
1109
+ </div>
1110
+ <div class="pp-field pp-field--validate">
1111
+ <label class="pp-field__label" for="nv-pattern">
1112
+ German licence plate
1113
+ </label>
1114
+ <input class="pp-field__input" type="text" id="nv-pattern" name="nv-pattern"
1115
+ pattern="[A-ZÖÄÜ]{1,3} [A-Z]{2,4} [0-9]{1,4}"
1116
+ placeholder="e.g. B AB 1234"
1117
+ aria-describedby="nv-pattern-hint" />
1118
+ <span class="pp-field__hint" id="nv-pattern-hint">Format: 1–3 city letters, space, 2–4 letters, space, 1–4 digits.</span>
1119
+ </div>
1120
+ </div>
1121
+
1122
+ <!-- Confirmation checkbox -->
1123
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:2rem;">Confirmation checkbox (WCAG 3.3.4)</p>
1124
+ <div style="display:flex;flex-direction:column;gap:1rem;max-width:480px;">
1125
+ <label class="pp-confirm">
1126
+ <input class="pp-confirm__input" type="checkbox" id="confirm-transfer" aria-describedby="confirm-transfer-desc" />
1127
+ <span class="pp-confirm__label" id="confirm-transfer-desc">
1128
+ I have checked that the amount I wish to transfer is correct and understand this action cannot be undone.
1129
+ </span>
1130
+ </label>
1131
+ <button class="button font-sans pp-submit--gated" type="button">Confirm transfer</button>
1132
+ </div>
1133
+
1134
+ <!-- Destructive confirmation -->
1135
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:2rem;">Destructive confirmation</p>
1136
+ <div style="display:flex;flex-direction:column;gap:1rem;max-width:480px;">
1137
+ <label class="pp-confirm pp-confirm--destructive">
1138
+ <input class="pp-confirm__input" type="checkbox" id="confirm-delete" aria-describedby="confirm-delete-desc" />
1139
+ <span class="pp-confirm__label" id="confirm-delete-desc">
1140
+ I understand that deleting my account is permanent and all my data will be removed.
1141
+ </span>
1142
+ </label>
1143
+ <button class="button-error font-sans pp-submit--gated" type="button">Delete account</button>
1144
+ </div>
1145
+
1146
+ <!-- ppValidation API demo -->
1147
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:2rem;">Live API demo — <code class="font-mono">ppValidation</code></p>
1148
+ <p class="font-sans font-400 text-sm" style="color:#71717a;max-width:600px;">The buttons below call <code class="font-mono">ppValidation.setError()</code>, <code class="font-mono">ppValidation.setSuccess()</code>, and <code class="font-mono">ppValidation.clearError()</code> on the field beneath them.</p>
1149
+ <div style="display:flex;flex-direction:column;gap:1rem;max-width:480px;">
1150
+ <div class="pp-field" id="api-field-wrap">
1151
+ <label class="pp-field__label" for="api-field">Username</label>
1152
+ <input class="pp-field__input" type="text" id="api-field" name="api-field" value="ada_lovelace" aria-describedby="api-field-hint" />
1153
+ <span class="pp-field__hint" id="api-field-hint">3–20 characters, letters and underscores only.</span>
1154
+ </div>
1155
+ <div class="row" style="justify-content:flex-start;">
1156
+ <button class="button-error font-sans font-400" type="button"
1157
+ onclick="ppValidation.setError(document.getElementById('api-field'), 'Username already taken.')">
1158
+ Set error
1159
+ </button>
1160
+ <button class="button-success font-sans font-400" type="button"
1161
+ onclick="ppValidation.setSuccess(document.getElementById('api-field'), 'Username is available.')">
1162
+ Set success
1163
+ </button>
1164
+ <button class="button-ghost font-sans font-400" type="button"
1165
+ onclick="ppValidation.clearError(document.getElementById('api-field'))">
1166
+ Clear
1167
+ </button>
1168
+ </div>
1169
+ </div>
1170
+
1171
+ <!-- Usage table -->
1172
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:2rem;">CSS classes</p>
1173
+ <table class="pp-table pp-table--cols-2" style="width:100%;">
1174
+ <thead>
1175
+ <tr><th class="font-sans font-600">Class / attribute</th><th class="font-sans font-600">What it does</th></tr>
1176
+ </thead>
1177
+ <tbody>
1178
+ <tr><td><code class="font-mono">.pp-field--validate</code></td><td>Opt-in to <code class="font-mono">:valid</code> / <code class="font-mono">:invalid</code> pseudo-class styling</td></tr>
1179
+ <tr><td><code class="font-mono">aria-invalid="true"</code></td><td>Red border — works without any class</td></tr>
1180
+ <tr><td><code class="font-mono">aria-invalid="false"</code></td><td>Green border — works without any class</td></tr>
1181
+ <tr><td><code class="font-mono">.pp-field--validating</code></td><td>Spinner on input — async check in progress</td></tr>
1182
+ <tr><td><code class="font-mono">.pp-validation-summary</code></td><td>Pre-form error list with <code class="font-mono">role="alert"</code></td></tr>
1183
+ <tr><td><code class="font-mono">.is-visible</code></td><td>Shows the summary (hidden by default)</td></tr>
1184
+ <tr><td><code class="font-mono">.pp-confirm</code></td><td>Confirmation checkbox wrapper</td></tr>
1185
+ <tr><td><code class="font-mono">.pp-confirm--destructive</code></td><td>Red tint for irreversible actions</td></tr>
1186
+ <tr><td><code class="font-mono">.pp-submit--gated</code></td><td>Disables submit until confirmation checkbox is checked (CSS <code class="font-mono">:has()</code>)</td></tr>
1187
+ </tbody>
1188
+ </table>
1189
+
1190
+ <p class="font-sans font-500 text-xs uppercase tracking-wider" style="color:#71717a;margin-top:2rem;">JS API — <code class="font-mono">ppValidation</code></p>
1191
+ <table class="pp-table pp-table--cols-2" style="width:100%;">
1192
+ <thead>
1193
+ <tr><th class="font-sans font-600">Method</th><th class="font-sans font-600">What it does</th></tr>
1194
+ </thead>
1195
+ <tbody>
1196
+ <tr><td><code class="font-mono">setError(input, message)</code></td><td>Adds <code class="font-mono">.pp-field--error</code>, sets <code class="font-mono">aria-invalid="true"</code>, writes message</td></tr>
1197
+ <tr><td><code class="font-mono">clearError(input)</code></td><td>Removes error state, sets <code class="font-mono">aria-invalid="false"</code></td></tr>
1198
+ <tr><td><code class="font-mono">setSuccess(input, message?)</code></td><td>Adds <code class="font-mono">.pp-field--success</code>, sets <code class="font-mono">aria-invalid="false"</code></td></tr>
1199
+ <tr><td><code class="font-mono">setValidating(input)</code></td><td>Adds <code class="font-mono">.pp-field--validating</code>, removes <code class="font-mono">aria-invalid</code></td></tr>
1200
+ <tr><td><code class="font-mono">setSummary(errors[], summaryEl)</code></td><td>Populates summary, shows it, moves focus to it</td></tr>
1201
+ </tbody>
1202
+ </table>
1203
+ </div>
1204
+ </section>
1205
+
1206
+ <!-- Changelog -->
1207
+ <section id="changelog" class="pp-section pp-section--muted">
1208
+ <div class="pp-section__inner text-left" style="align-items:flex-start;max-width:720px;">
1209
+ <h2 class="font-sans font-700 tracking-tight">Changelog</h2>
1210
+
1211
+ <!-- v0.3.0 -->
1212
+ <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>
1214
+
1215
+ <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;">
1217
+ <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
+ <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
+ <li><strong>Forms</strong> — five new form components: Fieldset &amp; Legend, Form Instructions, Label, Text Field, Validation.</li>
1220
+ </ul>
1221
+
1222
+ <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;">
1224
+ <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
+ <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
+ <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>
1227
+ <li><strong>Text Field</strong> — label, input/textarea, hint (<code class="font-mono">aria-describedby</code>), required <code class="font-mono">&lt;abbr&gt;</code> marker, validation states, sizes, icon wrap, character counter.</li>
1228
+ <li><strong>Validation</strong> — <code class="font-mono">:valid</code>/<code class="font-mono">:invalid</code> opt-in, <code class="font-mono">aria-invalid</code> selectors, validating spinner, summary with <code class="font-mono">role="alert"</code>, confirmation checkbox with CSS <code class="font-mono">:has()</code> gated submit; <code class="font-mono">ppValidation</code> JS API.</li>
1229
+ </ul>
1230
+
1231
+ <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;">
1233
+ <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
+ <li>Apple device map: 12 named breakpoints from <code class="font-mono">iphone-se</code> to <code class="font-mono">imac</code>.</li>
1235
+ <li><code class="font-mono">respond-below()</code> and <code class="font-mono">respond-between()</code> mixins added.</li>
1236
+ </ul>
1237
+
1238
+ <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;">
1240
+ <li>Switched from Feather Icons to Lucide Icons (<code class="font-mono">lucide.createIcons()</code>).</li>
1241
+ <li>Demo: Installation section, Carousel, Footer, and Forms sections added; nav dropdowns for Components and Forms; Changelog section.</li>
1242
+ </ul>
1243
+ </div>
1244
+
1245
+ <!-- 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>
1248
+ <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;">
1250
+ <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
+ <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
+ <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>
1253
+ <li><strong>Tabs:</strong> <code class="font-mono">role="tablist"</code>, <code class="font-mono">aria-controls</code> to panel ids, <code class="font-mono">Home</code> / <code class="font-mono">End</code> keyboard shortcuts.</li>
1254
+ <li><strong>CSS:</strong> ARIA attribute states are first-class CSS selectors — visual state driven by ARIA, not class names alone.</li>
1255
+ <li>Section order updated: Hero → Colors → Typography → Components (A→Z).</li>
1256
+ </ul>
1257
+ </div>
1258
+
1259
+ <!-- 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;">
1263
+ <li>Reset, base tokens, button, card, gradient text, header, modal, section, select, table, tabs, typography.</li>
1264
+ <li>Progressive enhancement — CSS-only baseline; JS adds keyboard nav, animations, outside-click close.</li>
1265
+ <li>Inter + Kode Mono via Google Fonts; esbuild bundler with per-component files + <code class="font-mono">peppertino.js</code> aggregator.</li>
1266
+ </ul>
1267
+ </div>
1268
+ </div>
1269
+ </section>
1270
+
1271
+ <!-- ═══════════════════════════════════════════════════════════════════════ -->
1272
+ <!-- Footer — always last, the only component allowed out of A→Z order -->
1273
+ <!-- ═══════════════════════════════════════════════════════════════════════ -->
1274
+ <footer id="footer" class="pp-footer pp-footer--accent" role="contentinfo">
1275
+ <div class="pp-footer__top">
1276
+ <div class="pp-footer__brand">
1277
+ <a href="#hero" class="pp-footer__logo font-sans font-600">PeppertinoCSS</a>
1278
+ <p class="pp-footer__tagline font-sans font-400">An Apple-inspired CSS framework with a spicy red accent. Clean geometry, restrained elegance.</p>
1279
+ </div>
1280
+
1281
+ <div class="pp-footer__col">
1282
+ <p class="pp-footer__col-title font-sans">Framework</p>
1283
+ <ul class="pp-footer__nav" aria-label="Framework links">
1284
+ <li><a href="https://codeberg.org/debaditya/Peppertino" class="pp-footer__nav-link font-sans" target="_blank" rel="noopener noreferrer">Getting Started</a></li>
1285
+ <li><a href="#installation" class="pp-footer__nav-link font-sans">Installation</a></li>
1286
+ <li><a href="https://codeberg.org/debaditya/Peppertino/src/branch/main/README.md" class="pp-footer__nav-link font-sans" target="_blank" rel="noopener noreferrer">Configuration</a></li>
1287
+ <li><a href="#changelog" class="pp-footer__nav-link font-sans">Changelog</a></li>
1288
+ </ul>
1289
+ </div>
1290
+
1291
+ <div class="pp-footer__col">
1292
+ <p class="pp-footer__col-title font-sans">Components</p>
1293
+ <ul class="pp-footer__nav" aria-label="Component links">
1294
+ <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
+ <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
+ </ul>
1300
+ </div>
1301
+
1302
+ <div class="pp-footer__col">
1303
+ <p class="pp-footer__col-title font-sans">More</p>
1304
+ <ul class="pp-footer__nav" aria-label="More links">
1305
+ <li><a href="https://codeberg.org/debaditya/Peppertino" class="pp-footer__nav-link font-sans" target="_blank" rel="noopener noreferrer">Codeberg</a></li>
1306
+ <li><a href="https://www.npmjs.com/package/@auriel/peppertino" class="pp-footer__nav-link font-sans" target="_blank" rel="noopener noreferrer">npm</a></li>
1307
+ <li><a href="https://codeberg.org/debaditya/Peppertino/src/branch/main/LICENSE" class="pp-footer__nav-link font-sans" target="_blank" rel="noopener noreferrer">License</a></li>
1308
+ <li><a href="https://codeberg.org/debaditya/Peppertino/issues" class="pp-footer__nav-link font-sans" target="_blank" rel="noopener noreferrer">Report a bug</a></li>
1309
+ </ul>
1310
+ </div>
1311
+ </div>
1312
+
1313
+ <div class="pp-footer__bottom">
1314
+ <p class="pp-footer__legal font-sans font-400">
1315
+ &copy; 2026 PeppertinoCSS. Released under the <a href="https://codeberg.org/debaditya/Peppertino/src/branch/main/LICENSE" target="_blank" rel="noopener noreferrer">MIT License</a>.
1316
+ </p>
1317
+ <ul class="pp-footer__social" aria-label="Social links">
1318
+ <li>
1319
+ <a href="https://codeberg.org/debaditya/Peppertino" class="pp-footer__social-link" aria-label="Codeberg" target="_blank" rel="noopener noreferrer">
1320
+ <i data-lucide="git-branch"></i>
1321
+ </a>
1322
+ </li>
1323
+ <li>
1324
+ <a href="https://www.npmjs.com/package/@auriel/peppertino" class="pp-footer__social-link" aria-label="npm" target="_blank" rel="noopener noreferrer">
1325
+ <i data-lucide="package"></i>
1326
+ </a>
1327
+ </li>
1328
+ </ul>
1329
+ </div>
1330
+ </footer>
1331
+
217
1332
  </body>
218
1333
  </html>