@auriel/peppertino 0.3.0 → 0.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (68) hide show
  1. package/CHANGELOG.txt +210 -122
  2. package/MIGRATION.md +52 -0
  3. package/README.md +284 -40
  4. package/dist/accordion.js +88 -0
  5. package/dist/accordion.js.map +7 -0
  6. package/dist/alert.js +26 -0
  7. package/dist/alert.js.map +7 -0
  8. package/dist/carousel.js +4 -0
  9. package/dist/carousel.js.map +2 -2
  10. package/dist/header.js +1 -0
  11. package/dist/header.js.map +2 -2
  12. package/dist/main.css +3607 -299
  13. package/dist/main.css.map +1 -1
  14. package/dist/modal.js +2 -0
  15. package/dist/modal.js.map +2 -2
  16. package/dist/peppertino.js +290 -11
  17. package/dist/peppertino.js.map +3 -3
  18. package/dist/select.js +2 -4
  19. package/dist/select.js.map +2 -2
  20. package/dist/switch.js +29 -0
  21. package/dist/switch.js.map +7 -0
  22. package/dist/tabs.js +27 -7
  23. package/dist/tabs.js.map +2 -2
  24. package/dist/theme.js +47 -0
  25. package/dist/theme.js.map +7 -0
  26. package/dist/toast.js +69 -0
  27. package/dist/toast.js.map +7 -0
  28. package/index.html +813 -48
  29. package/package.json +6 -4
  30. package/scripts/hex-to-hsl.mjs +75 -0
  31. package/scripts/lint-bem.mjs +53 -0
  32. package/scripts/lint-colors.mjs +87 -0
  33. package/src/js/accordion.js +103 -0
  34. package/src/js/alert.js +28 -0
  35. package/src/js/carousel.js +5 -0
  36. package/src/js/header.js +1 -0
  37. package/src/js/modal.js +4 -0
  38. package/src/js/peppertino.js +6 -0
  39. package/src/js/select.js +2 -4
  40. package/src/js/switch.js +28 -0
  41. package/src/js/tabs.js +31 -21
  42. package/src/js/theme.js +47 -0
  43. package/src/js/toast.js +79 -0
  44. package/src/scss/accordion.scss +156 -0
  45. package/src/scss/alert.scss +203 -0
  46. package/src/scss/badge.scss +90 -0
  47. package/src/scss/base.scss +331 -36
  48. package/src/scss/button.scss +44 -46
  49. package/src/scss/card.scss +4 -4
  50. package/src/scss/carousel.scss +18 -28
  51. package/src/scss/dark-mode.scss +514 -0
  52. package/src/scss/footer.scss +14 -14
  53. package/src/scss/forms/fieldset.scss +12 -12
  54. package/src/scss/forms/form-instructions.scss +8 -8
  55. package/src/scss/forms/text-field.scss +17 -17
  56. package/src/scss/forms/validation.scss +12 -12
  57. package/src/scss/gradient.scss +2 -2
  58. package/src/scss/header.scss +8 -8
  59. package/src/scss/main.scss +8 -0
  60. package/src/scss/modal.scss +2 -2
  61. package/src/scss/section.scss +1 -1
  62. package/src/scss/select.scss +8 -8
  63. package/src/scss/switch.scss +121 -0
  64. package/src/scss/table.scss +5 -5
  65. package/src/scss/tabs.scss +26 -26
  66. package/src/scss/toast.scss +170 -0
  67. package/src/scss/tooltip.scss +126 -0
  68. package/src/scss/utilities.scss +243 -0
package/CHANGELOG.txt CHANGED
@@ -1,136 +1,224 @@
1
1
  PeppertinoCSS — Changelog
2
2
  =========================
3
3
 
