# Changelog

All notable changes to PharmData Design System 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).

## [3.2.0] - 2025-01-27

### Added
- **VERSION file** - Single source of truth for version number
- **New project structure** with clear separation of concerns:
  - `src/tokens/` - Core design tokens (colors, typography, spacing, layout)
  - `src/components/` - UI component styles
  - `src/themes/` - Theme variations (dark mode, density)
  - `src/js/` - JavaScript utilities
- **Consolidated documentation** in `docs/`:
  - `docs/patterns/` - Design pattern documentation
  - `docs/components/` - Component documentation
  - `docs/integrations/` - Integration guides
- **Integration kits** in `integrations/`:
  - `integrations/oracle-apex/` - Oracle APEX theme
  - `integrations/tailwind-preset/` - Tailwind configuration

### Changed
- Reorganized entire project structure for clarity
- Moved patterns documentation to `docs/patterns/`
- Consolidated all markdown files into `docs/`
- Updated `tokens/index.css` to be backward compatible
- Kept `tokens/` as main import path (no build system needed)
- **Expanded `tailwind-config.js`** with spacing, borderRadius, fontSize, lineHeight, letterSpacing

### Fixed
- **Inconsistent fallback values** - Unified all CSS variable fallbacks to match canonical values in `colors.css`
  - `--soft-steel`: unified to `#374151`
  - `--teal-intense`: unified to `#1a8b7d`
  - `--graphite-depth`: unified to `#1F2937`
  - `--error`: unified to `#EF4444`
- **Hardcoded colors in sms.css** - Replaced with CSS variables
- **Dark mode fallbacks in tooltips.css** - Corrected to match actual dark mode values

### Removed
- Duplicate `showcase/tokens/` folder (was outdated copy)
- Duplicate `js/` folder (moved to `src/js/`)
- Duplicate `integration/` folder (moved to `integrations/tailwind-preset/`)

---

## [3.1.0] - 2024-12-30

### Added
- Oracle APEX theme integration
- Interactive Grid styling
- Form label improvements
- Portuguese localization for IRR search

### Fixed
- Dark mode styling for APEX components
- Form input visibility improvements

---

## [3.0.0] - 2024-12-28

### Added
- Complete dark mode implementation
- Skeleton loaders for loading states
- Density modes (compact/comfortable)
- Keyboard shortcuts styling
- Breadcrumb component with pharmaceutical hierarchy

### Changed
- WCAG AAA compliance for status badges
- Improved contrast for review/warning colors

---

## [2.1.0] - 2024-12-11

### Added
- Developer technical documentation
- Comprehensive showcase index
- Documentation map

---

## [2.0.0] - 2024-12-11

### Added
- Expanded token system:
  - `layout.css` - Breakpoints, z-index, containers
  - `loading-states.css` - Skeletons, spinners, progress
  - `tables.css` - Dense data tables
  - `interactions.css` - Tactile feedback, focus states
  - `empty-states.css` - No data, first use states
  - `index.css` - Master import file
- Granular spacing scale (0-128px)
- Standardized z-index system
- Density variants (compact/spacious)
- HTMX integration support

### Changed
- Typography system expanded
- Accessibility improvements (prefers-reduced-motion, high contrast)

---

## [1.2.0] - 2024-11-20

### Added
- **Enrichment Workflow** pattern
- 5 visual states for enrichment
- Curator approval workflow

---

## [1.1.0] - 2024-11-20

### Added
- **Curator-First philosophy** documentation
- View patterns for read-only pages
- Property grids for EAV attributes
- SmilesDrawer integration for molecular structures

### Changed
- Soft Steel color darkened for better contrast
- Drop colors lightened for visual refinement

---

## [1.0.0] - 2024-11-19

### Added
- Initial design system structure
- Compositional forms pattern (PEN&PAD based)
- Progressive disclosure system
- Core documentation