@auriel/peppertino 0.5.0 → 0.6.1

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 (134) hide show
  1. package/CHANGELOG.txt +249 -224
  2. package/LICENSE +21 -21
  3. package/MIGRATION.md +52 -52
  4. package/README.md +811 -764
  5. package/agents/peppertino/SKILL.md +84 -0
  6. package/agents/peppertino/accordion.md +134 -0
  7. package/agents/peppertino/alert.md +116 -0
  8. package/agents/peppertino/badge.md +74 -0
  9. package/agents/peppertino/base.md +252 -0
  10. package/agents/peppertino/button.md +65 -0
  11. package/agents/peppertino/card.md +82 -0
  12. package/agents/peppertino/carousel.md +147 -0
  13. package/agents/peppertino/catalog.md +83 -0
  14. package/agents/peppertino/components-ai-search.md +10 -0
  15. package/agents/peppertino/components-display.md +19 -0
  16. package/agents/peppertino/components-inputs.md +15 -0
  17. package/agents/peppertino/components-navigation.md +12 -0
  18. package/agents/peppertino/dark-mode.md +152 -0
  19. package/agents/peppertino/footer.md +109 -0
  20. package/agents/peppertino/forms-fieldset.md +85 -0
  21. package/agents/peppertino/forms-form-instructions.md +94 -0
  22. package/agents/peppertino/forms-label.md +110 -0
  23. package/agents/peppertino/forms-text-field.md +134 -0
  24. package/agents/peppertino/forms-validation.md +153 -0
  25. package/agents/peppertino/gradient.md +41 -0
  26. package/agents/peppertino/header.md +105 -0
  27. package/agents/peppertino/modal.md +123 -0
  28. package/agents/peppertino/section.md +56 -0
  29. package/agents/peppertino/select.md +110 -0
  30. package/agents/peppertino/switch.md +72 -0
  31. package/agents/peppertino/table.md +69 -0
  32. package/agents/peppertino/tabs.md +115 -0
  33. package/agents/peppertino/toast.md +96 -0
  34. package/agents/peppertino/tooltip.md +111 -0
  35. package/agents/peppertino/typography.md +118 -0
  36. package/agents/peppertino/utilities.md +194 -0
  37. package/agents/skill.md +65 -0
  38. package/build.js +53 -53
  39. package/dist/accordion.js +1 -1
  40. package/dist/accordion.js.map +2 -2
  41. package/dist/alert.js.map +1 -1
  42. package/dist/carousel.js.map +1 -1
  43. package/dist/header.js.map +1 -1
  44. package/dist/main.css +2566 -1008
  45. package/dist/main.css.map +1 -1
  46. package/dist/main.min.css +1 -0
  47. package/dist/modal.js.map +1 -1
  48. package/dist/peppertino.js +1 -1
  49. package/dist/peppertino.js.map +2 -2
  50. package/dist/select.js.map +1 -1
  51. package/dist/switch.js.map +1 -1
  52. package/dist/tabs.js.map +1 -1
  53. package/dist/theme.js.map +1 -1
  54. package/dist/toast.js.map +1 -1
  55. package/dist/validation.js.map +1 -1
  56. package/icon.svg +4 -0
  57. package/index.html +2177 -2098
  58. package/package.json +28 -28
  59. package/scripts/hex-to-hsl.mjs +75 -75
  60. package/scripts/lint-bem.mjs +53 -53
  61. package/scripts/lint-colors.mjs +87 -87
  62. package/site.webmanifest +18 -0
  63. package/src/js/accordion.js +105 -103
  64. package/src/js/alert.js +28 -28
  65. package/src/js/carousel.js +153 -153
  66. package/src/js/header.js +85 -85
  67. package/src/js/modal.js +138 -138
  68. package/src/js/peppertino.js +15 -15
  69. package/src/js/select.js +101 -101
  70. package/src/js/switch.js +28 -28
  71. package/src/js/tabs.js +104 -104
  72. package/src/js/theme.js +47 -47
  73. package/src/js/toast.js +79 -79
  74. package/src/js/validation.js +132 -132
  75. package/src/scss/accordion.scss +190 -156
  76. package/src/scss/activity.scss +17 -0
  77. package/src/scss/alert.scss +203 -203
  78. package/src/scss/badge.scss +90 -90
  79. package/src/scss/base.scss +511 -506
  80. package/src/scss/button.scss +119 -119
  81. package/src/scss/card.scss +121 -121
  82. package/src/scss/carousel.scss +303 -303
  83. package/src/scss/code-block.scss +22 -0
  84. package/src/scss/counter.scss +5 -0
  85. package/src/scss/dark-mode.scss +514 -514
  86. package/src/scss/duration.scss +26 -0
  87. package/src/scss/folder.scss +27 -0
  88. package/src/scss/footer.scss +224 -224
  89. package/src/scss/forms/fieldset.scss +127 -127
  90. package/src/scss/forms/form-instructions.scss +133 -133
  91. package/src/scss/forms/label.scss +115 -115
  92. package/src/scss/forms/text-field.scss +240 -240
  93. package/src/scss/forms/validation.scss +215 -215
  94. package/src/scss/forms.scss +8 -8
  95. package/src/scss/gradient.scss +11 -11
  96. package/src/scss/gravity-letters.scss +7 -0
  97. package/src/scss/header.scss +257 -238
  98. package/src/scss/helpers/color.scss +9 -0
  99. package/src/scss/helpers/flex.scss +14 -0
  100. package/src/scss/helpers/index.scss +6 -0
  101. package/src/scss/helpers/layout.scss +14 -0
  102. package/src/scss/helpers/spacing.scss +14 -0
  103. package/src/scss/helpers/typography.scss +11 -0
  104. package/src/scss/helpers/visibility.scss +9 -0
  105. package/src/scss/main.scss +49 -24
  106. package/src/scss/modal.scss +188 -188
  107. package/src/scss/model-picker.scss +5 -0
  108. package/src/scss/notification.scss +5 -0
  109. package/src/scss/orb.scss +7 -0
  110. package/src/scss/otp.scss +5 -0
  111. package/src/scss/pill-nav.scss +10 -0
  112. package/src/scss/prompt.scss +28 -0
  113. package/src/scss/rail.scss +7 -0
  114. package/src/scss/reactions.scss +5 -0
  115. package/src/scss/reset.scss +84 -84
  116. package/src/scss/response.scss +11 -0
  117. package/src/scss/reveal.scss +5 -0
  118. package/src/scss/scroll-progress.scss +4 -0
  119. package/src/scss/search-results.scss +13 -0
  120. package/src/scss/section.scss +87 -79
  121. package/src/scss/select.scss +210 -210
  122. package/src/scss/sidebar.scss +8 -0
  123. package/src/scss/status.scss +5 -0
  124. package/src/scss/step-list.scss +13 -0
  125. package/src/scss/switch.scss +121 -121
  126. package/src/scss/table.scss +89 -89
  127. package/src/scss/tabs.scss +156 -156
  128. package/src/scss/task-list.scss +18 -0
  129. package/src/scss/theme-picker.scss +5 -0
  130. package/src/scss/toast.scss +170 -170
  131. package/src/scss/tooltip.scss +126 -126
  132. package/src/scss/typography.scss +58 -58
  133. package/src/scss/utilities.scss +243 -243
  134. package/src/scss/voice-note.scss +5 -0
