@auriel/peppertino 0.4.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 (139) hide show
  1. package/CHANGELOG.txt +242 -136
  2. package/LICENSE +21 -21
  3. package/MIGRATION.md +52 -0
  4. package/README.md +773 -622
  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 +41 -4
  36. package/dist/accordion.js.map +2 -2
  37. package/dist/alert.js +26 -0
  38. package/dist/alert.js.map +7 -0
  39. package/dist/carousel.js +4 -0
  40. package/dist/carousel.js.map +2 -2
  41. package/dist/header.js +1 -0
  42. package/dist/header.js.map +2 -2
  43. package/dist/main.css +3610 -1343
  44. package/dist/main.css.map +1 -1
  45. package/dist/main.min.css +1 -0
  46. package/dist/modal.js +2 -0
  47. package/dist/modal.js.map +2 -2
  48. package/dist/peppertino.js +244 -15
  49. package/dist/peppertino.js.map +3 -3
  50. package/dist/select.js +2 -4
  51. package/dist/select.js.map +2 -2
  52. package/dist/switch.js +29 -0
  53. package/dist/switch.js.map +7 -0
  54. package/dist/tabs.js +27 -7
  55. package/dist/tabs.js.map +2 -2
  56. package/dist/theme.js +47 -0
  57. package/dist/theme.js.map +7 -0
  58. package/dist/toast.js +69 -0
  59. package/dist/toast.js.map +7 -0
  60. package/dist/validation.js.map +1 -1
  61. package/icon.svg +4 -0
  62. package/index.html +2172 -1902
  63. package/package.json +28 -26
  64. package/scripts/hex-to-hsl.mjs +75 -0
  65. package/scripts/lint-bem.mjs +53 -0
  66. package/scripts/lint-colors.mjs +87 -0
  67. package/site.webmanifest +18 -0
  68. package/src/js/accordion.js +105 -61
  69. package/src/js/alert.js +28 -0
  70. package/src/js/carousel.js +153 -148
  71. package/src/js/header.js +85 -84
  72. package/src/js/modal.js +138 -134
  73. package/src/js/peppertino.js +15 -11
  74. package/src/js/select.js +101 -103
  75. package/src/js/switch.js +28 -0
  76. package/src/js/tabs.js +104 -94
  77. package/src/js/theme.js +47 -0
  78. package/src/js/toast.js +79 -0
  79. package/src/js/validation.js +132 -132
  80. package/src/scss/accordion.scss +190 -156
  81. package/src/scss/activity.scss +17 -0
  82. package/src/scss/alert.scss +203 -204
  83. package/src/scss/badge.scss +90 -0
  84. package/src/scss/base.scss +511 -305
  85. package/src/scss/button.scss +119 -121
  86. package/src/scss/card.scss +121 -121
  87. package/src/scss/carousel.scss +303 -313
  88. package/src/scss/code-block.scss +22 -0
  89. package/src/scss/counter.scss +5 -0
  90. package/src/scss/dark-mode.scss +514 -474
  91. package/src/scss/duration.scss +26 -0
  92. package/src/scss/folder.scss +27 -0
  93. package/src/scss/footer.scss +224 -224
  94. package/src/scss/forms/fieldset.scss +127 -127
  95. package/src/scss/forms/form-instructions.scss +133 -133
  96. package/src/scss/forms/label.scss +115 -115
  97. package/src/scss/forms/text-field.scss +240 -240
  98. package/src/scss/forms/validation.scss +215 -215
  99. package/src/scss/forms.scss +8 -8
  100. package/src/scss/gradient.scss +11 -11
  101. package/src/scss/gravity-letters.scss +7 -0
  102. package/src/scss/header.scss +257 -238
  103. package/src/scss/helpers/color.scss +9 -0
  104. package/src/scss/helpers/flex.scss +14 -0
  105. package/src/scss/helpers/index.scss +6 -0
  106. package/src/scss/helpers/layout.scss +14 -0
  107. package/src/scss/helpers/spacing.scss +14 -0
  108. package/src/scss/helpers/typography.scss +11 -0
  109. package/src/scss/helpers/visibility.scss +9 -0
  110. package/src/scss/main.scss +49 -20
  111. package/src/scss/modal.scss +188 -188
  112. package/src/scss/model-picker.scss +5 -0
  113. package/src/scss/notification.scss +5 -0
  114. package/src/scss/orb.scss +7 -0
  115. package/src/scss/otp.scss +5 -0
  116. package/src/scss/pill-nav.scss +10 -0
  117. package/src/scss/prompt.scss +28 -0
  118. package/src/scss/rail.scss +7 -0
  119. package/src/scss/reactions.scss +5 -0
  120. package/src/scss/reset.scss +84 -84
  121. package/src/scss/response.scss +11 -0
  122. package/src/scss/reveal.scss +5 -0
  123. package/src/scss/scroll-progress.scss +4 -0
  124. package/src/scss/search-results.scss +13 -0
  125. package/src/scss/section.scss +87 -79
  126. package/src/scss/select.scss +210 -210
  127. package/src/scss/sidebar.scss +8 -0
  128. package/src/scss/status.scss +5 -0
  129. package/src/scss/step-list.scss +13 -0
  130. package/src/scss/switch.scss +121 -0
  131. package/src/scss/table.scss +89 -89
  132. package/src/scss/tabs.scss +156 -156
  133. package/src/scss/task-list.scss +18 -0
  134. package/src/scss/theme-picker.scss +5 -0
  135. package/src/scss/toast.scss +170 -0
  136. package/src/scss/tooltip.scss +126 -0
  137. package/src/scss/typography.scss +58 -58
  138. package/src/scss/utilities.scss +243 -243
  139. package/src/scss/voice-note.scss +5 -0
