hazo_ui 2.9.0 → 2.16.0

package/CHANGE_LOG.md

@@ -0,0 +1,500 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [2.16.0] - 2026-05-17
+
+### Changed
+- **Restyled `HazoUiMultiSortDialog` and `HazoUiMultiFilterDialog`** for a
+  modern, Linear/Notion-style appearance:
+  - Tighter dialog chrome: bordered header, padded body, bordered footer
+    bar with subtle muted background — replaces the flat, dated look.
+  - **Sort dialog**: each row now shows a numbered priority badge, a
+    segmented Asc/Desc pill (replaces the ambiguous switch), and a muted
+    delete affordance that reddens on hover.
+  - **Filter dialog**: rows have compact mathematical operator symbols
+    (`=`, `≠`, `>`, `<`, `≥`, `≤`) in a narrow select; inputs are 32px
+    tall for a denser layout; rows match the sort dialog visually.
+  - **Footer hierarchy fixed**: `Clear all` is a low-emphasis ghost
+    button on the left; `Cancel` (outline) and `Apply` (primary) are
+    grouped on the right — `Apply` is the rightmost / final action.
+  - Trigger buttons now show an active-count badge next to the icon.
+  - Empty state uses a dashed-border placeholder card; the "Add field"
+    affordance matches and disables itself when all fields are added.
+- **Dialog animation**: removed `slide-in-from-left-1/2` /
+  `slide-out-to-left-1/2` classes from `DialogContent`. Modals now
+  fade + zoom in place from center — no more horizontal "drift" that
+  caught the dialog mid-animation looking off-screen.
+
+### API
+- All component props (including the color-override props on both
+  dialogs) are unchanged; this is a visual refresh, not a contract
+  change. Existing consumers do not need to update call sites.
+
+## [2.15.1] - 2026-05-17
+
+### Fixed
+- **SSR/CSR hydration mismatch in HazoUiTable number/currency/percent
+  formatters.** `Intl.NumberFormat(undefined, …)` resolved to the
+  runtime's host locale, which differs between Node (server) and the
+  browser (client) — e.g. server `$4,812,500.00` vs. client
+  `US$4,812,500.00` when the browser default is `en-GB`. The library
+  now pins to `"en-US"` so both environments produce the same string.
+
+### Added
+- New `locale?: string` on `TableColumn` (BCP-47 tag, e.g. `"de-DE"`,
+  `"ja-JP"`) — opt-out for the new pinned default. Applies to `number`,
+  `currency`, and `percent` formatters. Date formatting was unaffected
+  and is unchanged (it uses `date-fns`, not `Intl`).
+
+## [2.15.0] - 2026-05-17
+
+### Added
+- **Shift-click multi-sort on `HazoUiTable` headers.** Plain header
+  click still cycles asc → desc → none (single column). Shift-click
+  a header to append it as a secondary sort, cycling that column
+  asc → desc → removed without collapsing prior columns. Discoverable
+  via a `title=` tooltip on the sort button. `useTableState.cycleHeaderSort`
+  gains an `append?: boolean` parameter; new `cycleAppendColumn` helper
+  alongside the existing `cycleSingleColumn`.
+- **Column-level `currency` override on `TableColumn`.** When `formatter`
+  is `"currency"`, the formatter reads `column.currency` (any ISO-4217
+  code, e.g. `"EUR"`, `"GBP"`) instead of the previously hard-coded
+  `"USD"`. Defaults to `"USD"` when omitted — fully backwards-compatible.
+- **Structured `onLoad` error UX.** `HazoUiTableProps` gains
+  `error?: React.ReactNode | ((err: unknown) => React.ReactNode)`.
+  `useTableState` exposes `serverError` (always `null` outside server
+  mode). On `onLoad` rejection, the table renders the consumer's
+  `error` prop in place of rows; if none is provided, a default
+  `EmptyState` shows the thrown message. `console.warn` continues to
+  log every rejection. Branch added to both the desktop `TableBody`
+  and the mobile card view.
+- Dev-app `/table` §9 demos the error state with a rejecting loader.
+  §2 copy mentions the new shift-click gesture.
+
+### Internal
+- Renamed `use_table_state` → `useTableState` (function only — the
+  filename stays `use_table_state.ts`). Aligns with the package's
+  other hooks (`useMediaQuery`, `useLoadingState`, `useErrorDisplay`)
+  and unblocks the `react-hooks/rules-of-hooks` lint rule.
+- New ESLint v9 flat config (`eslint.config.js`) so `npm run lint`
+  works again. Scoped to `src/**/*.{ts,tsx}` with
+  `@typescript-eslint` and `react-hooks` rules.
+
+### Notes
+- The 200 ms search debounce default is unchanged — the spec §10
+  follow-up about tuning needs empirical data from the sister app.
+  Consumers can already override per-table via `searchDebounceMs`.
+
+## [2.14.0] - 2026-05-17
+
+### Added
+- **`Table` shadcn primitive family.** Eight components (`Table`,
+  `TableHeader`, `TableBody`, `TableFooter`, `TableRow`, `TableHead`,
+  `TableCell`, `TableCaption`) re-exported under bare shadcn names.
+  Matches the canonical shadcn shape — drop-in for consumers that want
+  raw markup.
+- **`HazoUiTable` composite.** Column-config-driven data table that
+  composes the primitive with an in-memory filter/sort/paginate
+  pipeline:
+  - `TableColumn` is the single source of truth for display, sort,
+    filter, and search metadata.
+  - Sortable headers cycle asc → desc → none and replace any
+    multi-column sort with single-column on click. Multi-column sort
+    via the optional `HazoUiMultiSortDialog` integration; indicators
+    show order numbers.
+  - Optional toolbar with debounced free-text search (200 ms),
+    `HazoUiMultiFilterDialog`, and `HazoUiMultiSortDialog`. Available
+    fields are derived from columns — declared once.
+  - Loading state via `SkeletonBar`; empty / no-results via
+    `EmptyState`.
+  - Optional pagination footer with "Showing X–Y of Z" + Prev/Next.
+  - Optional row click with full mouse + keyboard support (Enter,
+    Space) when `onRowClick` is set.
+  - Mobile card-per-row fallback below a configurable breakpoint
+    (default 768 px). Opt out with `mobileCardFallback={false}`.
+  - Optional `onLoad({ page, sort, filter })` for server-side data;
+    latest-request-wins.
+- Dev-app `/table` route with eight demo sections covering every
+  acceptance scenario.
+
+### Dependencies
+- No new dependencies. Composes existing `Skeleton`, `EmptyState`,
+  `Card`, `Input`, `Button`, `HazoUiMultiSortDialog`,
+  `HazoUiMultiFilterDialog`, `useMediaQuery` from this package, plus
+  `date-fns` and `lucide-react` (already deps).
+
+## [2.13.1] - 2026-05-16
+
+### Changed
+- **`KanbanEditor` is now built on `HazoUiDialog`** (was raw shadcn `Dialog` primitives). Picks up the standardized header (with `title` + `description` so Radix's missing-`Description` warning is gone naturally), the standardized Save/Cancel footer with built-in `actionButtonLoading` spinner + `actionButtonDisabled`, and a priority-tinted full-width header bar via `headerBar` + `headerBarColor` — reads `hsl(var(--hazo-kanban-priority-{p0..p3}))` for visual continuity with the card left borders. The Save button gets a `Check` icon for clarity.
+- Auto-detect default editor now appends a **Status** select at the end (sourced from the kanban's `columns`), so users can move the card between columns from the editor out of the box without configuring `editorFields`.
+- Field labels rendered slightly smaller and muted (`text-xs font-medium text-muted-foreground`) for a more compact SaaS density.
+
+### Added
+- New `'status'` value on `KanbanEditorFieldType`. Renders a `Select` pre-populated from the kanban's `columns` prop (label = `column.title`, value = `column.key`). Bound to `columnKey` by convention; saving with a different status moves the card to a new column through the consumer's `onCardSave` handler — same code path as `onMove`.
+- Dev-app §7 editor declares `{ key: 'columnKey', type: 'status', label: 'Status' }` so the demo exercises the new field type.
+
+### Removed
+- The explicit `aria-describedby={undefined}` workaround on `DialogContent` from v2.13.0 — `HazoUiDialog` exposes a proper `description` prop that satisfies Radix without the escape hatch.
+
+## [2.13.0] - 2026-05-16
+
+### Changed (breaking, but pre-publish)
+- **Renamed `HazoUiBoard` family to `HazoUiKanban`.** v2.12.0 was committed to git but never `npm publish`'d, so this is a hard rename with no deprecation shim. Affected exports: `HazoUiBoard` → `HazoUiKanban`, `HazoUiBoardFilter` → `HazoUiKanbanFilter`, `applyBoardFilter` → `applyKanbanFilter`, plus the corresponding type aliases (`BoardItem` → `KanbanItem`, etc.). CSS class prefixes `cls_hazo_board_*` → `cls_hazo_kanban_*`; CSS variables `--hazo-board-*` → `--hazo-kanban-*`. Dev-app route `/board` → `/kanban`.
+
+### Added
+- **Out-of-the-box card editor.** Each card now carries a pencil icon (top-right, opacity-0 idle, opacity-100 on hover/focus). Clicking opens a `HazoUiDialog`-shell editor. Three rendering modes:
+  1. `renderCardEditor` render-prop — full control over the body.
+  2. `editorFields` declarative config — library renders one row per field declaration. Six built-in types: `text`, `textarea`, `select`, `number`, `checkbox`, `priority`. Required-field gating disables Save when text/textarea/number fields are empty.
+  3. Neither — library auto-detects string-typed fields on the item (skipping `id`, `columnKey`, `priority`).
+- **Async save lifecycle.** `onCardSave` returns `void | Promise<void>`. A returned Promise gates dialog close and shows a "Saving…" spinner; a rejected Promise keeps the dialog open with `ctx.error` populated. Consumer is responsible for updating `items` on success (symmetric with `onMove`).
+- Seven new props on `HazoUiKanbanProps<T>`: `editorFields`, `editorPriorities`, `editorTitle`, `renderCardEditor`, `hideEditorFooter`, `onCardSave`, `disableEdit`.
+- Four new public types: `KanbanEditorField`, `KanbanEditorFieldType`, `KanbanEditorCtx<T>`, `KanbanSaveEvent<T>`.
+- Dev-app demo at `/kanban` extended with three new sections (§6 default editor, §7 declarative editor, §8 renderCardEditor override).
+
+### Fixed
+- Suppressed Radix `DialogContent` missing-`Description` warning in `KanbanEditor` by setting `aria-describedby={undefined}` explicitly. Caught during the v2.13.0 smoke test — every editor open emitted a console warning under React strict mode.
+
+### Notes
+- No new CSS variables — the editor uses existing shadcn Dialog tokens and input/select/checkbox/textarea/button variables.
+- The pencil icon is hidden when `disableEdit={true}` OR `onCardSave` is not provided (no point letting the user edit if nothing happens on save).
+- The pencil's `pointerdown`/`mousedown`/`keydown` events stop propagation so dnd-kit's PointerSensor doesn't interpret the click as the start of a drag.
+- One shared `<KanbanEditor>` instance mounts at the orchestrator level, not one Dialog per card.
+- No `SETUP_CHECKLIST.md` changes (no new setup steps for consumers).
+
+## [2.12.0] - 2026-05-16
+
+### Added
+- **`HazoUiBoard`** — drag-drop kanban board primitive with mobile tab-strip / desktop column-grid layout switch via pure CSS. Wraps `@dnd-kit/*` internally; consumers see only the `HazoUi*` API. Optimistic-overlay state model: `items` is consumer-controlled; failed moves snap back via `handle.revert()` carried on the `BoardMoveEvent`.
+- **`HazoUiBoardFilter`** — controlled-or-uncontrolled filter bar with free-text search, multi-select category chips (`ToggleGroup type="multiple"`), and single-select priority chips. Decoupled from `HazoUiBoard` — consumer applies the filter to `items` before passing in.
+- **`applyBoardFilter`** — pure helper that filters `items` by search / categories / priority. Convenience export; consumers can swap in their own filter function.
+- Keyboard navigation per `@dnd-kit/accessibility` patterns (Tab focus → Space pick up → Arrow keys → Space drop → Esc cancel).
+- Custom screen-reader announcements that name the action and column; override-able via the `announcements` prop.
+- New CSS custom properties in both `src/styles/globals.css` (dev-app input) and `src/styles/hazo-ui.css` (shipped to `dist/styles.css`): `--hazo-board-priority-p0..p3` (HSL channels), `--hazo-board-card-bg`, `--hazo-board-card-border`, `--hazo-board-column-gap`. Apps can re-theme by overriding any variable in their cascade.
+- Dev-app demo at `dev-app/app/board/page.tsx` (route `/board`) with 5 sections: default kanban, controlled filter, uncontrolled filter, keyboard-only walkthrough, and optimistic-update + revert.
+
+### Fixed (during the v2.12.0 cycle)
+- **dev-app `next build` failure on pre-existing UI components.** `dev-app/package.json` pinned `@types/react` to `18.3.28` (workspace-root version) so type-check no longer fails in `src/components/ui/button-group.tsx` and `toggle-group.tsx` with "Type 'bigint' is not assignable to type 'ReactNode'". Pre-existing infrastructure issue surfaced during board demo wiring.
+
+### Notes
+- Sub-components `BoardColumn` and `BoardCard` are intentionally internal — the data-driven `HazoUiBoard` API (`columns`, `items`, `renderCard`) is the only entry point.
+- `HazoUiBoard` passes a `React.useId()`-derived value as `DndContext`'s `id` prop so multiple boards on one page produce stable, SSR-deterministic `aria-describedby` IDs (no hydration warnings).
+- No new dependencies (`@dnd-kit/*` was already in `dependencies` from prior versions).
+- No `SETUP_CHECKLIST.md` changes (no new setup steps for consumers).
+
+## [2.11.0] - 2026-05-16
+
+### Fixed
+- **Button inline-style fallback rendering as transparent** — the v2-era inline-style fallback used bare `var(--primary)` etc., which resolved to invalid CSS when consumers (per shadcn convention) store CSS variables as raw HSL channels (e.g. `--primary: 222.2 47.4% 11.2%`). All `Button` variants (default, destructive, outline, secondary) now wrap their fallback values in `hsl(...)`, matching the documented theme convention and Tailwind preset. Buttons rendered as transparent rectangles with text-only labels before this fix.
+- `destructive` variant's inline-style `color` switched from hardcoded `"white"` to `hsl(var(--destructive-foreground))` for theme consistency.
+
+### Notes
+- No API changes — pure visual fix. Consumers on the standard shadcn theme convention will see Buttons render correctly without any further changes.
+- Consumers who set CSS variables as full color values (hex/rgb) instead of HSL channels should override via the `style` prop (this was never the documented convention).
+
+## [2.10.0] - 2026-05-16
+
+### Added
+- **State primitives sub-module** — `Skeleton`, `SkeletonCircle`, `SkeletonBar`, `SkeletonRect`, `SkeletonGroup` with shimmer animation (respects `prefers-reduced-motion`).
+- `EmptyState` component (icon + title + description + action).
+- `ErrorBanner` component with `severity: 'warning' | 'error'`, auto icon, optional title/action/dismiss.
+- `ErrorPage` component for full-page error fallback (title, description, errorCode, correlationId, actions).
+- `LoadingTimeout` wrapper with 5s/15s/30s escalation (silent → gentle → firm → expired).
+- `ProgressiveImage` (grey → blur LQIP → sharp).
+- `HazoUiToaster` + `successToast(opts)` + `errorToast(opts)` imperative helpers — wraps `sonner`.
+- `useLoadingState()` hook — `{ isLoading, setLoading, withLoading }`.
+- `useErrorDisplay()` hook — passive `{ error, setError, clearError }`.
+
+### Changed
+- Added `sonner ^2.0.7` to dependencies.
+- Added `@keyframes hazo-shimmer` and `.hazo-shimmer` utility class to `src/styles/hazo-ui.css`.
+
+### Notes
+- All new components use shadcn semantic tokens (`bg-muted`, `bg-destructive`, etc.) and direct utility classes for amber tones (no `--warning` token assumed).
+- Components are exported flat & unprefixed from the top-level barrel — matches the existing `Button`/`Spinner`/`Card` convention.
+
+## [2.9.0] - 2026-05-12
+
+### Added
+- **Drawer primitive** (`src/components/ui/drawer.tsx`): vaul-backed bottom sheet component following the shadcn/ui Drawer pattern. Exports `Drawer`, `DrawerTrigger`, `DrawerPortal`, `DrawerOverlay`, `DrawerContent`, `DrawerHeader`, `DrawerFooter`, `DrawerTitle`, `DrawerDescription`, `DrawerClose`. Uses dynamic viewport units (`max-h-[96dvh]`) so iOS Safari's address-bar toggling doesn't crop the sheet.
+- **`useMediaQuery` hook** (`src/hooks/use_media_query.ts`): SSR-safe React hook returning whether a CSS media query matches. Re-renders on match changes. Use to fork mobile/desktop rendering (e.g. swap `Dialog` ↔ `Drawer` at `(max-width: 640px)`).
+- **New dependency**: `vaul@^1.1.2` (~6 KB gz, MIT). React/react-dom peers are already covered by hazo_ui's existing peer range.
+
+### Notes for consumers
+- The Drawer is intended for mobile bottom sheets. On desktop, prefer `Dialog`. Pattern:
+  ```typescript
+  import { Drawer, Dialog, useMediaQuery } from "hazo_ui";
+  const is_mobile = useMediaQuery("(max-width: 640px)");
+  const Shell = is_mobile ? Drawer : Dialog;
+  ```
+- Snap points, side-anchored drawers (`top`/`left`/`right`), and nested drawers are not in scope for this primitive — pass through to vaul's API directly if needed in the meantime.
+
+## [2.8.0] - 2026-05-11
+
+### Added
+- **shadcn/ui Primitive Re-exports (9 new primitives)**: AlertDialog, ButtonGroup, Card, Collapsible, ScrollArea, Separator, Spinner, Toggle, ToggleGroup
+  - All new primitives follow the existing shadcn/ui pattern and are re-exported from the package root
+  - Enables sibling hazo_* packages to import these UI primitives from a single source without managing separate Radix UI dependencies
+- **6 new Radix UI dependencies**: `@radix-ui/react-alert-dialog`, `@radix-ui/react-collapsible`, `@radix-ui/react-scroll-area`, `@radix-ui/react-separator`, `@radix-ui/react-toggle`, `@radix-ui/react-toggle-group`
+
+### Fixed
+- **CardTitle ref type**: Corrected generic type from `HTMLParagraphElement` to `HTMLHeadingElement` — the rendered element is `<h3>` so the ref must be typed accordingly
+
+## [2.7.3] - 2026-05-10
+
+### Changed
+- **BREAKING (build/styling)**: Migrated internal build pipeline to **Tailwind CSS v4** (`tailwindcss@^4.2.4`).
+  - Replaced `tailwindcss-animate` with `tw-animate-css@^1.4.0`
+  - Replaced PostCSS plugins `tailwindcss + autoprefixer` with single `@tailwindcss/postcss` plugin (Lightning CSS handles vendor prefixing)
+  - Updated `src/styles/globals.css` to use Tailwind v4 entry: `@import "tailwindcss"` + `@import "tw-animate-css"` (replaces `@tailwind base/components/utilities`)
+  - Updated `tailwind.preset.js` to be v4-compatible (removed `tailwindcss-animate` plugin import)
+  - Bumped canonical workspace versions: `clsx@^2.1.1`, `tailwind-merge@^3.5.0`, `lucide-react@^0.553.0`, `typescript@^5.7.2`, `@types/react@^18.3.3`
+- Dev-app migrated to Tailwind v4 mirror of the library configuration
+- `HazoUiTextbox` / `HazoUiTextarea` test pages updated to use object-form `color` prop (`{ bg, fg, border }`) for prefixes — aligns with the production pill color model
+
+### Migration Notes for Consumers
+- If you use the published `tailwind.preset.js`, no API changes are required.
+- If you previously installed `tailwindcss-animate` for hazo_ui, replace it with `tw-animate-css` and load via `@import "tw-animate-css";` in your CSS.
+- Tailwind v4 consumers must keep the `@source "../node_modules/hazo_ui/dist";` directive (already documented).
+
+## [2.7.2] - 2026-03-31
+
+### Added
+- **HazoUiPillRadio**: Pill-shaped radio selection component
+  - Optional icons (react-icons compatible)
+  - Customizable accent colors per option
+  - Size variants (sm / md / lg)
+  - Horizontal or vertical layout
+  - Equal-width option for uniform pill widths
+  - Auto-fit vertical layout
+
+## [2.7.1] - 2026-03-27
+
+### Changed
+- **BREAKING**: Renamed `DialogVariant` value `'danger'` to `'destructive'` in HazoUiDialog for consistency with HazoUiConfirmDialog
+- Extracted shared `ANIMATION_PRESETS` and `resolve_animation_classes` into `src/lib/animations.ts` (used by both dialog components)
+- Removed dead `example_component` placeholder from source
+
+### Added
+- Re-exported `ANIMATION_PRESETS` and `resolve_animation_classes` from package root for consumer use
+- Added `.superpowers` and `design` to `.npmignore`
+
+### Removed
+- Unnecessary `esbuild` devDependency (tsup bundles its own)
+
+## [2.7.0] - 2026-03-26
+
+### Added
+- **HazoUiConfirmDialog**: Compact confirmation dialog with variant-driven styling
+  - Variant system: default, destructive, warning, info, success
+  - Accent top border colored by variant
+  - Async `onConfirm` with auto-loading state
+  - Configurable buttons (confirm + optional cancel)
+  - ReactNode children or simple description string
+  - Focus management: cancel button receives focus for destructive/warning variants
+- **shadcn/ui Primitive Re-exports**: All shadcn/ui base components now re-exported from hazo_ui
+  - Accordion, Button, Calendar, Checkbox, Command, DropdownMenu, HoverCard, Input, Label, Popover, RadioGroup, Select, Switch, Tabs, Textarea, Tooltip
+  - Enables sibling hazo_* packages to import UI primitives from a single source
+- New Radix UI dependencies: `@radix-ui/react-accordion`, `@radix-ui/react-checkbox`, `@radix-ui/react-dropdown-menu`, `@radix-ui/react-hover-card`
+
+## [2.6.6] - 2026-03-25
+
+### Fixed
+- Dialog title overlapping close button and not word-wrapping
+
+## [2.6.5] - 2026-03-24
+
+### Added
+- `fixedSize` prop on HazoUiDialog — when true, `sizeHeight` becomes a fixed height instead of maxHeight
+
+## [2.6.4] - 2026-03-23
+
+### Fixed
+- Button styling in dialog footer
+
+## [2.6.3] - 2026-03-22
+
+### Added
+- Dialog `variant` prop with preset color themes (info, success, warning, destructive)
+- Global `hazo_ui_config` system for theming buttons and headers
+- Per-component color override props
+
+## [2.6.2] - 2026-03-21
+
+### Added
+- Compositional Dialog API: re-exported shadcn/ui Dialog primitives as `HazoUiDialogRoot`, `HazoUiDialogContent`, etc. for complex layouts
+
+## [2.6.0] - 2026-03-20
+
+### Added
+- **HazoUiDialog**: Standardized dialog component with comprehensive features
+  - Standardized header/footer layout with customizable content area
+  - Flexible animation system (9 presets + custom Tailwind classes)
+  - Responsive sizing with viewport-relative dimensions
+  - Background overlay customization
+  - CSS variable-based theming
+  - Header bar mode with colored full-width header
+  - Loading state and custom footer content support
+
+## [2.5.2] - 2026-03-19
+
+### Added
+- Documentation updates for HazoUiDialog
+
+## [2.5.1] - 2026-03-18
+
+### Added
+- `instance_id` prop documentation for command components
+
+## [2.5.0] - 2026-03-17
+
+### Added
+- Multiple simultaneous command instances support
+
+## [2.4.0] - 2026-03-15
+
+### Added
+- **HazoUiCommand**: Headless command/mention system for Tiptap
+  - Command pill rendering with prefix-based colors
+  - Popover suggestion menu
+  - Multiple prefix support (@, #, /, etc.)
+  - `parse_commands_from_text` and `text_to_tiptap_content` utilities
+- **HazoUiTextbox**: Single-line input with command pill support
+- **HazoUiTextarea**: Multi-line input with command pill support
+
+## [2.3.0] - 2026-03-10
+
+### Added
+- **HazoUiRte**: Rich Text Editor component based on Tiptap v3
+  - Variable insertion system
+  - File attachment support
+  - HTML and plain text output modes
+  - Comprehensive toolbar with formatting options
+  - Font size and font family extensions
+- Tailwind preset type declarations (`tailwind.preset.d.ts`)
+
+### Fixed
+- SSR hydration issues
+
+## [2.2.0] - 2025-12-17
+
+### Added
+- **HazoUiMultiFilterDialog**: Added optional `title` prop (default: "Filter") to customize dialog title
+- **HazoUiMultiFilterDialog**: Added optional `description` prop (default: "Add multiple fields to filter by...") to customize dialog description
+- **HazoUiMultiSortDialog**: Added optional `title` prop (default: "Sort") to customize dialog title
+- **HazoUiMultiSortDialog**: Added optional `description` prop (default: "Add multiple fields to sort by...") to customize dialog description
+- **CommandItem**: Added hover styling (`hover:bg-accent hover:text-accent-foreground cursor-pointer`) for better user experience
+- **Documentation**: Added troubleshooting entries for dialog backdrop and dropdown styling issues
+
+**Design Decision**: The `title` and `description` props were added to provide better customization flexibility for different use cases. For example, a product filtering dialog might want to display "Filter Products" instead of the generic "Filter", making the interface more contextual and user-friendly. These props maintain backward compatibility by providing sensible defaults.
+
+## [2.1.2] - 2025-12-17
+
+### Added
+- Color support enhancements
+
+## [2.1.0] - 2025-12-17
+
+### Added
+- **HazoUiFlexInput**: New enhanced input component with type validation, character restrictions, and error messaging
+  - Supports multiple input types: mixed (text), numeric, alpha (letters only), and email
+  - Real-time character filtering for numeric and alpha types
+  - Validation on blur with clear error messages
+  - Numeric constraints: min/max value validation and decimal precision control
+  - Length constraints: configurable minimum and maximum character lengths
+  - Custom regex pattern support
+  - Optional format guide helper text
+  - Fully typed TypeScript interfaces
+
+**Design Decision**: HazoUiFlexInput extends the shadcn Input component to provide comprehensive validation without requiring external form libraries. The validation-on-blur approach prevents disruptive real-time error messages while users are typing, improving the overall user experience.
+
+## [2.0.0] - 2025-12-17
+
+### Added
+- **HazoUiFlexRadio**: New flexible radio button/icon selection component
+  - Support for single and multi-selection modes
+  - Layout options: horizontal or vertical
+  - Style variants: radio button style or icon-only button style
+  - Integration with react-icons library (supports 10+ icon sets: fa, md, hi, bi, ai, bs, fi, io, ri, tb)
+  - Label control with show/hide options
+  - Tooltips with 1-second delay
+  - Fully controlled component with value/onChange pattern
+  - TypeScript support with complete type definitions
+  - Accessibility features using Radix UI primitives
+
+**Design Decision**: HazoUiFlexRadio was designed to provide maximum flexibility for both traditional radio button interfaces and modern icon-based selection patterns. The dual-mode support (single/multi selection) reduces the need for separate checkbox implementations.
+
+## [1.0.0] - 2025-12-17
+
+### Added
+- **HazoUiMultiFilterDialog**: Multi-field filtering component
+  - Support for text, number, combobox, boolean, and date field types
+  - Operator support for number and date fields (equals, greater than, less than, etc.)
+  - Dynamic field addition and removal
+  - Built-in field validation for text length, number ranges, and decimal precision
+  - Visual feedback with active filters tooltip
+  - Clear all filters functionality
+  - Responsive design for mobile and desktop
+  - TypeScript support with complete interfaces
+  - Accessibility using Radix UI primitives
+
+- **HazoUiMultiSortDialog**: Multi-field sorting component with drag-and-drop
+  - Multiple sort fields with priority ordering
+  - Drag-and-drop reordering using @dnd-kit
+  - Direction toggle for each field (ascending/descending)
+  - Visual feedback during drag operations
+  - Clear all sorts functionality
+  - Tooltip display of active sort configuration
+  - Keyboard navigation support
+  - Responsive design
+  - TypeScript support
+  - Accessibility features
+
+- **Base UI Components**: Shadcn/ui components integration
+  - Button, Dialog, Command, Popover, Select, Input, Label, Switch, Tooltip, Calendar
+  - Tailwind CSS theming with CSS variable support
+  - Light and dark mode support
+
+- **Build Configuration**:
+  - tsup bundler for ESM + CJS outputs
+  - TypeScript declarations generation
+  - Tree-shakeable exports
+  - "use client" directive for Next.js compatibility
+
+- **Development Tools**:
+  - Storybook integration for component development
+  - Next.js dev app for integration testing
+  - TypeScript strict mode
+  - ESLint configuration
+
+**Design Decision**: The library was built on shadcn/ui and Radix UI primitives to ensure accessibility, maintainability, and consistency with modern React patterns. The choice of @dnd-kit for drag-and-drop provides excellent accessibility support compared to alternatives like react-beautiful-dnd.
+
+## [Unreleased]
+
+### Planned
+- Additional field types for filtering (time, datetime, multi-select)
+- Preset filter configurations for common use cases
+- Export/import filter configurations
+- Advanced sort options (null handling, case sensitivity)
+- Performance optimizations for large datasets
+
+---
+
+## Version History Reference
+
+- **2.7.3** - Tailwind v4 migration (internal build), tw-animate-css, canonical version sync
+- **2.7.2** - HazoUiPillRadio component
+- **2.7.1** - Rename 'danger' to 'destructive', extract shared animations, shadcn/ui re-exports
+- **2.7.0** - HazoUiConfirmDialog, shadcn/ui primitive re-exports
+- **2.6.x** - HazoUiDialog variants, compositional API, fixedSize, bug fixes
+- **2.5.x** - Multiple command instances, dialog docs
+- **2.4.0** - HazoUiCommand, HazoUiTextbox, HazoUiTextarea
+- **2.3.0** - HazoUiRte rich text editor
+- **2.2.0** - Customizable dialog titles and descriptions
+- **2.1.0** - HazoUiFlexInput component
+- **2.0.0** - HazoUiFlexRadio component
+- **1.0.0** - Initial release with filter and sort dialogs