@auriel/peppertino 0.6.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.
package/CHANGELOG.txt CHANGED
@@ -4,6 +4,13 @@ PeppertinoCSS — Changelog
4
4
  All notable changes are documented here in reverse chronological order.
5
5
  Versioning follows semver. Dates are YYYY-MM-DD.
6
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
+
7
14
  ------------------------------------------------------------------------
8
15
  v0.6.0 — 2026-11-22
9
16
  ------------------------------------------------------------------------
package/README.md CHANGED
@@ -93,6 +93,10 @@ cp -r agents/peppertino ~/.claude/skills/peppertino
93
93
  | `button.md` | All button variants |
94
94
  | `card.md` | Card parts, variants, grid |
95
95
  | `catalog.md` | Standalone display, navigation, input, feedback, and AI/search patterns |
96
+ | `components-display.md` | Display and feedback components, motion and accessibility guidance |
97
+ | `components-navigation.md` | Standalone navigation and progress patterns |
98
+ | `components-inputs.md` | Native input patterns and optional application behavior |
99
+ | `components-ai-search.md` | Response and search presentation, streaming and privacy |
96
100
  | `carousel.md` | Carousel markup, API, keyboard |
97
101
  | `footer.md` | Footer columns, social links |
98
102
  | `forms-fieldset.md` | Fieldset & legend |
@@ -150,6 +154,40 @@ The skill's `skill.md` enforces ARIA and WCAG AA compliance rules and instructs
150
154
  | `tooltip.scss` | `.pp-tooltip` — CSS-only tooltip; placements `--top/bottom/left/right` |
151
155
  | `typography.scss` | Utility classes for font, size, weight, spacing |
152
156
  | `utilities.scss` | Single-purpose layout/spacing/display/visibility classes |
157
+ | `main.scss` | Full framework entry point |
158
+ | `activity.scss` | Contribution or activity grid presentation |
159
+ | `code-block.scss` | Code display with an optional header |
160
+ | `counter.scss` | Numeric value presentation |
161
+ | `duration.scss` | Native hours and minutes inputs |
162
+ | `folder.scss` | Native folder-style disclosure |
163
+ | `gravity-letters.scss` | Optional decorative letter motion |
164
+ | `model-picker.scss` | Native model selection styling |
165
+ | `notification.scss` | Notification link or button with a count |
166
+ | `orb.scss` | Decorative orb and grid/matrix variants |
167
+ | `otp.scss` | One-time-code input styling |
168
+ | `pill-nav.scss` | Pill-style navigation links |
169
+ | `prompt.scss` | Prompt textarea and action area |
170
+ | `rail.scss` | Table-of-contents navigation rail |
171
+ | `reactions.scss` | Native reaction selection controls |
172
+ | `response.scss` | Response content surface |
173
+ | `reveal.scss` | Content presentation surface |
174
+ | `scroll-progress.scss` | Native progress indicator styling |
175
+ | `search-results.scss` | Search result list presentation |
176
+ | `sidebar.scss` | Vertical navigation links |
177
+ | `status.scss` | Inline status indicator and label |
178
+ | `step-list.scss` | Ordered process steps and current state |
179
+ | `task-list.scss` | Native checkbox task list |
180
+ | `theme-picker.scss` | Native appearance selection controls |
181
+ | `voice-note.scss` | Container for native audio playback |
182
+ | `helpers/index.scss` | Entry point for all modular helper families |
183
+ | `helpers/color.scss` | Text, background, and border color helpers |
184
+ | `helpers/flex.scss` | Additional flex alignment, order, and basis helpers |
185
+ | `helpers/layout.scss` | Sizing, aspect ratio, overflow, and layout helpers |
186
+ | `helpers/spacing.scss` | Logical spacing helpers |
187
+ | `helpers/typography.scss` | Text alignment, wrapping, and typography helpers |
188
+ | `helpers/visibility.scss` | Responsive visibility and accessible hiding helpers |
189
+
190
+ The standalone component and helper modules can be imported individually. See the [component guide](agents/peppertino/catalog.md) and [helper reference](agents/peppertino/utilities.md) for markup, module imports, and behavior.
153
191
 
154
192
  ### JS components (`src/js/`)
