# @bug-on/m3-expressive

## 1.3.3

### Patch Changes

- 719c20f: Add AI docs and TOC hierarchy

## 1.3.2

### Patch Changes

- fd99c6c: Fix some minor errors.
- Updated dependencies [fd99c6c]
  - @bug-on/m3-tailwind@1.2.2
  - @bug-on/m3-tokens@1.2.2

## 1.3.1

### Patch Changes

- ac2e09e: Refactor Slider & Progress APIs, update docs

## 1.3.0

### Minor Changes

- dbcb09f: Add fading blur mask & API refinements

## 1.2.7

### Patch Changes

- 81a5076: Fix issues Circular Indeterminate do not work.

## 1.2.6

### Patch Changes

- 564003a: Improve Progress Indicator component

## 1.2.5

### Patch Changes

- 97fb801: Add Select component Expose Menus, fix UI menu, readme
- Updated dependencies [97fb801]
  - @bug-on/m3-tailwind@1.2.1
  - @bug-on/m3-tokens@1.2.1

## 1.2.4

### Patch Changes

- 3aab9b2: Improve Navigation components, fix some issues

## 1.2.3

### Patch Changes

- 3d03619: Added asChild for navigation item

## 1.2.2

### Patch Changes

- 99c082f: Add Button distribute, remove deprecated props

## 1.2.1

### Patch Changes

- d46c216: · Fix some minor errors known

## 1.2.0

### Minor Changes

- fffe0ac: Color system upgrade to Exxpressive

### Patch Changes

- Updated dependencies [fffe0ac]
  - @bug-on/m3-tailwind@1.2.0
  - @bug-on/m3-tokens@1.2.0

## 1.1.0

### Minor Changes

- 72c3aec: Standardize the language, rewrite the instruction manual, and address known minor issues.

### Patch Changes

- Updated dependencies [72c3aec]
  - @bug-on/m3-tailwind@1.1.0
  - @bug-on/m3-tokens@1.1.0

## 1.0.0

### 🎉 Initial Release

First stable release of **@bug-on/m3-expressive** — Material Design 3 Expressive React component library by Bug On.

> **Note:** This package was previously published as `@bug-on/m3-expressive`. All functionality has been carried over with a fresh version reset.

#### Components

**Buttons**

- `Button` — Filled, Outlined, Tonal, Elevated, Text variants
- `IconButton` — Standard, Filled, Tonal, Outlined variants with toggle support
- `FAB` — Floating Action Button (Small, Medium, Large)
- `ExtendedFAB` — Extended FAB with label and icon
- `FABMenu` — FAB with expandable menu actions
- `SplitButton` — Split button with primary action and dropdown
- `ButtonGroup` — Grouped buttons with shared styling

**Forms & Inputs**

- `TextField` — Filled and Outlined variants with leading/trailing icons
- `Checkbox` — Standard and TriState checkbox
- `RadioButton` — Radio button with MD3 styling
- `Switch` — Toggle switch with icon support
- `Slider` / `RangeSlider` — Single and range slider with discrete/continuous modes

**Navigation**

- `NavigationBar` — Bottom navigation bar with animated icons
- `NavigationRail` — Side navigation rail
- `Tabs` / `Tab` / `TabsList` / `TabsContent` — Primary and Secondary tab variants
- `Drawer` — Navigation drawer (standard, modal)

**Feedback**

- `Dialog` — Alert and full-screen dialog
- `Snackbar` / `SnackbarProvider` / `useSnackbar` — Toast notifications
- `ProgressIndicator` — Linear and Circular (determinate, indeterminate, wavy)
- `LoadingIndicator` — Loading spinner
- `Tooltip` — Plain and Rich tooltip with caret

**Layout & Surfaces**

- `Card` — Elevated, Filled, Outlined variants
- `Divider` — Full-width and inset dividers
- `List` / `ListItem` / `ListDivider` — Lists with leading/trailing elements
- `ScrollArea` — Custom scrollbar area
- `SideSheet` / `BottomSheet` — Sheet overlays

**App Bars & Toolbars**

- `SmallAppBar` / `MediumFlexibleAppBar` / `LargeFlexibleAppBar` — Top app bars
- `BottomAppBar` — Bottom app bar with FAB integration
- `SearchAppBar` / `SearchView` — Expandable search
- `Toolbar` / `FloatingToolbar` / `DockedToolbar` — Contextual toolbars

**Data & Display**

- `Badge` / `BadgedBox` — Notification badges
- `Chip` — Assist, Filter, Input, Suggestion variants
- `Icon` — Material Symbols integration with fill/weight/grade/size control
- `Text` — Typography component with MD3 type scale
- `CodeBlock` — Code display with syntax highlighting

**Date & Time Pickers**

- `DatePicker` / `DatePickerDialog` / `DatePickerInput` — Date selection
- `DateRangePicker` — Date range selection
- `TimePicker` / `TimePickerDialog` / `TimeInput` — Time selection

**Shapes & Media**

- `ShapeMedia` / `ShapeMediaServer` — MD3 Expressive shape containers
- `ShapeSvg` / `ShapeIcon` — SVG-based shapes
- `useShapeMorph` — Shape morphing animation hook
- MD3 shape catalog with all expressive corner variants

**Search**

- `Search` / `SearchBar` — Inline search
- `SearchViewDocked` / `SearchViewFullscreen` — Expanded search views

**Menu**

- `Menu` / `MenuItem` / `MenuDivider` / `MenuGroup` — Dropdown menus
- `SubMenu` — Nested submenus
- `ContextMenu` — Right-click context menu
- `VerticalMenu` — Vertical navigation menu

**Theme & Providers**

- `MD3ThemeProvider` — Dynamic color theming (Material You)
- `useTheme` / `useThemeMode` — Theme hooks
- `MaterialSymbolsPreconnect` — Font preconnect helper

**Utilities**

- `Ripple` — Touch ripple effect
- `StateLayer` — Hover/focus/press state layer
- `TouchTarget` — Accessible touch target sizing
- `useAppBarScroll` — Scroll-aware app bar behavior

#### CSS Exports

- `@bug-on/m3-expressive/index.css` — MD3 tokens + Tailwind `@theme` + resets
- `@bug-on/m3-expressive/typography.css` — Google Sans Flex font-face
- `@bug-on/m3-expressive/material-symbols-cdn.css` — Material Symbols via CDN
- `@bug-on/m3-expressive/material-symbols-self-hosted.css` — Self-hosted icons

#### Sub-path Exports

- `@bug-on/m3-expressive/core` — Theme providers and hooks only
- `@bug-on/m3-expressive/buttons` — Button components only
- `@bug-on/m3-expressive/forms` — Form components only
- `@bug-on/m3-expressive/feedback` — Feedback components only
- `@bug-on/m3-expressive/navigation` — Navigation components only
- `@bug-on/m3-expressive/overlays` — Dialog/Sheet components only
- `@bug-on/m3-expressive/layout` — Layout components only
- `@bug-on/m3-expressive/pickers` — Date/Time pickers only
- `@bug-on/m3-expressive/shapes` — Shape components only
- `@bug-on/m3-expressive/plugin` — Tailwind v4 plugin re-export