@appica/ui-react 1.3.1 → 1.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (69) hide show
  1. package/CHANGELOG.md +33 -0
  2. package/README.md +8 -2
  3. package/agent-rules.md +9 -2
  4. package/appica.css +2 -2
  5. package/dist/components/badge/badge.js +1 -1
  6. package/dist/components/badge/badge.js.map +1 -1
  7. package/dist/components/button/button-variants.js +1 -1
  8. package/dist/components/button/button-variants.js.map +1 -1
  9. package/dist/components/card/card.js +1 -1
  10. package/dist/components/card/card.js.map +1 -1
  11. package/dist/components/carousel/carousel.d.ts +24 -3
  12. package/dist/components/carousel/carousel.d.ts.map +1 -1
  13. package/dist/components/carousel/carousel.js +149 -31
  14. package/dist/components/carousel/carousel.js.map +1 -1
  15. package/dist/components/checkbox/checkbox.js +1 -1
  16. package/dist/components/checkbox/checkbox.js.map +1 -1
  17. package/dist/components/command-palette/command-palette.d.ts +91 -0
  18. package/dist/components/command-palette/command-palette.d.ts.map +1 -0
  19. package/dist/components/command-palette/command-palette.js +376 -0
  20. package/dist/components/command-palette/command-palette.js.map +1 -0
  21. package/dist/components/date-field/date-field.js +1 -1
  22. package/dist/components/date-field/date-field.js.map +1 -1
  23. package/dist/components/date-picker/date-picker.js +1 -1
  24. package/dist/components/date-picker/date-picker.js.map +1 -1
  25. package/dist/components/input/input-variants.js +2 -2
  26. package/dist/components/input/input-variants.js.map +1 -1
  27. package/dist/components/radio/radio.js +1 -1
  28. package/dist/components/radio/radio.js.map +1 -1
  29. package/dist/components/splitter/splitter.d.ts +57 -0
  30. package/dist/components/splitter/splitter.d.ts.map +1 -0
  31. package/dist/components/splitter/splitter.js +395 -0
  32. package/dist/components/splitter/splitter.js.map +1 -0
  33. package/dist/components/textarea/textarea.js +1 -1
  34. package/dist/components/textarea/textarea.js.map +1 -1
  35. package/dist/components/time-field/time-field.js +1 -1
  36. package/dist/components/time-field/time-field.js.map +1 -1
  37. package/dist/components/toc/toc.d.ts +6 -1
  38. package/dist/components/toc/toc.d.ts.map +1 -1
  39. package/dist/components/toc/toc.js +15 -7
  40. package/dist/components/toc/toc.js.map +1 -1
  41. package/dist/index.d.ts +2 -0
  42. package/dist/index.d.ts.map +1 -1
  43. package/dist/index.js +3 -1
  44. package/dist/index.js.map +1 -1
  45. package/package.json +24 -14
  46. package/src/components/badge/badge.tsx +1 -1
  47. package/src/components/button/button-variants.ts +1 -1
  48. package/src/components/card/card.tsx +1 -1
  49. package/src/components/carousel/carousel.test.tsx +559 -21
  50. package/src/components/carousel/carousel.tsx +195 -40
  51. package/src/components/checkbox/checkbox.tsx +1 -1
  52. package/src/components/command-palette/command-palette.test.tsx +280 -0
  53. package/src/components/command-palette/command-palette.tsx +544 -0
  54. package/src/components/compare-slider/compare-slider.test.tsx +8 -7
  55. package/src/components/date-field/date-field.tsx +1 -1
  56. package/src/components/date-picker/date-picker.tsx +1 -1
  57. package/src/components/input/input-variants.ts +2 -2
  58. package/src/components/radio/radio.tsx +1 -1
  59. package/src/components/rating/rating.test.tsx +10 -3
  60. package/src/components/splitter/splitter.test.tsx +415 -0
  61. package/src/components/splitter/splitter.tsx +555 -0
  62. package/src/components/textarea/textarea.tsx +1 -1
  63. package/src/components/time-field/time-field.tsx +1 -1
  64. package/src/components/toc/toc.test.tsx +15 -0
  65. package/src/components/toc/toc.tsx +22 -7
  66. package/src/index.ts +2 -0
  67. package/src/test/css.ts +9 -0
  68. package/src/test/setup.ts +13 -0
  69. package/styles.css +3 -0