package/CHANGELOG.txt CHANGED
@@ -1,224 +1,249 @@
1
- PeppertinoCSS — Changelog
2
- =========================
3
-
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
- ─────────────────────────────────────────────────────────────────────────────
98
-
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
- ─────────────────────────────────────────────────────────────────────────────
162
-
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.
182
-
183
- Breakpoints
184
- - Added respond-below() and respond-between() mixins.
185
- - Apple device breakpoint map: 12 named entries from iphone-se to imac.
186
-
187
- Icons
188
- - Switched from Feather Icons to Lucide Icons (lucide.createIcons()).
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.
194
-
195
- ─────────────────────────────────────────────────────────────────────────────
196
- v0.2.0 — 2026-06-01
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
- ─────────────────────────────────────────────────────────────────────────────
215
- v0.1.1 — initial release
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).
1
+ PeppertinoCSS — Changelog
2
+ =========================
3
+
4
+ All notable changes are documented here in reverse chronological order.
5
+ Versioning follows semver. Dates are YYYY-MM-DD.
6
+
7
+ ------------------------------------------------------------------------
8
+ v0.6.1 — 2026-11-22
9
+ ------------------------------------------------------------------------
10
+
11
+ - Completed the README source inventory and added focused agent references
12
+ for display, navigation, inputs, AI/search, accessibility, and optional JS.
13
+
14
+ ------------------------------------------------------------------------
15
+ v0.6.0 — 2026-11-22
16
+ ------------------------------------------------------------------------
17
+
18
+ - Added independently importable, HTML-first component styles for display,
19
+ navigation, form, feedback, and AI/search presentation patterns.
20
+ - Added modular color, logical spacing, flex, typography, layout, and
21
+ visibility helper families with standalone token fallbacks.
22
+ - Added component and helper documentation, plus demo examples. Native
23
+ controls work without JavaScript; application-specific behavior is separate.
24
+ - Ignored local Codex configuration and skill files.
25
+ - Styled duration inputs and prompt labels across browsers; improved safe-area
26
+ padding and enabled named Apple-width and 1920 CSS-pixel WUXGA mixins.
27
+ - Added short, reduced-motion-aware interaction transitions and a demo web manifest.
28
+ - Improved accordion motion for natural-height content and added native,
29
+ JavaScript-free details/summary support.
30
+ - Organized the demo examples into component, form, color, and utility sections.
31
+
32
+ ─────────────────────────────────────────────────────────────────────────────
33
+ v0.5.0 — 2026-06-18
34
+ ─────────────────────────────────────────────────────────────────────────────
35
+
36
+ BEM naming (BREAKING — see MIGRATION.md)
37
+ - All component classes are now prefixed with pp-:
38
+ .button -> .pp-button
39
+ .gradient-txt -> .pp-gradient-text
40
+ - Modifier combiners confirmed: .pp-button--outline.pp-button--success (no
41
+ compound hyphen classes like .pp-button-outline-success).
42
+
43
+ HSL color token system
44
+ - base.scss: every color token decomposed into H/S/L channel properties plus
45
+ a composite shorthand. Pattern for each token:
46
+ --pp-primary-h: 356;
47
+ --pp-primary-s: 99.2%;
48
+ --pp-primary-l: 46.3%;
49
+ --pp-primary: hsl(var(--pp-primary-h) var(--pp-primary-s) var(--pp-primary-l));
50
+ - Alpha tints no longer use rgba($color-*, alpha); all component SCSS uses:
51
+ hsl(var(--pp-*-h) var(--pp-*-s) var(--pp-*-l) / 0.15)
52
+ - dark-mode.scss overrides at channel level (--pp-neutral-800-l: 95.9%) so
53
+ a single property change cascades to all consumers of that token.
54
+ - New dark shade tokens: --pp-success-900, --pp-warning-900, --pp-error-900,
55
+ --pp-info-900 for alert text colors that previously used hardcoded hex.
56
+ - All component SCSS files fully migrated: accordion, alert, button, card,
57
+ carousel, footer, forms (fieldset / form-instructions / text-field /
58
+ validation), gradient, header, modal, section, select, tabs, toast, tooltip.
59
+ - lint-colors.mjs enforces the ban on SCSS color vars and 6-digit hex in all
60
+ component files (base.scss and dark-mode.scss are exempted).
61
+
62
+ New components
63
+ - Badge Pill status indicators; variants: --primary/success/warning/
64
+ error/info; modifier: --filled; sizes: --sm, --lg; --dot for
65
+ 8x8 presence/count circles. CSS-only, no JS.
66
+ - Switch iOS-style toggle; sizes: --sm, --lg. aria-checked drives visual
67
+ state (track color + thumb translateX). JS wires toggle on click
68
+ and Space key; dispatches pp:switch:change { checked: boolean }.
69
+ - Toast Auto-dismissing notifications. ppToast.show({ message, title,
70
+ variant, duration, position }). Creates container on demand.
71
+ Variants: neutral/info/success/warning/error. Six positions:
72
+ top/bottom × right/left/center. Progress bar animation.
73
+ duration: 0 for persistent. Events: pp:toast:show,
74
+ pp:toast:dismiss. data-toast-dismiss wires dismiss button.
75
+ - Tooltip CSS-only; no JS. Shows on :hover and :focus-within. Four
76
+ placements: top (default), --bottom, --left, --right. Arrow
77
+ via ::before. data-show to force-display. role="tooltip" on
78
+ content span. Keyboard accessible when trigger is focusable.
79
+
80
+ JS API consistency
81
+ - All CustomEvents renamed to pp:<component>:<event> format:
82
+ pp:accordion:open / pp:accordion:close { index, trigger, panel }
83
+ pp:alert:dismiss
84
+ pp:carousel:change { index, total, label }
85
+ pp:header:open / pp:header:close
86
+ pp:modal:open / pp:modal:close
87
+ pp:select:change { value }
88
+ pp:switch:change { checked }
89
+ pp:tabs:change { index }
90
+ pp:theme:change { theme: 'dark'|'light' }
91
+ pp:toast:show / pp:toast:dismiss
92
+ - ppAccordion.get(ref) -> { open(i), close(i), toggleAll() }
93
+ - ppAlert.dismiss(idOrEl)
94
+ - ppTabs.get(ref).activate(index)
95
+ - ppTheme.set(theme) / .get() / .toggle(); localStorage key: pp-theme;
96
+ data-theme-toggle auto-wired.
97
+ - New files: alert.js, switch.js, theme.js, toast.js.
98
+ - peppertino.js updated to import all new files.
99
+
100
+ Build guardrails
101
+ - scripts/lint-colors.mjs — bans rgba($color-*, ...), rgba($gradient-*, ...),
102
+ and 6-digit hex in all component SCSS. Structural white/black overlays
103
+ (rgba(255,...), rgba(0,0,0,...), #fff, #000, #ffffff) allowed. Exits 1 on
104
+ any violation.
105
+ - scripts/lint-bem.mjs — reads dist/main.css, extracts all .pp-* class
106
+ selectors, validates against BEM regex. Digit-starting modifiers (--2, --3)
107
+ allowed for grid helpers. Exits 1 on any violation.
108
+ - bun run build now runs: build:css && build:js && lint:colors && lint:bem.
109
+ - All package.json scripts migrated to bun (bun run build, bun run dev, etc.).
110
+
111
+ Demo
112
+ - index.html: Badge, Switch, Toast, Tooltip demo sections added.
113
+ - Header nav Components dropdown updated with new entries (Badge, Switch,
114
+ Toast, Tooltip).
115
+
116
+ Skill docs
117
+ - agents/peppertino/: badge.md, switch.md, toast.md, tooltip.md added.
118
+ - SKILL.md index updated with all new entries and corrected stale references.
119
+
120
+ ─────────────────────────────────────────────────────────────────────────────
121
+ v0.4.0 — 2026-06-11
122
+ ─────────────────────────────────────────────────────────────────────────────
123
+
124
+ New components
125
+ - Accordion CSS max-height transition; variants: --flush, --dark, --primary.
126
+ JS shim adds aria-expanded, aria-hidden, keyboard navigation
127
+ (↑ ↓ Home End), and data-allow-multiple for multi-open mode.
128
+ - Alert Inline feedback messages; variants: --info, --success,
129
+ --warning, --error, --primary, --neutral; modifier: --filled.
130
+ .is-dismissible + .pp-alert__dismiss button; .is-dismissing
131
+ triggers slide-out animation before DOM removal.
132
+
133
+ Utilities
134
+ - New utilities layer (utilities.scss) — single-purpose classes with no JS:
135
+ Display .d-{block|inline|inline-block|flex|inline-flex|
136
+ grid|inline-grid|none|contents}
137
+ Visibility .visible .invisible .sr-only .not-sr-only
138
+ Opacity .opacity-{0|25|50|75|100}
139
+ Margin .m-* .mt-* .mb-* .ml-* .mr-* .mx-* .my-* (keys 0-32, auto)
140
+ Padding .p-* .pt-* .pb-* .pl-* .pr-* .px-* .py-* (keys 0-32)
141
+ Gap .gap-* .gap-x-* .gap-y-* (keys 0-32)
142
+ Flex direction, wrap, grow/shrink, justify-content, align-items,
143
+ align-self
144
+ Grid .grid-cols-{1-6,12}, .grid-rows-{1-4}, .col-span-*,
145
+ .row-span-*
146
+ Width .w-full .w-screen .w-auto .w-fit .w-min .w-max .w-half
147
+ Height .h-full .h-screen .h-auto .h-fit
148
+ Overflow .overflow-{auto|hidden|visible|scroll}, x/y variants
149
+ Position .static .relative .absolute .fixed .sticky
150
+ Z-index .z-{below|base|raised|overlay|modal|toast|tooltip}
151
+ Border-radius .rounded-{none|sm|base|md|lg|xl|2xl|full}
152
+ Shadow .shadow-{none|sm|md|lg|xl}
153
+ Cursor .cursor-{default|pointer|not-allowed|grab|text}
154
+ Pointer .pointer-events-{none|auto}
155
+ User-select .select-{none|text|all|auto}
156
+ Responsive .sm-d-* .md-d-* .lg-d-* .xl-d-* .w2xl-d-* (display only)
157
+
158
+ Dark mode
159
+ - Class-based dark mode via .dark on <html> or any ancestor.
160
+ Never prefers-color-scheme. JS toggle persists preference to localStorage.
161
+ - All design tokens in base.scss now exposed as CSS custom properties on :root
162
+ (--pp-neutral-*, --pp-surface, --pp-on-surface, --pp-border,
163
+ --pp-bg-card, --pp-bg-input, --pp-bg-select*, --pp-bg-header*,
164
+ --pp-bg-footer, --pp-bg-dropdown, --pp-glass-border, --pp-glass-hover,
165
+ --pp-shadow-*, --pp-label-*, --pp-section-muted-bg, etc.).
166
+ - dark-mode.scss overrides all tokens under .dark: neutral scale fully
167
+ inverted (50 <-> 900), surface/on-surface swapped, shadows strengthened,
168
+ glass values darkened.
169
+ - Component SCSS updated to consume CSS vars instead of hardcoded literals:
170
+ card, accordion, table, header, footer, section, select, forms/fieldset,
171
+ forms/text-field, forms/validation.
172
+ - Demo page: moon/sun toggle added to header. Every component section now
173
+ shows a .dark-wrapped preview pane alongside the light demo.
174
+
175
+ Bug fixes / polish
176
+ - Table row borders: were using static $color-neutral-200 SCSS var (light
177
+ only); replaced with var(--pp-border) so they flip correctly in dark mode.
178
+ - Utilities demo: inline code chips and container backgrounds were hardcoded
179
+ #f4f4f5; replaced with var(--pp-neutral-100) / var(--pp-neutral-200).
180
+ - Changelog section: hardcoded text colors replaced with CSS vars.
181
+ - dark-mode.scss: attribute selector overrides for inline-style colors
182
+ (#71717a, #52525b, #18181b) used on section labels in the demo page.
183
+
184
+ ─────────────────────────────────────────────────────────────────────────────
185
+ v0.3.0 — 2026-06-05
186
+ ─────────────────────────────────────────────────────────────────────────────
187
+
188
+ New components
189
+ - Carousel CSS scroll-snap driven; variants: --peek-2, --peek-3,
190
+ --dark, --flush; ppCarousel JS API (goTo, prev, next).
191
+ - Footer Multi-column layout; variants: --dark, --accent; CSS only.
192
+ - Forms Five new form partials:
193
+ Fieldset .pp-fieldset + .pp-legend; variants: --ghost, --filled,
194
+ --primary, --error; legend modifiers: --sm, --lg, --inline.
195
+ Form Instr. .pp-form-instructions -- pre-form block for screen reader
196
+ Forms Mode; variants: --neutral, --warning, --error.
197
+ .pp-form-hint and .pp-form-required-note helpers.
198
+ Label .pp-label -- four-tier importance system (primary to
199
+ quaternary); Apple Dynamic Type scale (headline to caption);
200
+ --selectable, --truncate, icon row.
201
+ Text Field .pp-field -- label + input/textarea + hint + required abbr +
202
+ validation states (--error, --success, --warning,
203
+ --validating); sizes --sm / --lg; icon wrap; char counter.
204
+ Validation :valid/:invalid opt-in, aria-invalid selectors, async
205
+ spinner, .pp-validation-summary with role="alert",
206
+ .pp-confirm CSS :has() gated submit; ppValidation JS API.
207
+
208
+ Breakpoints
209
+ - Added respond-below() and respond-between() mixins.
210
+ - Apple device breakpoint map: 12 named entries from iphone-se to imac.
211
+
212
+ Icons
213
+ - Switched from Feather Icons to Lucide Icons (lucide.createIcons()).
214
+
215
+ Demo
216
+ - Installation, Carousel, Footer, and Forms sections added to index.html.
217
+ - Header nav: Components and Forms dropdowns; A-to-Z component ordering.
218
+ - Changelog section added to demo page.
219
+
220
+ ─────────────────────────────────────────────────────────────────────────────
221
+ v0.2.0 — 2026-06-01
222
+ ─────────────────────────────────────────────────────────────────────────────
223
+
224
+ Accessibility -- full ARIA pass across all components
225
+ - Header role="menubar" / "menu" / "menuitem"; aria-haspopup +
226
+ aria-expanded on dropdown triggers; aria-hidden on mobile drawer.
227
+ - Modal role="dialog" + aria-modal; aria-labelledby + aria-describedby
228
+ auto-wired by JS; focus trap on open; focus restored on close.
229
+ - Select role="combobox" / "listbox" / "option" + aria-selected;
230
+ aria-activedescendant kept in sync with keyboard focus.
231
+ - Tabs role="tablist"; aria-controls to panel ids; Home / End keyboard
232
+ shortcuts.
233
+ - CSS ARIA attribute states are first-class selectors -- visual state
234
+ driven by aria-expanded / aria-selected / aria-hidden rather
235
+ than class names alone.
236
+ - Demo Section order updated: Hero -> Colors -> Typography ->
237
+ Components (A-to-Z).
238
+
239
+ ─────────────────────────────────────────────────────────────────────────────
240
+ v0.1.1 — initial release
241
+ ─────────────────────────────────────────────────────────────────────────────
242
+
243
+ - Reset, base tokens, button, card, gradient text, header, modal, section,
244
+ select, table, tabs, typography.
245
+ - Progressive enhancement -- CSS-only baseline; JS adds keyboard navigation,
246
+ animations, and outside-click close.
247
+ - Inter + Kode Mono via Google Fonts.
248
+ - esbuild bundler with per-component JS files + peppertino.js aggregator.
249
+ - Tailwind-compatible breakpoint map (sm / md / lg / xl / 2xl).
package/LICENSE CHANGED
@@ -1,21 +1,21 @@
1
- MIT License
2
-
3
- Copyright (c) 2026 Debaditya Malakar
4
-
5
- Permission is hereby granted, free of charge, to any person obtaining a copy
6
- of this software and associated documentation files (the "Software"), to deal
7
- in the Software without restriction, including without limitation the rights
8
- to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
- copies of the Software, and to permit persons to whom the Software is
10
- furnished to do so, subject to the following conditions:
11
-
12
- The above copyright notice and this permission notice shall be included in all
13
- copies or substantial portions of the Software.
14
-
15
- THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
- IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
- FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
- AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
- LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
- OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
- SOFTWARE.
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Debaditya Malakar
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.