package/CHANGELOG.txt CHANGED
@@ -1,136 +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.4.0 — 2026-06-11
9
- ─────────────────────────────────────────────────────────────────────────────
10
-
11
- New components
12
- - Accordion CSS max-height transition; variants: --flush, --dark, --primary.
13
- JS shim adds aria-expanded, aria-hidden, keyboard navigation
14
- (↑ ↓ Home End), and data-allow-multiple for multi-open mode.
15
- - Alert Inline feedback messages; variants: --info, --success,
16
- --warning, --error, --primary, --neutral; modifier: --filled.
17
- .is-dismissible + .pp-alert__dismiss button; .is-dismissing
18
- triggers slide-out animation before DOM removal.
19
-
20
- Utilities
21
- - New utilities layer (utilities.scss) — single-purpose classes with no JS:
22
- Display .d-{block|inline|inline-block|flex|inline-flex|
23
- grid|inline-grid|none|contents}
24
- Visibility .visible .invisible .sr-only .not-sr-only
25
- Opacity .opacity-{0|25|50|75|100}
26
- Margin .m-* .mt-* .mb-* .ml-* .mr-* .mx-* .my-* (keys 0-32, auto)
27
- Padding .p-* .pt-* .pb-* .pl-* .pr-* .px-* .py-* (keys 0-32)
28
- Gap .gap-* .gap-x-* .gap-y-* (keys 0-32)
29
- Flex direction, wrap, grow/shrink, justify-content, align-items,
30
- align-self
31
- Grid .grid-cols-{1-6,12}, .grid-rows-{1-4}, .col-span-*,
32
- .row-span-*
33
- Width .w-full .w-screen .w-auto .w-fit .w-min .w-max .w-half
34
- Height .h-full .h-screen .h-auto .h-fit
35
- Overflow .overflow-{auto|hidden|visible|scroll}, x/y variants
36
- Position .static .relative .absolute .fixed .sticky
37
- Z-index .z-{below|base|raised|overlay|modal|toast|tooltip}
38
- Border-radius .rounded-{none|sm|base|md|lg|xl|2xl|full}
39
- Shadow .shadow-{none|sm|md|lg|xl}
40
- Cursor .cursor-{default|pointer|not-allowed|grab|text}
41
- Pointer .pointer-events-{none|auto}
42
- User-select .select-{none|text|all|auto}
43
- Responsive .sm-d-* .md-d-* .lg-d-* .xl-d-* .w2xl-d-* (display only)
44
-
45
- Dark mode
46
- - Class-based dark mode via .dark on <html> or any ancestor.
47
- Never prefers-color-scheme. JS toggle persists preference to localStorage.
48
- - All design tokens in base.scss now exposed as CSS custom properties on :root
49
- (--pp-neutral-*, --pp-surface, --pp-on-surface, --pp-border,
50
- --pp-bg-card, --pp-bg-input, --pp-bg-select*, --pp-bg-header*,
51
- --pp-bg-footer, --pp-bg-dropdown, --pp-glass-border, --pp-glass-hover,
52
- --pp-shadow-*, --pp-label-*, --pp-section-muted-bg, etc.).
53
- - dark-mode.scss overrides all tokens under .dark: neutral scale fully
54
- inverted (50 <-> 900), surface/on-surface swapped, shadows strengthened,
55
- glass values darkened.
56
- - Component SCSS updated to consume CSS vars instead of hardcoded literals:
57
- card, accordion, table, header, footer, section, select, forms/fieldset,
58
- forms/text-field, forms/validation.
59
- - Demo page: moon/sun toggle added to header. Every component section now
60
- shows a .dark-wrapped preview pane alongside the light demo.
61
-
62
- Bug fixes / polish
63
- - Table row borders: were using static $color-neutral-200 SCSS var (light
64
- only); replaced with var(--pp-border) so they flip correctly in dark mode.
65
- - Utilities demo: inline code chips and container backgrounds were hardcoded
66
- #f4f4f5; replaced with var(--pp-neutral-100) / var(--pp-neutral-200).
67
- - Changelog section: hardcoded text colors replaced with CSS vars.
68
- - dark-mode.scss: attribute selector overrides for inline-style colors
69
- (#71717a, #52525b, #18181b) used on section labels in the demo page.
70
-
71
- ─────────────────────────────────────────────────────────────────────────────
72
- v0.3.0 — 2026-06-05
73
- ─────────────────────────────────────────────────────────────────────────────
74
-
75
- New components
76
- - Carousel CSS scroll-snap driven; variants: --peek-2, --peek-3,
77
- --dark, --flush; ppCarousel JS API (goTo, prev, next).
78
- - Footer Multi-column layout; variants: --dark, --accent; CSS only.
79
- - Forms Five new form partials:
80
- Fieldset .pp-fieldset + .pp-legend; variants: --ghost, --filled,
81
- --primary, --error; legend modifiers: --sm, --lg, --inline.
82
- Form Instr. .pp-form-instructions -- pre-form block for screen reader
83
- Forms Mode; variants: --neutral, --warning, --error.
84
- .pp-form-hint and .pp-form-required-note helpers.
85
- Label .pp-label -- four-tier importance system (primary to
86
- quaternary); Apple Dynamic Type scale (headline to caption);
87
- --selectable, --truncate, icon row.
88
- Text Field .pp-field -- label + input/textarea + hint + required abbr +
89
- validation states (--error, --success, --warning,
90
- --validating); sizes --sm / --lg; icon wrap; char counter.
91
- Validation :valid/:invalid opt-in, aria-invalid selectors, async
92
- spinner, .pp-validation-summary with role="alert",
93
- .pp-confirm CSS :has() gated submit; ppValidation JS API.
94
-
95
- Breakpoints
96
- - Added respond-below() and respond-between() mixins.
97
- - Apple device breakpoint map: 12 named entries from iphone-se to imac.
98
-
99
- Icons
100
- - Switched from Feather Icons to Lucide Icons (lucide.createIcons()).
101
-
102
- Demo
103
- - Installation, Carousel, Footer, and Forms sections added to index.html.
104
- - Header nav: Components and Forms dropdowns; A-to-Z component ordering.
105
- - Changelog section added to demo page.
106
-
107
- ─────────────────────────────────────────────────────────────────────────────
108
- v0.2.0 — 2026-06-01
109
- ─────────────────────────────────────────────────────────────────────────────
110
-
111
- Accessibility -- full ARIA pass across all components
112
- - Header role="menubar" / "menu" / "menuitem"; aria-haspopup +
113
- aria-expanded on dropdown triggers; aria-hidden on mobile drawer.
114
- - Modal role="dialog" + aria-modal; aria-labelledby + aria-describedby
115
- auto-wired by JS; focus trap on open; focus restored on close.
116
- - Select role="combobox" / "listbox" / "option" + aria-selected;
117
- aria-activedescendant kept in sync with keyboard focus.
118
- - Tabs role="tablist"; aria-controls to panel ids; Home / End keyboard
119
- shortcuts.
120
- - CSS ARIA attribute states are first-class selectors -- visual state
121
- driven by aria-expanded / aria-selected / aria-hidden rather
122
- than class names alone.
123
- - Demo Section order updated: Hero -> Colors -> Typography ->
124
- Components (A-to-Z).
125
-
126
- ─────────────────────────────────────────────────────────────────────────────
127
- v0.1.1 — initial release
128
- ─────────────────────────────────────────────────────────────────────────────
129
-
130
- - Reset, base tokens, button, card, gradient text, header, modal, section,
131
- select, table, tabs, typography.
132
- - Progressive enhancement -- CSS-only baseline; JS adds keyboard navigation,
133
- animations, and outside-click close.
134
- - Inter + Kode Mono via Google Fonts.
135
- - esbuild bundler with per-component JS files + peppertino.js aggregator.
136
- - 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.
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.