155
193
 
@@ -9,7 +9,15 @@ This directory contains per-component reference documents for AI agents and tool
9
9
 
10
10
  ## Index
11
11
 
12
- For the additional standalone HTML-first modules, see [catalog.md](catalog.md).
12
+ For standalone component markup and imports, see [catalog.md](catalog.md). Read the focused references relevant to the task:
13
+
14
+ - [components-display.md](components-display.md): folder, code, activity, counter, steps, status, notifications, audio, and decorative effects.
15
+ - [components-navigation.md](components-navigation.md): sidebar, rail, pill navigation, and progress.
16
+ - [components-inputs.md](components-inputs.md): duration, OTP, theme, tasks, reactions, model picker, and prompt.
17
+ - [components-ai-search.md](components-ai-search.md): response and search presentation, streaming and privacy boundaries.
18
+ - [utilities.md](utilities.md): individually importable helper families and accessible visibility.
19
+
20
+ Prefer native HTML behavior and modular SCSS. Do not introduce a dependency on Peppertino's JavaScript for new component styling; consumer scripts are optional and replaceable. Use short transitions that respect reduced motion; any new keyframe animation uses three points.
13
21
 
14
22
  | File | Covers |
15
23
  |---|---|
@@ -2,6 +2,8 @@
2
2
 
