@raxrai/stylelab-ui 0.1.1 → 0.3.1

package/README.md

@@ -8,11 +8,19 @@ A themeable, accessible React UI library with **8 themes**: Minimal, Night, Glas
 
 ## Installation
 
+**Next.js or any existing React app** (you already have React):
+
+```bash
+npm install @raxrai/stylelab-ui
+```
+
+**New project without React** (e.g. empty folder):
+
 ```bash
 npm install @raxrai/stylelab-ui react react-dom
 ```
 
-Peer dependencies: **react** and **react-dom** (>=18). Other runtime deps (e.g. class-variance-authority, clsx, tailwind-merge, lucide-react, framer-motion) are bundled, so no extra install is required.
+The package lists **react** and **react-dom** as peer dependencies (>=18). Next.js and Create React App already include them, so you don’t install them again. Other runtime deps (cva, clsx, tailwind-merge, lucide-react, framer-motion) are bundled, so no extra install is required.
 
 ### 1. Tailwind + styles
 
@@ -183,6 +191,7 @@ Implements focus trap and scroll lock when open.
 | `items`       | `{ value, label, disabled? }[]` | — | Options               |
 | `value` / `defaultValue` | `string`        | —       | Controlled / initial     |
 | `onValueChange`| `(value: string) => void` | —     | Selection callback       |
+| `disabled`     | `boolean`       | `false` | When true, does not open; trigger is non-interactive |
 
 Keyboard: Enter/Space to open, Arrows to move, Enter to select, Escape to close.
 
@@ -202,6 +211,27 @@ import { cn, useFocusTrap, useClickOutside, useKeyboardNavigation, getNextListIn
 
 ---
 
+## Changelog
+
+### [0.3.1]
+
+- **Dropdown** — `disabled` prop: when true, the dropdown does not open and the trigger is non-interactive (opacity, cursor, no popover). Use for empty or loading state.
+
+### [0.2.0]
+
+- **Navbar** — Optional responsive API: pass `logo`, `items` (`{ href, label }[]`), and `right` (e.g. theme switcher). On small screens nav links become a hamburger menu that opens as an overlay (no layout shift), with the theme’s navbar background; glass and clay use an opaque panel so content doesn’t show through. Desktop shows full nav row. Menu closes on link click or outside click. You can still pass `children` for a custom layout. Exported types: `NavbarItem`, `NavbarProps`.
+- **ThemeProvider** — Restores theme from `localStorage` on mount; `setTheme` persists the new theme. Optional `storageKey` prop (default `"stylelab-theme"`).
+- **Dropdown** — Popover is portaled to `document.body` and positioned with open-up/down logic. Optional `trigger` and `placeholder` (default trigger shows selected/placeholder label). `classNames` for trigger, popover, and item. Theme-aware hover/focus styles. Exported types: `DropdownItem`, `DropdownProps`, `DropdownClassNames`.
+- **Card** — `classNames` for root, header, body, footer. Cyberpunk no longer uses the clip-path “glitch cut” (avoids weird look on different backgrounds); neon border and glow remain. Exported types: `CardProps`, `CardClassNames`.
+- **Badge** — `bgOverride` and `textOverride` (e.g. hex) when you need specific colors.
+- **ProgressBar** — `trackColor` and `activeColor` overrides (e.g. hex).
+- **DashboardShell** — Header, nav links, and mobile panel use theme-based styling (no `dark:`; works with StyleLab themes).
+- **GraphicCard** — In night and cyberpunk themes, content text inherits the card’s text color so children with hardcoded dark text still display correctly.
+- **Docs** — Installation: Next.js/existing React apps install the package only; add `react`/`react-dom` only for new projects without React.
+- **Types** — `StyleLabTheme`, `ComponentName`, `ThemeRecommendation` from `lib/types`; component prop types `NavbarItem`, `NavbarProps`, `CardProps`, `CardClassNames`, `DropdownItem`, `DropdownProps`, `DropdownClassNames` re-exported from the package.
+
+---
+
 ## Links
 
 - **Live demo & docs:** [https://stylelab.rajarai.com](https://stylelab.rajarai.com)