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