3
3
  These original Peppertino patterns cover component types surveyed in [Rare UI's catalog](https://www.rareui.com/components). Each is a separate `src/scss/<name>.scss` module with fallback colors. Import a module by itself or use `main.scss`; no JavaScript or other component stylesheet is required. Peppertino's `--pp-*` tokens override the fallbacks when available. HTML examples below require unique IDs where indicated. Native HTML provides the interactions described; applications own any data loading, persistence, submission, or updating.
4
4
 
5
+ For detailed accessibility, HIG, and JavaScript guidance, see [display and feedback](components-display.md), [navigation](components-navigation.md), [inputs](components-inputs.md), and [AI and search](components-ai-search.md). See [utilities](utilities.md) for the modular helper families.
6
+
5
7
  ## Display
6
8
 
7
9
  ```html
@@ -0,0 +1,10 @@
1
+ # Response, search, and application-owned behavior
2
+
3
+ `response.scss` and `search-results.scss` are standalone presentation modules. `prompt.scss` and `model-picker.scss` are covered in [components-inputs.md](components-inputs.md); complete markup is in [catalog.md](catalog.md). Consult Apple's [design principles](https://developer.apple.com/design/human-interface-guidelines/design-principles), [writing](https://developer.apple.com/design/human-interface-guidelines/writing), and [privacy](https://developer.apple.com/design/human-interface-guidelines/privacy) as relevant to the product.
4
+
5
+ - `.pp-response` provides a surface for response content; it does not fetch, stream, parse, sanitize, or announce it. Render untrusted text safely, preserve readable content without animation, and provide a concise separate status for completion or errors instead of announcing every streamed token.
6
+ - `.pp-search-results` provides a styled container and list spacing. It does not query a search service, rank results, or generate links. Use meaningful links, identify the results region, and provide useful loading, empty, and error states when applicable.
7
+ - Form actions, model choices, streaming, search, persistence, and backend validation belong to the consuming application. Use semantic HTML and a real server endpoint where appropriate so the baseline can remain usable without JavaScript; scripts are replaceable enhancements, not a requirement for styling.
8
+ - Make network and privacy behavior clear when it matters to a person's choice. Do not present mock output as a live result, place secrets in client-side markup, or imply that the CSS implements an AI or search service.
9
+
10
+ Use short, purposeful transitions with reduced-motion support. New keyframe animations, if needed, use three points; avoid blocking reading or input while effects run.
@@ -0,0 +1,19 @@
1
+ # Display and feedback components
2
+
3
+ Use with [catalog.md](catalog.md), which contains working markup. Each named module is an independently importable `src/scss/<name>.scss`; these modules do not ship JavaScript. Apply the [HIG design principles](https://developer.apple.com/design/human-interface-guidelines/design-principles), [accessibility](https://developer.apple.com/design/human-interface-guidelines/accessibility), and [motion](https://developer.apple.com/design/human-interface-guidelines/motion) guidance to the actual platform and task.
4
+
5
+ | Module | What the CSS supplies | Consumer behavior |
6
+ |---|---|---|
7
+ | `folder` | `.pp-folder` disclosure surface and header | Use native `details` / `summary`; no script needed for toggling. |
8
+ | `code-block` | `.pp-code-block`, header and scrollable `pre` | Render escaped code; syntax highlighting or clipboard actions require application code. Do not show an inert copy button. |
9
+ | `activity` | `.pp-activity__grid` and `.pp-activity__day[data-level]` levels 0–4 | Supply data and an accessible text summary or table; color alone must not convey values. |
10
+ | `counter` | `.pp-counter` numeric styling | Supply an accurate text value. Any interpolation is optional; do not announce every animation frame. |
11
+ | `step-list` | `.pp-step-list` and `aria-current="step"` emphasis | Supply ordered steps and current state; it does not advance or navigate by itself. |
12
+ | `status` | `.pp-status` and `.pp-status__indicator` | Keep a meaningful textual status. Use a polite status region when updates should be announced. |
13
+ | `notification` | `.pp-notification` and count badge | Supply a real destination or action and an accessible name including the unread count; update both count and name together. |
14
+ | `voice-note` | `.pp-voice-note` container | Use native `<audio controls>` with an accessible label and a fallback link; loading and recording are application responsibilities. |
15
+ | `orb` | Decorative `.pp-orb`, `--grid`, `--matrix`, and `--pp-orb-size` | Mark purely decorative graphics `aria-hidden`; do not rely on them to communicate status. |
16
+ | `reveal` | `.pp-reveal` content surface | Content is visible by default. Effects are application-owned and must not hide essential information without script. |
17
+ | `gravity-letters` | `.pp-gravity-letters` and `__letter` hover transitions | Preserve a readable accessible name, hide duplicate decorative letters from assistive technology, and keep text legible without motion. |
18
+
19
+ Keep motion brief and purposeful. Respect `prefers-reduced-motion`; if authoring keyframes, use exactly three keyframe points. CSS defines presentation; consumers may add or replace scripts without altering the baseline. Test readable text, zoom, keyboard focus, reduced motion, and light/dark contrast. Validate real assistive technology behavior before claiming compliance.
@@ -0,0 +1,15 @@
1
+ # Input and choice components
2
+
3
+ Use the examples in [catalog.md](catalog.md). Each module is separately importable and has no bundled JavaScript. Apply Apple's [text field](https://developer.apple.com/design/human-interface-guidelines/text-fields), [entering data](https://developer.apple.com/design/human-interface-guidelines/entering-data), and [accessibility](https://developer.apple.com/design/human-interface-guidelines/accessibility) guidance, adapting it to the web and target platform.
4
+
5
+ | Module | Native baseline | Consumer responsibilities |
6
+ |---|---|---|
7
+ | `duration` | `.pp-duration` fieldset with labelled number inputs and native min/max validation. | Choose sensible limits and validate on the server; do not assume CSS clamps values. Preserve keyboard and spinner operation. |
8
+ | `otp` | `.pp-otp` styles one labelled input; `autocomplete="one-time-code"` and `inputmode="numeric"` can assist entry. | Preserve leading zeros and paste/autofill; validate the intended format. Avoid splitting input unless there is a demonstrated need. |
9
+ | `theme-picker` | `.pp-theme-picker` styles a radio group. | Apply and persist the selection in application code; without it the form still collects the choice. Do not claim it switches themes by itself. |
10
+ | `task-list` | `.pp-task-list` styles checkboxes and checked text. | Persist or submit changes in application code; associate each checkbox with its label. |
11
+ | `reactions` | `.pp-reactions` styles native labelled radio controls. | Save or submit the choice and supply textual labels alongside emoji. |
12
+ | `model-picker` | `.pp-model-picker` styles a native `<select>`. | Supply accurate options, a visible label, and application behavior for the selection. |
13
+ | `prompt` | `.pp-prompt` styles a label, textarea, and `__actions`. | Use a real form and endpoint for no-script submission when feasible; script-driven submission must preserve keyboard use, validation, and error feedback. |
14
+
15
+ Use visible persistent labels, appropriate input types and autocomplete, and text errors associated with the field. Placeholder text is supplemental. Give controls room at large text sizes and avoid relying on color to convey errors. Keep application code replaceable: attach behavior to semantic markup or documented classes, do not make the SCSS depend on a framework or a particular script. Do not insert credentials or personal data into client-side examples.
@@ -0,0 +1,12 @@
1
+ # Navigation and progress components
2
+
3
+ See [catalog.md](catalog.md) for markup. `sidebar`, `rail`, `pill-nav`, and `scroll-progress` are separate SCSS modules with no JavaScript dependency. Follow Apple's [layout](https://developer.apple.com/design/human-interface-guidelines/layout), [navigation](https://developer.apple.com/design/human-interface-guidelines/navigation), and [accessibility](https://developer.apple.com/design/human-interface-guidelines/accessibility) guidance where relevant.
4
+
5
+ | Module | Baseline | Optional application behavior |
6
+ |---|---|---|
7
+ | `sidebar` | `.pp-sidebar` styles ordinary links; `aria-current="page"` marks the current page. | Routing may update the current page; pointer proximity must never be required to reveal or use links. |
8
+ | `rail` | `.pp-rail` styles an ordered list of in-page anchors. | Update `aria-current` as the visible section changes if scroll tracking is implemented. |
9
+ | `pill-nav` | `.pp-pill-nav` styles links and `aria-current="page"`. | Navigation follows normal link behavior; this is not a tab widget or a script-driven tablist. |
10
+ | `scroll-progress` | `.pp-scroll-progress` styles a native `<progress>`. | Compute and update its `value` if reporting live progress. A static value does not track scrolling automatically; omit `value` for an indeterminate progress indicator. |
11
+
12
+ Give navigation landmarks distinguishable accessible names and links real destinations. Keep source, reading, and focus order coherent; use text or another non-color distinction for the active state. Layout should adapt to available width and text size, rather than infer a device from viewport width. Ensure destinations work with script disabled where possible. Do not add ARIA roles or keyboard overrides that conflict with native links or `<progress>`.
package/index.html CHANGED
@@ -6,7 +6,7 @@
6
6
  <meta name="theme-color" content="#e90111" />
7
7
  <link rel="manifest" href="./site.webmanifest" />
8
8
  <link rel="icon" href="./icon.svg" type="image/svg+xml" />
9
- <title>PeppertinoCSS 0.6.0 — Dev Sandbox</title>
9
+ <title>PeppertinoCSS 0.6.1 — Dev Sandbox</title>
10
10
  <link rel="stylesheet" href="dist/main.css?v=1780286329" />
11
11
  <script src="https://unpkg.com/lucide@latest/dist/umd/lucide.min.js"></script>
12
12
  <script src="dist/peppertino.js" defer></script>
@@ -2012,6 +2012,11 @@ const greet = (name) =&gt; `Hello, ${name}!`;</code></pre>
2012
2012
  <div class="pp-section__inner text-left" style="align-items:flex-start;max-width:720px;">
2013
2013
  <h2 class="font-sans font-700 tracking-tight">Changelog</h2>
2014
2014
 
2015
+ <div style="margin-top:2rem;">
2016
+ <p class="font-sans font-600 text-lg">v0.6.1 <span class="font-400 text-sm">— 2026-11-22</span></p>
2017
+ <p>Completed the source inventory and added focused agent guidance for components, accessibility, and optional application behavior.</p>
2018
+ </div>
2019
+
2015
2020
  <div style="margin-top:2rem;">
2016
2021
  <p class="font-sans font-600 text-lg">v0.6.0 <span class="font-400 text-sm">— unreleased</span></p>
2017
2022
  <p>Added standalone HTML-first component patterns and modular helper families, with native controls and optional application behavior.</p>
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@auriel/peppertino",
3
- "version": "0.6.0",
3
+ "version": "0.6.1",
4
4
  "description": "An Apple-inspired CSS framework with a spicy red accent. Clean geometry, restrained elegance, zero Cupertino lawsuits.",
5
5
  "repository": {
6
6
  "type": "git",