package/CHANGELOG.md CHANGED
@@ -7,6 +7,39 @@ version alongside the package.
7
7
 
8
8
  The library follows [semantic versioning](https://semver.org/spec/v2.0.0.html).
9
9
 
10
+ ## 1.5.0 - 2026-11-21
11
+
12
+ New Command Palette and Splitter components, a Toc highlight, a translucent `background-soft` token, and a Carousel autoplay fix.
13
+
14
+ ### Added
15
+
16
+ - **[Command Palette](https://appica.dev/ui/components/react/command-palette)** - A searchable list of commands and pages in a dialog, opened with a click or a keyboard shortcut.
17
+ - **[Splitter](https://appica.dev/ui/components/react/splitter)** - Resizable panels split by a handle you can drag or move with the keyboard.
18
+ - **[Toc highlight](https://appica.dev/ui/components/react/toc#highlight)** - `highlight` tints the area behind the active links.
19
+ - **[background-soft token](https://appica.dev/ui/docs/react/colors#background-surfaces)** - A translucent surface for frames and panels over a pattern or an image, with a `bg-background-soft` utility.
20
+ - **[Agent skill](https://appica.dev/ui/docs/react/skill)** - `npx skills add appica-dev/appica-ui --skill appica-ui-react` gives your coding agent a component catalog, composition and theming guides, and a script that checks the setup.
21
+
22
+ ### Improved
23
+
24
+ - **Dependencies** - Motion 14.14.
25
+
26
+ ### Fixed
27
+
28
+ - **[Carousel autoplay after a resize](https://appica.dev/ui/components/react/carousel#autoplay)** - Autoplay and Auto Scroll keep running after the carousel resizes.
29
+
30
+ ## 1.4.0 - 2026-11-01
31
+
32
+ A play and pause control for Carousel, options to keep autoplay running under the pointer or focus, and a mouse click that no longer pauses it.
33
+
34
+ ### Added
35
+
36
+ - **[CarouselPlayToggle](https://appica.dev/ui/components/react/carousel#play-and-pause)** - A play and pause button for Autoplay and Auto Scroll. Once paused, the carousel stays paused until it's pressed again. For a custom control, use `paused`, `pause()` and `play()` from `useCarousel()`.
37
+ - **[Carousel autoplay pause options](https://appica.dev/ui/components/react/carousel#autoplay)** - `pauseOnHover` and `pauseOnFocus` turn off either pause, for a timer that is part of the design. A carousel without the pause needs a `CarouselPlayToggle`.
38
+
39
+ ### Fixed
40
+
41
+ - **[Carousel autoplay focus pause](https://appica.dev/ui/components/react/carousel#accessibility)** - Only keyboard focus pauses autoplay. A mouse click on an arrow or a pagination dot leaves it running.
42
+
10
43
  ## 1.3.1 - 2026-11-01
11
44
 
12
45
  Accessibility fixes for Carousel and form fields, and a lighter carousel progress bar.
package/README.md CHANGED
@@ -5,7 +5,7 @@
5
5
  [![TypeScript](https://img.shields.io/badge/TypeScript-ready-blue)](https://www.typescriptlang.org/)
6
6
  [![Figma](https://img.shields.io/badge/Figma-design_file-F24E1E?logo=figma&logoColor=white)](https://www.figma.com/community/file/1657080448204231925)
7
7
 
8
- A modern React component library - 70+ accessible, themeable components built on [Base UI](https://base-ui.com) primitives, animated with [Motion](https://motion.dev), and styled with Tailwind CSS v4 design tokens.
8
+ A modern React component library - 75+ accessible, themeable components built on [Base UI](https://base-ui.com) primitives, animated with [Motion](https://motion.dev), and styled with Tailwind CSS v4 design tokens.
9
9
 
10
10
  **[Documentation](https://appica.dev/ui) · [Installation guide](https://appica.dev/ui/docs/react/installation) · [Components](https://appica.dev/ui/components/react/button)**
11
11
 
@@ -112,7 +112,13 @@ If you are a coding agent reading this from `node_modules`, the rules for writin
112
112
 
113
113
  Every documentation page is served as clean markdown at `<url>.md` - fetch `https://appica.dev/ui/components/react/button.md`, not the HTML page. The full index, with an instruction block, is at [`https://appica.dev/ui/react/llms.txt`](https://appica.dev/ui/react/llms.txt).
114
114
 
115
- If you are a human setting up a project: paste those rules into your own `AGENTS.md` so your agent loads them every session. See [Set up your coding agent](https://appica.dev/ui/docs/react/agents) for a copy-paste block.
115
+ If you are a human setting up a project: paste those rules into your own `AGENTS.md` so your agent loads them every session, or, with Claude Code, import them from your `CLAUDE.md` with `@node_modules/@appica/ui-react/agent-rules.md` so they follow your installed version. See [Set up your coding agent](https://appica.dev/ui/docs/react/agents) for a copy-paste block.
116
+
117
+ For the part a task needs, add the [agent skill](https://appica.dev/ui/docs/react/skill): a component catalog, composition and theming guides, and a script that checks the setup and the code your agent wrote.
118
+
119
+ ```bash
120
+ npx skills add appica-dev/appica-ui --skill appica-ui-react
121
+ ```
116
122
 
117
123
  ## Changelog
118
124
 
package/agent-rules.md CHANGED
@@ -7,11 +7,14 @@
7
7
  contributor guide, written for someone editing this library. This file must
8
8
  never tell a reader to modify the library.
9
9
 
10
- Two consumers read this text, and neither should ever restate it:
10
+ Three consumers read this text, and none should ever restate it:
11
11
  - the docs site, which inlines it into https://appica.dev/ui/react/llms.txt and into
12
12
  the "Set up your coding agent" page (it reads this file out of
13
13
  node_modules at build time);
14
- - README.md's "For AI agents" section, which links here.
14
+ - README.md's "For AI agents" section, which links here;
15
+ - the agent skill, whose SKILL.md carries a generated copy between its
16
+ agent-rules markers (`pnpm sync:skill` at the repo root writes it, and
17
+ `pnpm release` fails while it is stale).
15
18
 
16
19
  Three copies of the `@source` instruction is exactly how that directive ended
17
20
  up contradicting itself in three places. Keep one copy: this one.
@@ -31,6 +34,9 @@
31
34
  - Never write hex colors, px radii, or duration literals. Use the role-based tokens:
32
35
  `bg-background-muted`, `text-foreground-intense`, `border-border-strong`, `var(--radius-md)`.
33
36
  Full list: https://appica.dev/ui/docs/react/colors.md
37
+ - `bg-background-soft` is translucent in light and dark mode, and `bg-background-subtle` in dark mode. Where content
38
+ shows through either, pair it with a `backdrop-blur-*` on the same element and state. Where it must hide what's
39
+ behind, use an opaque token (`bg-background`, `bg-background-muted`).
34
40
  - Never write hue-based utilities (`bg-gray-100`, `text-slate-600`). The palette is organized by
35
41
  role, not hue.
36
42
  - Prefer v4 variant syntax (`*:`, `**:`, `data-*:`, `not-*:`) over `[&_...]` arbitrary selectors.
@@ -38,6 +44,7 @@
38
44
  own `:has()` rules, each check restyles the whole page. Derive page state from the route or React state instead.
39
45
  - For a link styled as a button, put `buttonVariants(...)` on the `<a>` - never `<Button render={<a/>}>`.
40
46
  - Put `className` overrides on the wrapper component, not on the JSX passed to `render`.
47
+ - A carousel with `pauseOnHover: false` or `pauseOnFocus: false` takes a `CarouselPlayToggle`.
41
48
  - Do not hand-roll a component that exists in the library. Check the component list first:
42
49
  https://appica.dev/ui/react/llms.txt
43
50
  - Every documentation page is served as clean markdown at `<url>.md` - fetch that, not the HTML.