4
- v0.3.0 — 2026-06-05
5
- --------------------
4
+ All notable changes are documented here in reverse chronological order.
5
+ Versioning follows semver. Dates are YYYY-MM-DD.
6
+
7
+ ─────────────────────────────────────────────────────────────────────────────
8
+ v0.5.0 — 2026-06-18
9
+ ─────────────────────────────────────────────────────────────────────────────
10
+
11
+ BEM naming (BREAKING — see MIGRATION.md)
12
+ - All component classes are now prefixed with pp-:
13
+ .button -> .pp-button
14
+ .gradient-txt -> .pp-gradient-text
15
+ - Modifier combiners confirmed: .pp-button--outline.pp-button--success (no
16
+ compound hyphen classes like .pp-button-outline-success).
17
+
18
+ HSL color token system
19
+ - base.scss: every color token decomposed into H/S/L channel properties plus
20
+ a composite shorthand. Pattern for each token:
21
+ --pp-primary-h: 356;
22
+ --pp-primary-s: 99.2%;
23
+ --pp-primary-l: 46.3%;
24
+ --pp-primary: hsl(var(--pp-primary-h) var(--pp-primary-s) var(--pp-primary-l));
25
+ - Alpha tints no longer use rgba($color-*, alpha); all component SCSS uses:
26
+ hsl(var(--pp-*-h) var(--pp-*-s) var(--pp-*-l) / 0.15)
27
+ - dark-mode.scss overrides at channel level (--pp-neutral-800-l: 95.9%) so
28
+ a single property change cascades to all consumers of that token.
29
+ - New dark shade tokens: --pp-success-900, --pp-warning-900, --pp-error-900,
30
+ --pp-info-900 for alert text colors that previously used hardcoded hex.
31
+ - All component SCSS files fully migrated: accordion, alert, button, card,
32
+ carousel, footer, forms (fieldset / form-instructions / text-field /
33
+ validation), gradient, header, modal, section, select, tabs, toast, tooltip.
34
+ - lint-colors.mjs enforces the ban on SCSS color vars and 6-digit hex in all
35
+ component files (base.scss and dark-mode.scss are exempted).
36
+
37
+ New components
38
+ - Badge Pill status indicators; variants: --primary/success/warning/
39
+ error/info; modifier: --filled; sizes: --sm, --lg; --dot for
40
+ 8x8 presence/count circles. CSS-only, no JS.
41
+ - Switch iOS-style toggle; sizes: --sm, --lg. aria-checked drives visual
42
+ state (track color + thumb translateX). JS wires toggle on click
43
+ and Space key; dispatches pp:switch:change { checked: boolean }.
44
+ - Toast Auto-dismissing notifications. ppToast.show({ message, title,
45
+ variant, duration, position }). Creates container on demand.
46
+ Variants: neutral/info/success/warning/error. Six positions:
47
+ top/bottom × right/left/center. Progress bar animation.
48
+ duration: 0 for persistent. Events: pp:toast:show,
49
+ pp:toast:dismiss. data-toast-dismiss wires dismiss button.
50
+ - Tooltip CSS-only; no JS. Shows on :hover and :focus-within. Four
51
+ placements: top (default), --bottom, --left, --right. Arrow
52
+ via ::before. data-show to force-display. role="tooltip" on
53
+ content span. Keyboard accessible when trigger is focusable.
54
+
55
+ JS API consistency
56
+ - All CustomEvents renamed to pp:<component>:<event> format:
57
+ pp:accordion:open / pp:accordion:close { index, trigger, panel }
58
+ pp:alert:dismiss
59
+ pp:carousel:change { index, total, label }
60
+ pp:header:open / pp:header:close
61
+ pp:modal:open / pp:modal:close
62
+ pp:select:change { value }
63
+ pp:switch:change { checked }
64
+ pp:tabs:change { index }
65
+ pp:theme:change { theme: 'dark'|'light' }
66
+ pp:toast:show / pp:toast:dismiss
67
+ - ppAccordion.get(ref) -> { open(i), close(i), toggleAll() }
68
+ - ppAlert.dismiss(idOrEl)
69
+ - ppTabs.get(ref).activate(index)
70
+ - ppTheme.set(theme) / .get() / .toggle(); localStorage key: pp-theme;
71
+ data-theme-toggle auto-wired.
72
+ - New files: alert.js, switch.js, theme.js, toast.js.
73
+ - peppertino.js updated to import all new files.
74
+
75
+ Build guardrails
76
+ - scripts/lint-colors.mjs — bans rgba($color-*, ...), rgba($gradient-*, ...),
77
+ and 6-digit hex in all component SCSS. Structural white/black overlays
78
+ (rgba(255,...), rgba(0,0,0,...), #fff, #000, #ffffff) allowed. Exits 1 on
79
+ any violation.
80
+ - scripts/lint-bem.mjs — reads dist/main.css, extracts all .pp-* class
81
+ selectors, validates against BEM regex. Digit-starting modifiers (--2, --3)
82
+ allowed for grid helpers. Exits 1 on any violation.
83
+ - bun run build now runs: build:css && build:js && lint:colors && lint:bem.
84
+ - All package.json scripts migrated to bun (bun run build, bun run dev, etc.).
85
+
86
+ Demo
87
+ - index.html: Badge, Switch, Toast, Tooltip demo sections added.
88
+ - Header nav Components dropdown updated with new entries (Badge, Switch,
89
+ Toast, Tooltip).
90
+
91
+ Skill docs
92
+ - agents/peppertino/: badge.md, switch.md, toast.md, tooltip.md added.
93
+ - SKILL.md index updated with all new entries and corrected stale references.
94
+
95
+ ─────────────────────────────────────────────────────────────────────────────
96
+ v0.4.0 — 2026-06-11
97
+ ─────────────────────────────────────────────────────────────────────────────
6
98
 
7
99
  New components
100
+ - Accordion CSS max-height transition; variants: --flush, --dark, --primary.
101
+ JS shim adds aria-expanded, aria-hidden, keyboard navigation
102
+ (↑ ↓ Home End), and data-allow-multiple for multi-open mode.
103
+ - Alert Inline feedback messages; variants: --info, --success,
104
+ --warning, --error, --primary, --neutral; modifier: --filled.
105
+ .is-dismissible + .pp-alert__dismiss button; .is-dismissing
106
+ triggers slide-out animation before DOM removal.
107
+
108
+ Utilities
109
+ - New utilities layer (utilities.scss) — single-purpose classes with no JS:
110
+ Display .d-{block|inline|inline-block|flex|inline-flex|
111
+ grid|inline-grid|none|contents}
112
+ Visibility .visible .invisible .sr-only .not-sr-only
113
+ Opacity .opacity-{0|25|50|75|100}
114
+ Margin .m-* .mt-* .mb-* .ml-* .mr-* .mx-* .my-* (keys 0-32, auto)
115
+ Padding .p-* .pt-* .pb-* .pl-* .pr-* .px-* .py-* (keys 0-32)
116
+ Gap .gap-* .gap-x-* .gap-y-* (keys 0-32)
117
+ Flex direction, wrap, grow/shrink, justify-content, align-items,
118
+ align-self
119
+ Grid .grid-cols-{1-6,12}, .grid-rows-{1-4}, .col-span-*,
120
+ .row-span-*
121
+ Width .w-full .w-screen .w-auto .w-fit .w-min .w-max .w-half
122
+ Height .h-full .h-screen .h-auto .h-fit
123
+ Overflow .overflow-{auto|hidden|visible|scroll}, x/y variants
124
+ Position .static .relative .absolute .fixed .sticky
125
+ Z-index .z-{below|base|raised|overlay|modal|toast|tooltip}
126
+ Border-radius .rounded-{none|sm|base|md|lg|xl|2xl|full}
127
+ Shadow .shadow-{none|sm|md|lg|xl}
128
+ Cursor .cursor-{default|pointer|not-allowed|grab|text}
129
+ Pointer .pointer-events-{none|auto}
130
+ User-select .select-{none|text|all|auto}
131
+ Responsive .sm-d-* .md-d-* .lg-d-* .xl-d-* .w2xl-d-* (display only)
132
+
133
+ Dark mode
134
+ - Class-based dark mode via .dark on <html> or any ancestor.
135
+ Never prefers-color-scheme. JS toggle persists preference to localStorage.
136
+ - All design tokens in base.scss now exposed as CSS custom properties on :root
137
+ (--pp-neutral-*, --pp-surface, --pp-on-surface, --pp-border,
138
+ --pp-bg-card, --pp-bg-input, --pp-bg-select*, --pp-bg-header*,
139
+ --pp-bg-footer, --pp-bg-dropdown, --pp-glass-border, --pp-glass-hover,
140
+ --pp-shadow-*, --pp-label-*, --pp-section-muted-bg, etc.).
141
+ - dark-mode.scss overrides all tokens under .dark: neutral scale fully
142
+ inverted (50 <-> 900), surface/on-surface swapped, shadows strengthened,
143
+ glass values darkened.
144
+ - Component SCSS updated to consume CSS vars instead of hardcoded literals:
145
+ card, accordion, table, header, footer, section, select, forms/fieldset,
146
+ forms/text-field, forms/validation.
147
+ - Demo page: moon/sun toggle added to header. Every component section now
148
+ shows a .dark-wrapped preview pane alongside the light demo.
149
+
150
+ Bug fixes / polish
151
+ - Table row borders: were using static $color-neutral-200 SCSS var (light
152
+ only); replaced with var(--pp-border) so they flip correctly in dark mode.
153
+ - Utilities demo: inline code chips and container backgrounds were hardcoded
154
+ #f4f4f5; replaced with var(--pp-neutral-100) / var(--pp-neutral-200).
155
+ - Changelog section: hardcoded text colors replaced with CSS vars.
156
+ - dark-mode.scss: attribute selector overrides for inline-style colors
157
+ (#71717a, #52525b, #18181b) used on section labels in the demo page.
158
+
159
+ ─────────────────────────────────────────────────────────────────────────────
160
+ v0.3.0 — 2026-06-05
161
+ ─────────────────────────────────────────────────────────────────────────────
8
162
 
9
- Carousel (carousel.scss + carousel.js)
10
- - CSS scroll-snap driven, no JS required for motion
11
- - Variants: default, --peek-2, --peek-3, --dark, --flush
12
- - Prev/next controls, animated pill dots, gradient caption overlay
13
- - Autoplay toggle button (UI state only)
14
- - JS shim: ARIA region/slide/group roles, IntersectionObserver sync,
15
- roving tabindex on dots, polite live region announcements
16
- - ppCarousel.get(id) public API
17
-
18
- Footer (footer.scss)
19
- - CSS only, no JS
20
- - Brand column + up to 4 nav columns, collapses to 2-col then 1-col
21
- - Bottom bar: copyright + social icon links
22
- - Variants: --dark, --accent (gradient top border)
23
- - All links have :focus-visible outlines
24
-
25
- Forms (forms.scss + src/scss/forms/)
26
- - Fieldset & Legend (fieldset.scss)
27
- - Variants: default, --ghost, --filled, --primary, --error
28
- - disabled / aria-disabled support
29
- - Legend modifiers: --sm, --lg, --inline (icon + text)
30
- - Form Instructions (form-instructions.scss)
31
- - Pre-form block (place before <form> for screen reader Forms Mode)
32
- - Variants: default, --neutral, --warning, --error (role="alert")
33
- - In-form hint (.pp-form-hint) and required-field note
34
- - Label (label.scss)
35
- - Four importance tiers: primary, secondary, tertiary, quaternary
36
- - Apple Dynamic Type scale: headline, subheadline, body, callout,
37
- footnote, caption
38
- - --selectable, --truncate modifiers
39
- - .pp-label-row for icon + label pairing
40
- - Text Field (text-field.scss)
41
- - .pp-field wrapper: label, input/textarea, hint, message
42
- - Required <abbr aria-label="required"> marker
43
- - Optional badge
44
- - Validation states: --error, --success, --warning
45
- - Sizes: --sm, --lg
46
- - Icon wrap (.pp-field__input-wrap + .pp-field__icon)
47
- - Character counter (.pp-field__count) with --warn / --over states
48
- - Validation (validation.scss + validation.js)
49
- - .pp-field--validate opt-in for :valid/:invalid pseudo-class styling
50
- - aria-invalid attribute selectors (work without JS)
51
- - .pp-field--validating spinner state for async checks
52
- - .pp-validation-summary with role="alert", linked error items
53
- - .pp-confirm confirmation checkbox, --destructive variant
54
- - .pp-submit--gated: CSS :has() disables submit until confirmed
55
- - JS shim: setError, clearError, setSuccess, setValidating, setSummary
56
- - Auto-wires aria-describedby on init
163
+ New components
164
+ - Carousel CSS scroll-snap driven; variants: --peek-2, --peek-3,
165
+ --dark, --flush; ppCarousel JS API (goTo, prev, next).
166
+ - Footer Multi-column layout; variants: --dark, --accent; CSS only.
167
+ - Forms Five new form partials:
168
+ Fieldset .pp-fieldset + .pp-legend; variants: --ghost, --filled,
169
+ --primary, --error; legend modifiers: --sm, --lg, --inline.
170
+ Form Instr. .pp-form-instructions -- pre-form block for screen reader
171
+ Forms Mode; variants: --neutral, --warning, --error.
172
+ .pp-form-hint and .pp-form-required-note helpers.
173
+ Label .pp-label -- four-tier importance system (primary to
174
+ quaternary); Apple Dynamic Type scale (headline to caption);
175
+ --selectable, --truncate, icon row.
176
+ Text Field .pp-field -- label + input/textarea + hint + required abbr +
177
+ validation states (--error, --success, --warning,
178
+ --validating); sizes --sm / --lg; icon wrap; char counter.
179
+ Validation :valid/:invalid opt-in, aria-invalid selectors, async
180
+ spinner, .pp-validation-summary with role="alert",
181
+ .pp-confirm CSS :has() gated submit; ppValidation JS API.
57
182
 
58
183
  Breakpoints
59
- - Tailwind-compatible map: sm/md/lg/xl/2xl
60
- - Apple device map: iphone-se through imac (12 named breakpoints)
61
- - respond-to() mixin (min-width)
62
- - respond-below() and respond-between() mixins
184
+ - Added respond-below() and respond-between() mixins.
185
+ - Apple device breakpoint map: 12 named entries from iphone-se to imac.
63
186
 
64
187
  Icons
65
- - Switched from Feather Icons to Lucide Icons (CDN + createIcons())
66
- - Brand/logo icons in footer use inline SVG (Lucide has no brand icons)
67
-
68
- Demo (index.html)
69
- - Installation section with npm, CDN, SCSS import, clone instructions
70
- - Carousel, Footer, and Forms sections added
71
- - Nav dropdowns for Components and Forms
72
- - Changelog section
73
- - All external links use jsdelivr CDN
188
+ - Switched from Feather Icons to Lucide Icons (lucide.createIcons()).
74
189
 
190
+ Demo
191
+ - Installation, Carousel, Footer, and Forms sections added to index.html.
192
+ - Header nav: Components and Forms dropdowns; A-to-Z component ordering.
193
+ - Changelog section added to demo page.
75
194
 
195
+ ─────────────────────────────────────────────────────────────────────────────
76
196
  v0.2.0 — 2026-06-01
77
- --------------------
78
- Accessibility (ARIA) — full pass across all components.
79
-
80
- Header
81
- - role="menubar" on nav list
82
- - role="menu" on dropdowns, role="menuitem" on all links
83
- - role="none" on <li> wrappers
84
- - aria-haspopup + aria-expanded on dropdown triggers
85
- - aria-controls wired to dropdown IDs
86
- - aria-hidden toggled on mobile nav drawer
87
- - aria-label on <nav>
88
-
89
- Modal
90
- - role="dialog" + aria-modal="true" on backdrop
91
- - aria-labelledby + aria-describedby auto-wired to title/description IDs
92
- - aria-label="Close" on close button
93
- - Focus trap: Tab/Shift+Tab stays inside open modal
94
- - Focus restored to triggering element on close
95
-
96
- Select
97
- - role="combobox" on trigger
98
- - role="listbox" on panel
99
- - role="option" + aria-selected on every option
100
- - aria-controls + aria-activedescendant kept in sync on selection
101
- - aria-disabled CSS hook for disabled state
102
-
103
- Tabs
104
- - role="tablist" on container (enforced by JS if missing)
105
- - role="tab" on items
106
- - aria-controls wired to panel IDs
107
- - role="tabpanel" + aria-labelledby on panels
108
- - Home / End keyboard shortcuts added
109
-
110
- CSS
111
- - ARIA attribute selectors (aria-expanded, aria-hidden, aria-selected,
112
- aria-disabled) are now first-class CSS hooks — visual state is driven
113
- by ARIA, not just class names
114
-
115
- HTML demo
116
- - All modal backdrops updated with role, aria-modal, aria-labelledby,
117
- aria-describedby, aria-hidden in markup
118
- - Nav updated with full menubar / menu / menuitem semantics
119
-
120
- Page structure
121
- - Section order updated: Hero → Colors → Typography → Components (A→Z)
122
-
123
-
197
+ ─────────────────────────────────────────────────────────────────────────────
198
+
199
+ Accessibility -- full ARIA pass across all components
200
+ - Header role="menubar" / "menu" / "menuitem"; aria-haspopup +
201
+ aria-expanded on dropdown triggers; aria-hidden on mobile drawer.
202
+ - Modal role="dialog" + aria-modal; aria-labelledby + aria-describedby
203
+ auto-wired by JS; focus trap on open; focus restored on close.
204
+ - Select role="combobox" / "listbox" / "option" + aria-selected;
205
+ aria-activedescendant kept in sync with keyboard focus.
206
+ - Tabs role="tablist"; aria-controls to panel ids; Home / End keyboard
207
+ shortcuts.
208
+ - CSS ARIA attribute states are first-class selectors -- visual state
209
+ driven by aria-expanded / aria-selected / aria-hidden rather
210
+ than class names alone.
211
+ - Demo Section order updated: Hero -> Colors -> Typography ->
212
+ Components (A-to-Z).
213
+
214
+ ─────────────────────────────────────────────────────────────────────────────
124
215
  v0.1.1 — initial release
125
- -------------------------
126
- - Reset, base design tokens, button, card, gradient text
127
- - Header: glassmorphism sticky, mobile hamburger drawer
128
- - Modal: glassmorphic backdrop, native <dialog> support
129
- - Section: full-viewport sections, custom gradient scrollbar
130
- - Select: native <select> restyling + .pp-select custom dropdown
131
- - Table: Apple-style clean tables
132
- - Tabs: pill-style, icon + label, four variants, sm/lg sizes
133
- - Typography: Inter + Kode Mono, weight/size/spacing utility classes
134
- - Progressive enhancement: CSS-only baseline for all interactive components
135
- - esbuild bundler: per-component files + peppertino.js aggregator
136
- - MIT license
216
+ ─────────────────────────────────────────────────────────────────────────────
217
+
218
+ - Reset, base tokens, button, card, gradient text, header, modal, section,
219
+ select, table, tabs, typography.
220
+ - Progressive enhancement -- CSS-only baseline; JS adds keyboard navigation,
221
+ animations, and outside-click close.
222
+ - Inter + Kode Mono via Google Fonts.
223
+ - esbuild bundler with per-component JS files + peppertino.js aggregator.
224
+ - Tailwind-compatible breakpoint map (sm / md / lg / xl / 2xl).
package/MIGRATION.md ADDED
@@ -0,0 +1,52 @@
1
+ # PeppertinoCSS — Migration Guide
2
+
3
+ ## v0.4.x → v0.5.0
4
+
5
+ ### Class renames (breaking)
6
+
7
+ All class names now follow strict BEM: `.pp-<component>` / `.pp-<component>--<modifier>`.
8
+
9
+ #### Button
10
+
11
+ | v0.4.x | v0.5.0 |
12
+ |---|---|
13
+ | `.button` | `.pp-button` |
14
+ | `.button-outline` | `.pp-button--outline` |
15
+ | `.button-success` | `.pp-button--success` |
16
+ | `.button-warning` | `.pp-button--warning` |
17
+ | `.button-error` | `.pp-button--error` |
18
+ | `.button-dark` | `.pp-button--dark` |
19
+ | `.button-gradient` | `.pp-button--gradient` |
20
+ | `.button-ghost` | `.pp-button--ghost` |
21
+ | `.button-outline-success` | `.pp-button--outline .pp-button--success` |
22
+ | `.button-outline-warning` | `.pp-button--outline .pp-button--warning` |
23
+ | `.button-outline-error` | `.pp-button--outline .pp-button--error` |
24
+ | `.button-outline-dark` | `.pp-button--outline .pp-button--dark` |
25
+
26
+ Note: outline+color variants changed from a single class to two combinable modifier classes. Both classes must be present on the element.
27
+
28
+ #### Gradient text
29
+
30
+ | v0.4.x | v0.5.0 |
31
+ |---|---|
32
+ | `.gradient-txt` | `.pp-gradient-text` |
33
+
34
+ ### Color tokens — hex → HSL (breaking for CSS var consumers)
35
+
36
+ All `--pp-*` custom properties that were previously flat hex values are now composed from H/S/L triplet properties. Consumers who read `--pp-primary` will still receive a valid color, but consumers who manually reference `--pp-primary-h`, `--pp-primary-s`, or `--pp-primary-l` for tint math are now supported.
37
+
38
+ ### New components
39
+
40
+ Switch, Tooltip, Badge, Toast — no existing classes affected.
41
+
42
+ ### New JS APIs
43
+
44
+ | Module | New methods |
45
+ |---|---|
46
+ | `ppAccordion` | `.get(id).open(index)` · `.close(index)` · `.toggleAll()` |
47
+ | `ppTabs` | `.get(id).activate(index)` |
48
+ | `ppAlert` | `.dismiss(id)` · `[data-alert-dismiss]` attribute wiring |
49
+ | `ppTheme` | `.set('light'\|'dark')` · `.get()` · `.toggle()` |
50
+ | `ppToast` | `.show({ message, variant, duration })` |
51
+
52
+ All shims now dispatch `pp:<component>:<event>` CustomEvents on the root element.