# [1.1.0] — 2026-05-21 (cd. — batch 6: number/rate/file/search/tag/prompt/palette/lightbox)

### Added — Numeric input / rating / async search / tag input / overlays / command palette

Kolejne 8 planned-only doc.json stubs → real components
(64/64 tests passed):

**Editors / inputs:**

- `NiceNumericInput` — spinbutton z +/-, clamping, step, precision,
  pluggable `format` (string z `{value}` placeholder lub funkcja).
  `role="spinbutton"` + pełne `aria-valuenow/min/max`.
- `NiceRate` — star rating z arrow-key nav, Home/End extremes,
  `allowHalf` granulacją, custom character override, clear-on-click-same.
- `NiceFilePicker` — visual wrapper na `<input type=file>` z hidden
  input w tab orderze (keyboard equivalence) + proxy clicku z
  customowego triggera. `useNiceTranslation('filePicker.label')`.
- `NiceSearchInput` — combobox z async suggestions + recents
  fallback, request-id guard (stale responses swallowed),
  Down/Up nav + Enter pick.
- `NiceTagInput` — chip multi-value input z paste-with-separator,
  Backspace-deletes-last, suggestions filter, maxTags cap.

**Overlays:**

- `NicePromptDialog` — modal asking for single value (replacement
  dla `window.prompt`). Auto-focus, Enter submits, Escape +
  backdrop cancel. Labels przez `useNiceTranslation('ok','cancel')`.
- `NiceLightbox` — full-screen image viewer z prev/next nav,
  zoom (+/- keys + buttons), download button, N/M counter.
  Wszystkie toolbar labels przez i18n.

**Navigation:**

- `NiceCommandBar` — searchable command palette (Ctrl+K-style)
  z filterowaniem po `label`+`keywords`, grupowaniem po `category`,
  shortcut chip per item, opcjonalnym global shortcut do otwarcia.

---

# [1.1.0] — 2026-05-20 (cd. — batch 5: form fields / feedback / nav / shell)

### Added — Form fields / feedback / mobile gesture / nav / shell

Kolejne 8 planned-only doc.json stubs → real components
(52/52 tests passed):

**Editors / inputs:**

- `NiceCheckboxGroup` — multi-select checkbox set, controlled / uncontrolled,
  horizontal / vertical, per-option disable.
- `NiceToggleGroup` — compound component (`<NiceToggleGroup.Item>`),
  single OR multi-select, ARIA toggle-button pattern z `aria-pressed`.
- `NiceOTPInput` — multi-digit OTP z auto-advance, Backspace step-back,
  Arrow Left/Right nav, pełny-kod paste, separator slot.
  `autoComplete="one-time-code"` dla OS-level autofill.

**Editors / pickers:**

- `NiceCascadeSelect` — multi-column cascading dropdown dla hierarchii.
  Placeholder przez `useNiceTranslation('cascadeSelect.placeholder')`.

**Feedback:**

- `NiceResult` — full-page result state (success/error/info/warning/pending).
  `role="alert"` dla error, `role="status"` dla pozostałych.

**Display:**

- `NiceSwipeCard` — pointer-driven swipe card z unified touch/mouse/pen.
  Threshold-based commit + arrow-key fallback.

**Navigation:**

- `NiceTabBar` — top-level section nav, ARIA tablist pattern, arrow-key
  - Home/End nav skipping disabled tabs, roving tabIndex.

**Layout:**

- `NiceLayout` — app shell (header/aside/main/footer) z natywnymi HTML5
  landmarks. Sider placement start/end.

---

# [1.1.0] — 2026-05-20 (cd. — batch 4: numerical / disclosure / chrome primitives)

### Added — Numerical / disclosure / page-chrome primitives

Kolejne 8 planned-only doc.json stubs → real components
(46/46 tests passed):

**Display (numerical / decorative):**

- `NiceCountUp` — animated counter z requestAnimationFrame + ease-out
  cubic, decimals/prefix/suffix/separator, `onComplete` callback.
  `aria-label` z final value (AT czyta destination raz, nie każdy tick).
- `NiceCountdown` — live countdown do `targetDate`, formats
  `full`/`compact`/`minimal`, per-unit visibility, `role="timer"`
  - `aria-live="polite"`. Labels przez `useNiceTranslation`
    (`countdown.days/hours/minutes/seconds`).
- `NiceCollapsibleCard` — card z built-in collapse affordance,
  trigger='header' lub 'icon'. Chevron `aria-label` przez
  `useNiceTranslation('collapsibleCard.expand/collapse')`.
- `NiceRibbon` — corner banner przyklejający się do top corner
  wrapped elementu (wrapper auto position:relative).

**Layout (disclosure / chrome):**

- `NiceCollapse` — single-panel disclosure z aria-expanded +
  aria-controls auto-wired, controlled / uncontrolled mode.
- `NiceFooter` — semantic `<footer>` z contentinfo landmark, link
  groups jako `<nav>`, social icons z explicit accessible labels,
  optional sticky positioning.
- `NicePageHeader` — dashboard chrome (breadcrumb + back + avatar +
  title + tags + actions + footer slot). Back button label przez
  `useNiceTranslation('pageHeader.back')`.
- `NiceCardGrid` — CSS-Grid layout z responsive columns
  (fixed number lub per-breakpoint map). Reflow czysto CSS bez
  resize listenera (scoped `<style>` z media queries + CSS variable).

---

# [1.1.0] — 2026-05-20 (cd. — batch 3: utility / a11y / nav primitives)

### Added — Utility / accessibility / navigation primitives

Kolejne 8 planned-only doc.json stubs → real components
(33/33 tests passed):

**Utility / accessibility:**

- `NiceClickOutside` — declarative outside-click detector
  (component form of `useClickOutside`). Optional `disabled` flag,
  configurable `mouseEvent` (mousedown/click/mouseup).
- `NiceFocusTrap` — cycles Tab / Shift+Tab between focusable
  descendants. `initialFocus` accepts ref OR CSS selector. Restores
  focus on deactivate by default.
- `NiceLiveRegion` — visually-hidden (or visible) ARIA live region
  with politeness / atomic / relevant knobs.
- `NiceSuspense` — drop-in `React.Suspense` z `delay` (ms) gate —
  prevents the spinner-flash anti-pattern for fast resolves.

**Navigation:**

- `NiceAnchor` — table-of-contents nav z IntersectionObserver
  scroll-spy + smooth-scroll on click, nested items, optional
  `position: sticky`.

**Display:**

- `NiceBackTop` — floating back-to-top button z ease-out cubic
  tween, custom target / duration / glyph. Label przez
  `useNiceTranslation('backTop.aria')`.

**Layout:**

- `NiceAffix` — sticky-position wrapper z onChange callback i
  same-size placeholder zachowującym document flow.
- `NiceMediaObject` — classic media object pattern (image-with-content
  row layout), configurable position / align / spacing.

---

# [1.1.0] — 2026-05-20 (cd. — batch 2: more primitives)

### Added — Layout / typography / display / tools / feedback primitives

Kolejne 8 planned-only doc.json stubs zostało zaimplementowanych jako
prawdziwe kontrolki (47/47 testów passed):

**Typography:**

- `NiceHeading` — semantic h1-h6 z odsprzężoną skalą wizualną
  (`xs`-`3xl`). Renderuje natywny tag dla a11y, designerzy wybierają
  rozmiar niezależnie od poziomu.
- `NiceParagraph` — body-text z wariantami `lead` / `muted` i 3
  rozmiarami (sm/md/lg).
- `NiceLink` — styled `<a>` z `external` przełączającym automatycznie
  `target=_blank` + `rel=noopener noreferrer` (chroni przed
  tab-napping).

**Layout:**

- `NiceContainer` — centrowany wrapper z width preset
  (sm 640 / md 768 / lg 1024 / xl 1280 / full), `padding` na padding-inline.
- `NiceSection` — `<section>` z opcjonalnym headerem
  (title / subtitle / actions slot) i `divider`.

**Display:**

- `NiceStatistic` — KPI tile: tytuł, locale-formatted value (`Intl.NumberFormat`),
  pre/suffix, trend chip z kolorem (up/down).

**Tools:**

- `NiceCopyButton` — copy-to-clipboard z timed feedback. Async
  Clipboard API + execCommand fallback. Etykiety przez
  `useNiceTranslation` (`copy.label`, `copy.success`, `copy.aria`).

**Feedback:**

- `NiceCallout` — info/warning/error/success/tip block z opcjonalnym
  title, custom icon, dismiss button. `role=alert` dla error,
  `role=status` dla pozostałych. Etykieta przez
  `useNiceTranslation('callout.dismiss')`.

---

# [1.1.0] — 2026-05-20

### Added — Layout & typography primitives

Eight long-standing "planned" doc.json stubs are now real components,
implemented as thin CSS-in-component wrappers so consumers can stay
in JSX without dropping to inline style or className soup.

**Layout** (`packages/ui/src/layout/`):

- `NiceCenter` — flex centering on one or both axes, with optional
  `minHeight` for vertical-only scenarios and `inline` for inline-flex.
- `NiceStack` — one-dimensional layout with uniform `spacing`, optional
  `divider` element interleaved between every pair of children.
- `NiceFlex` — direct flexbox container exposing the full `direction` /
  `wrap` / `justify` / `align` / `gap` surface.
- `NiceSpacer` — flexible (`flex`) or fixed-size (`size`) whitespace
  element, with `axis` control. `aria-hidden`.
- `NiceAspectRatio` — width:height ratio container using native CSS
  `aspect-ratio`. Accepts number (`16/9 = 1.777…`) or shorthand string.

**Typography** (`packages/ui/src/typography/`):

- `NiceBlockquote` — semantic `<blockquote>` with optional `author` /
  `cite` footer; three visual variants (`default` / `bordered` /
  `filled`).
- `NiceTruncate` — multi-line line-clamp with optional Show more /
  Show less toggle. Toggle labels go through `useNiceTranslation`
  (`truncate.expand` / `truncate.collapse`) so they follow the global
  language picker.
- `NiceHighlight` — wraps matches of a `query` (string or array) inside
  the source `text` with `<mark>` (or a custom tag). Regex-safe input
  escaping; case-insensitive by default.

**Migration:** The old `packages/ui/docs/<Name>.doc.json` planned stubs
were deleted and replaced with `status: "stable"` doc.json files
colocated next to each `.tsx`. The playground catalog now publishes
these as real components.

**Tests:** Eight new specs added under `__tests__/`. All eight pass
(47 assertions total).

---

# [1.0.14] — 2026-05-11

### Added — CSS Import Support for Vite/Webpack/React

- **style.css import** — You can now import all UI styles in your app entry point with:

      import '@nice2dev/ui/style.css';
      // or
      import '@nice2dev/ui/dist/style.css';

- **package.json improvements**:
  - Added "style" field: "dist/style.css"
  - Added CSS file to "exports" for robust, one-line import in any React/Vite/Webpack app

- **Why?**
  - This is the standard for UI libraries (see: antd, material-ui, bootstrap, etc.)
  - Enables robust, one-line style import in any React/Vite/Webpack app
  - No more hacks with relative paths or <link> in index.html

- **Result:**
  - Users can simply write:

        import '@nice2dev/ui/style.css';

    in their main.tsx and all styles (tokens, animations, pickers, etc.) will work out of the box.

---

# @nice2dev/ui — Changelog

All notable changes to the core UI library.

## [1.0.5] — 2025-01-27

### Added — OmniVerk Export & Visualization Enhancements

- **NiceVennDiagram** — Interactive Venn diagram visualization with up to 5 sets, overlap calculations, animated transitions, export to SVG/PNG
- **NiceCostTracker** — Cost tracking dashboard with budget vs actual charts, variance analysis, forecast projections, category breakdown
- **Enhanced PDF exports** — Improved PDF generation across all OmniVerk controls with custom headers/footers, watermarks, and multi-language support
- **NiceComplianceReport** — Detailed compliance report generator with evidence attachments, audit trail, remediation tracking

### Changed

- **Version bump** — All packages updated to 1.0.5 for release consistency
- **Dependency updates** — Updated core dependencies for security patches

### Documentation

- Updated showcase with new OmniVerk control examples
- Added API documentation for new export features

## [2.5.0] — 2026-03-30

### Added — OmniVerk ERP Controls (FAZA OV-PRIORITY)

Enterprise-grade controls for OmniVerk ERP integration.

- **NiceModuleGrid** — Dynamic data grid for 527+ entity definitions with JSON schema columns, virtual scrolling (100K+ rows), server-side pagination/sorting/filtering, inline editing, column reorder/freeze, mobile card view, export to CSV/Excel/PDF
- **NiceModuleForm** — Dynamic form renderer from JSON schema (ModuleEntityField[]) with 15+ field types, conditional visibility (showWhen), sections/tabs, Polish validators (NIP/REGON/PESEL/IBAN), auto-save drafts, dirty state tracking
- **NiceReconciliationView** — Bank reconciliation split-view with drag-drop matching, color-coded status (matched/partial/unmatched), AI confidence scores, batch auto-match, summary statistics
- **NiceLoanCalculator** — Interactive loan calculator with sliders, annuity/linear/bullet types, payment schedule table, amortization chart, multi-scenario comparison (up to 5), PDF export
- **NiceForecastChart** — Time series chart with forecast visualization, confidence interval bands, multi-scenario overlay (best/expected/worst), annotations, zoom, interactive legend
- **NiceComplianceDashboard** — Certification dashboard with radial progress cards, compliance timeline, gap analysis matrix, evidence tracker, RAG status indicators, exportable reports (ISO 27001, SOC 2, GDPR)

### Documentation

- Added `.doc.json` files for all 6 OmniVerk controls with comprehensive props, examples, accessibility info, and theming docs

## [1.0.4] — 2025-01-26

### Fixed — TypeScript Compatibility (Quality Release)

- **TypeScript strict mode fixes** — resolved 433 TypeScript errors across @nice2dev/ui and @nice2dev/ui-tools
- **Export deduplication** — removed duplicate exports in namespace barrel files
- **BarcodeDetector types** — added proper type definitions for barcode scanning APIs
- **Media component imports** — fixed import paths for audio/video components
- **Interface consistency** — standardized optional properties across control interfaces

### Changed

- **Showcase navigation** — redesigned top navigation with category dropdown (Core UI, Data & Viz, Media, Identity, Business, Advanced) for better organization

## [1.0.1] — 2026-03-25

### Added — New Controls (FAZA 7.1)

- **NiceKanban** — drag & drop Kanban board with swimlanes, WIP limits, filters
- **NiceGantt** — Gantt chart with dependencies, milestones, drag resize, zoom
- **NiceScheduler** — calendar scheduler (day/week/month/timeline, recurring events)
- **NiceRichTextEditor** — Tiptap/ProseMirror-based collaborative editor with mentions, slash commands
- **NiceFileManager** — file browser (tree + grid view, upload, preview, drag & drop)
- **NiceNotificationCenter** — notification center (toast stack, persisted, filters, mark-as-read)
- **NiceChatWidget** — embeddable chat (threads, reactions, file attachments, typing indicator)
- **NiceTimeline** — event timeline (vertical/horizontal, filters, zoom, grouping)
- **NiceOrgChart** — organizational chart (drag & drop, zoom, export SVG/PNG)
- **NiceFlowChart** — flow editor (nodes + edges, minimap, auto-layout)
- **NiceDiffViewer** — text/code diff viewer (unified/split view, syntax highlight)
- **NiceMarkdownEditor** — Markdown editor with live preview
- **NiceSpreadsheet** — lightweight spreadsheet (formulas, freeze panes, import/export XLSX)
- **NiceImageAnnotator** — image annotations (rectangles, arrows, text, blur, crop)
- **NicePDFViewer** — PDF viewer (zoom, search, annotations, thumbnail sidebar)
- **Virtual scrolling** — integrated react-window/react-virtuoso in DataGrid, TreeView, Select
- **Drag & drop** — universal DnD system (dnd-kit integration)
- **Command palette** — Cmd+K / Ctrl+K overlay with fuzzy search
- **Keyboard shortcuts manager** — global shortcuts registry
- **Undo/Redo manager** — global undoable state middleware

### Added — Streaming & Real-time (FAZA 3.2)

- **NiceLiveChart** — auto-append data points (sliding window, 60 fps, pause/resume, stats overlay)
- **createWebSocketDataSource** — full WebSocket data source with reconnect, heartbeat, binary protocol
- **createSSEDataSource** — Server-Sent Events data source (read-only stream)

### Added — Adapter Generator CLI (FAZA 8)

- **AdapterGeneratorCLI** — batch adapter generation for Angular/Vue/WC/Blazor
  - `generateAdapters({ source: 'ui', target: 'angular' })` — auto-generates wrappers for 20 components
  - Component registry with metadata for Button, TextInput, Select, Checkbox, Toggle, Slider, NumberInput, DatePicker, TextArea, Autocomplete, Modal, Alert, DataGrid, Badge, Progress, Avatar, Tabs, Breadcrumb, Drawer, ThemeProvider
  - `runAdapterGenerator(argv)` — CLI entry point: `nice2dev-cli generate adapter --source=ui --target=angular`

### Added — CLI Scaffolding (FAZA 7.4)

- **NiceCLI** — `npx nice2dev init | component | theme | page` with templates
- **NiceModuleGeneratorCLI** — module/view/adapter/component scaffolding
- **NiceFigmaSync** — design token sync from Figma (fetch tokens → NiceTheme)

### Added — i18n

- 10 new languages: DE, FR, ES, UK, CS, JA, ZH-CN, AR, KO, PT-BR
- ICU MessageFormat support (pluralization, gender, ordinals)
- Translation coverage report, auto-translate pipeline, Translation Memory

### Added — Testing

- 70+ unit test files: DataGrid, Chart, Form, DatePicker, Select, Autocomplete, TreeView, hooks, i18n, theme, RBAC, Gantt, Scheduler, Toast, Tooltip
- DataGrid / Chart benchmarks (10k–1M rows/points)
- Bundle size tracking (size-limit CI step)

### Added — Accessibility & Touch

- Full WCAG 2.1 AA support: `NiceA11yProvider`, `useRovingTabIndex`, `useRestoreFocus`
- Touch gestures: `useSwipe`, `usePinch`, `usePan`, `usePullToRefresh`, haptic feedback
- RTL provider with logical properties (`NiceRTLProvider`)

### Added — Data Source

- Advanced: `NiceDataCache`, `NiceRequestDeduplicator`, cursor pagination, infinite scroll
- Offline: `createIndexedDBDataSource`, `createOfflineFirstDataSource`, URL state manager
- Aggregation: `aggregate()`, `groupBy()`, `pivot()`, `validateData()`, batch operations

---

## [1.0.0] — 2025-06-01

Initial production release — 292 source files, 160+ React components.

### Core

- Theme system with CSS variables, light/dark mode, 100+ presets
- i18n provider (PL, EN) with `useNiceTranslation`
- Icon system: `NiceIcon`, `NiceIconProvider`, 300+ built-in SVG icons
- Accessibility: a11y provider, skip links, keyboard hints
- Responsive: breakpoints, media queries, container queries
- DataSource pattern: array, REST, OData, GraphQL adapters

### Components

- **Buttons**: NiceButton, NiceDropDownButton, NiceIconButton, NiceSpeedDial, NiceButtonGroup
- **Editors**: TextInput, NumberInput, Select, Checkbox, Toggle, DatePicker, TextArea, Autocomplete, ColorPicker, RangeSlider, RadioGroup, TagBox, HtmlEditor, CodeEditor
- **Data**: DataGrid (sort, filter, page, virtual scroll, group, pivot, edit), TreeView, CardView
- **Display**: Badge, Progress, Avatar, Skeleton, Empty State, Tooltip, Popover
- **Navigation**: Menu, Navbar, Sidebar, Tabs, Breadcrumb, Drawer, Accordion, Wizard
- **Overlays**: Modal, Dialog, Alert, Toast, ContextMenu
- **Charts**: 21 chart types (bar, line, area, pie, donut, scatter, radar, polar, funnel, treemap, heatmap, candlestick, waterfall, sankey, gauge, sparkline, etc.)
- **Planning**: Scheduler, Gantt
- **Layout**: Splitter, ResponsiveGrid, AppLayout
- **Smart Home**: FloorPlanCanvas, DeviceCard, SceneControl, EnergyDashboard

All notable changes to `@nice2dev/ui` will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

---

## [1.0.1] — 2026-03-24

### Added

#### Navigation

- `NiceSidebarNav` — full OmniVerk sidebar navigation with role / unit / favourites / preferences modes
  - `NiceSidebarNavSource`, `NiceSidebarNavMode`, `NiceSidebarItemDto`, `NiceNavSection`, `NiceNavBadge`
  - `NiceSidebarNavProps`, `NiceSidebarNavRef` (imperative `setMode`, `setQuery`, `focusSearch` API)
  - Accessible: keyboard navigation, ARIA roles, reduced-motion support

### Fixed

- `pdfjs-dist` CJS/ESM compatibility under Vite 6: replaced `new Function('require', …)` pattern with a
  proper dynamic `import()` to align with strict CSP and Vite 6 module resolution (`pdf-loader.ts`)

---

### 🚀 Major Feature Release

70+ new components, advanced data handling, gamification, ERP/business tools, dev utilities, and theme system expansion.

### New Editors

- `NiceAccountPicker` — account selection with search and hierarchy
- `NiceAddressInput` — structured address input with autocomplete
- `NiceCodeEditor` — syntax-highlighted code editor with line numbers
- `NiceColorPalette` — palette-based color selection grid
- `NiceContactPicker` — contact search and selection
- `NiceCurrencyInput` — currency input with symbol, formatting, and exchange rates
- `NiceFileUpload` — simplified file upload component
- `NiceGradientPicker` — gradient builder with stops, angle, and presets
- `NiceImageAnnotator` — image annotation with pins, shapes, and text
- `NiceInvoiceLineEditor` — invoice line items editor with calculations
- `NicePDFAnnotationEditor` — PDF annotation and markup editor
- `NicePhoneInput` — phone number input with country codes
- `NicePinCodeInput` — PIN/OTP code input with digit boxes
- `NiceScannerControl` — barcode/QR scanner camera control
- `NiceTaxRatePicker` — tax rate selection with jurisdictions
- `NiceVatInput` — VAT number input with EU VIES validation
- `NiceWiki` — wiki/knowledge base editor with markdown
- `NiceSignature` — digital signature component (enhanced variant)

### New Display Components

- `NiceAchievementBadge` — gamification achievement badge with progress and tiers
- `NiceAmountBreakdown` — financial amount breakdown (subtotal, tax, total)
- `NiceBusinessCard` — vCard-style business card display
- `NiceDocumentApprovalFlow` — approval workflow visualization with steps and statuses
- `NiceDocumentVersionList` — document version history list with diff
- `NiceInbox` — messaging inbox with read/unread, categories, and previews
- `NiceLeaderboard` — ranked leaderboard with avatars, scores, and highlighting
- `NiceNotificationCenter` — notification panel with categories and mark-as-read
- `NiceQuestCard` — gamification quest/mission card with objectives
- `NiceStatusBadge` — status indicator badge (online, busy, away, offline)
- `NiceXPBar` — experience/progression bar with level labels

### New Charts

- `NiceAdvancedCharts` — additional chart types (waterfall, box plot, bubble, etc.)
- `colors.ts` — extended chart color palette utilities

### New Feedback Components

- `NiceErrorBoundary` — React error boundary with fallback UI and retry
- `NiceOfflineBanner` — offline status indicator banner
- `NiceRetryPanel` — retry panel with exponential backoff and error display

### New Navigation Components

- `NiceNavbar` — responsive navigation bar with mobile hamburger
- `NiceTenantSwitcher` — multi-tenant organization switcher
- `NiceUserMenu` — user profile dropdown with avatar and settings
- `NiceWizard` — multi-step wizard with progress and validation

### New Overlays

- `NiceCommandPalette` — VS Code-style command palette (Ctrl+K)
- `NiceOverlays` — overlay utilities and container

### New Planning Components

- `NiceResourceAllocation` — resource allocation board with capacity view
- `NiceTimeline` — enhanced timeline component with planning features

### New Tools & Utilities

- `NiceAuditLog` — audit trail viewer with filtering and search
- `NiceAuthGuard` — route/component access guard with redirect
- `NiceColumnChooser` — data grid column visibility picker
- `NiceConsentPanel` — GDPR/privacy consent management panel
- `NiceDashboardDesigner` — visual dashboard layout designer with drag-and-drop
- `NiceDiagramDesigner` — diagram design tool
- `NiceDocumentViewer` — universal document viewer (PDF, Office, images)
- `NiceExport` — data export utilities (Excel, CSV, PDF, JSON, XML)
- `NiceFeatureFlags` — feature flag management and gating
- `NiceFormBuilder` — visual form designer with drag-and-drop fields
- `NicePermissionMatrix` — role × permission matrix editor
- `NicePrintPreview` — print preview with page layout options
- `NiceReportBuilder` — visual report/query builder
- `NiceUndoManager` — undo/redo state manager component
- `NiceWorkflowDesigner` — visual workflow/process designer

### Dev Tools

- `NiceApiContractTest` — API contract testing utilities
- `NiceCLI` — CLI framework for component scaffolding
- `NiceCodeGenerator` — code generation utilities
- `NiceESLintPlugin` — ESLint rules for NiceToDev conventions
- `NiceModuleGeneratorCLI` — module scaffolding CLI
- `NiceModuleHealthCheck` — module health check diagnostics
- `NiceModuleHotSwap` — hot module swapping utilities
- `NiceModuleLoader` — lazy module loader with fallback

### View Builder Extensions

- `NiceViewRendererV2` — next-gen view renderer with improved performance
- `NiceViewCache` — view definition caching
- `NiceViewDiff` — visual diff between view definitions
- `NiceViewFetcher` — remote view definition fetching
- `NiceViewHotReload` — hot reload for view definitions
- `NiceViewRegistry` — view definition registry
- `NiceViewSchemaValidator` — view definition JSON schema validation
- `NiceViewStorybook` — Storybook integration for views
- `viewDefinitionV2.ts` — v2 view definition schema

### Framework Utilities

- `NiceComponentTypeMapping` — dynamic component type resolver
- `NiceCrossPlatformSchema` — cross-platform schema definitions
- `NiceDesignTokens` — design token management
- `NiceFigmaSync` — Figma design sync integration
- `NiceModuleManifest` — module manifest schema
- `NiceRbacModel` — role-based access control model

### Core Enhancements

- `a11y-advanced.ts` — advanced accessibility utilities (live regions, focus management)
- `adapters.ts` — I/O adapter abstractions
- `datasource-advanced.ts` — advanced data source (virtual scrolling, tree, grouping)
- `datasource-aggregation.ts` — data aggregation engine (sum, avg, min, max, count)
- `datasource-offline.ts` — offline-first data source with sync
- `icuMessageFormat.ts` — ICU message format for i18n plurals and gender
- `lazy.tsx` — lazy loading utilities with Suspense integration
- `leak-detector.tsx` — memory leak detection dev tool
- `profiling.tsx` — React profiling overlay

### Theme System

- `NiceThemeProvider` — context-based theme provider
- `NiceThemeVariants` — theme variant management
- `NiceUserPreferences` — user preference persistence (theme, language, density)
- `themeGallery.ts` — 90+ theme gallery with categories
- `themeVariants.ts` — theme variant definitions

### File Manager

- `NiceFileManager.types.ts` — extended file manager type definitions
- `NiceFileManagerViews.tsx` — file manager view modes (list, grid, detail)

---

## [1.0.0] — 2026-03-16

### 🎉 Initial Release

The first stable release of `@nice2dev/ui` — a universal, themeable, i18n-ready React component library with **160+ components**, zero runtime dependencies.

### Core Architecture

- **Zero runtime dependencies** — only `react` and `react-dom` as peer dependencies
- **TypeScript-first** — strict mode, full type coverage, exported types for all components
- **CSS Custom Properties theming** — no SASS/LESS rebuild required
- **Built-in i18n** — `NiceI18nProvider` + `useNiceTranslation` with pluggable translation function
- **RTL support** — `NiceRTLProvider` with logical CSS properties
- **Accessibility (a11y)** — WCAG 2.1 AA, ARIA attributes, keyboard navigation, `NiceA11yProvider`
- **Animation system** — `useNiceTransition`, `useNiceCollapse`, stagger delays
- **Responsive utilities** — `useBreakpoint`, `useMediaQuery`, `useResponsiveValue`, `useContainerSize`
- **Touch support** — `useIsTouchDevice`, `useInputMode`, `useLongPress`, responsive touch CSS
- **Access control** — `NiceAccessControl` provider with `'full' | 'readOnly' | 'disabled' | 'hidden'` modes
- **Data source abstraction** — Array, REST, OData, GraphQL, Custom data sources with hooks
- **Testing utilities** — `testId`, `niceSelectors`, `NiceTestWrapper`, `simulateKeyboard`

### Themes (7 built-in presets)

- `niceThemeLight` — Clean light theme (default)
- `niceThemeDark` — Dark mode
- `niceThemeBlue` — Professional blue
- `niceThemeHighContrast` — WCAG AAA high contrast
- `niceThemeMaterial` — Material Design inspired
- `niceThemeBootstrap` — Bootstrap-like styling
- `niceThemeFluent` — Microsoft Fluent UI inspired

### Editors (28 components)

- `NiceTextInput` — Text input with label, validation, icons
- `NiceTextArea` — Multi-line text input with auto-resize
- `NiceNumberInput` — Numeric input with spin buttons, formatting
- `NiceDatePicker` — Date selection with calendar popup
- `NiceDateTimePicker` — Combined date + time picker
- `NiceTimePicker` — Standalone time picker (12h/24h, clock dial)
- `NiceDateRangeBox` — Date range selection
- `NiceSelect` — Dropdown select with groups, virtualizing, async search
- `NiceAutocomplete` — Autocomplete with grouped suggestions, highlight matching
- `NiceCheckbox` — Checkbox with indeterminate state
- `NiceToggle` — Toggle switch
- `NiceRadioGroup` — Radio button group
- `NiceSlider` — Single-value slider
- `NiceRangeSlider` — Dual-handle range slider
- `NiceColorPicker` — Color picker with palette and custom input
- `NiceCalendar` — Full calendar with week numbers, multi-select, custom day rendering
- `NiceTagBox` — Multi-value tag input
- `NiceDropDownBox` — Generic dropdown container
- `NiceForm` — Dynamic form with responsive columns, conditional fields, field groups
- `NiceHtmlEditor` — Rich text editor with tables, image upload, mentions, code blocks, markdown mode
- `NiceMaskedInput` — Input with configurable mask patterns
- `NiceRating` — Star/icon rating input with half-star support
- `NicePasswordInput` — Password with visibility toggle and strength meter
- `NiceInputOtp` — OTP verification code input
- `NiceKnob` — Circular dial numeric input
- `NiceMention` — @mention component for tagging
- `NiceTreeSelect` — Tree-based dropdown select
- `NicePickList` — Dual-list picker (source ↔ target)

### Buttons (5 components)

- `NiceButton` — Primary button with variants, sizes, icons
- `NiceButtonGroup` — Grouped buttons
- `NiceIconButton` — Icon-only button
- `NiceDropDownButton` — Button with dropdown menu
- `NiceSpeedDialAction` — Floating speed dial

### Data & Tables (15 components)

- `NiceTable` — Simple HTML table wrapper
- `NiceDataGrid` — Full-featured data grid: virtual scrolling, column pinning, inline editing, row grouping, aggregation, master/detail, Excel/CSV/PDF export, clipboard, sparklines, context menu, quick filter, cell flashing
- `NiceTreeGrid` — Tree + grid hybrid with hierarchy
- `NiceTreeView` — Tree with drag-and-drop, lazy loading, checkboxes, search, context menu, inline editing
- `NiceTreeList` — Flat tree list
- `NiceList` — List with grouping, swipe actions, selection
- `NiceCardView` — Card-based data view
- `NiceTileView` — Tile/grid data view
- `NicePivotGrid` — Pivot table with drill-through, calculated fields, chart integration
- `NicePivotGridFieldChooser` — Field chooser for pivot grid
- `NiceKanbanBoard` — Drag-and-drop task board (Trello-style)
- `NiceSpreadsheet` — Excel-like spreadsheet with formulas and multiple sheets
- `NiceLookup` — Lookup field with search
- `NiceCascadeSelect` — Cascading dropdown (Country → City)
- `NiceMultiColumnComboBox` — Multi-column dropdown

### Charts & Visualization (18 components)

- `NiceChart` — Line, bar, area, scatter charts with zoom/pan, crosshair, annotations, drill-down, export, real-time updates
- `NicePieChart` — Pie and donut charts
- `NicePolarChart` — Radar and polar charts
- `NiceCircularGauge` — Circular gauge
- `NiceLinearGauge` — Linear gauge
- `NiceBarGauge` — Bar gauge
- `NiceSparkline` — Inline sparkline charts
- `NiceBullet` — Bullet chart
- `NiceFunnel` — Funnel chart
- `NiceSankey` — Sankey diagram
- `NiceRangeSelector` — Range selection with chart preview
- `NiceVectorMap` — SVG vector map
- `NiceOrganizationChart` — Org chart / tree layout
- `NiceHeatMap` — Heat map
- `NiceTreeMap` — Treemap visualization
- `NiceStockChart` — Financial candlestick/OHLC charts
- `NiceBarcodeGenerator` — Barcode generator (Code128, EAN, UPC)
- `NiceQRCode` — QR code generator

### Display (18 components)

- `NiceBadge` — Count/status badge
- `NiceTag` — Tag/chip component
- `NiceAvatar` — User avatar
- `NiceAvatarGroup` — Stacked avatar group
- `NiceProgress` — Progress bar
- `NiceDivider` — Horizontal/vertical divider
- `NiceTooltip` — Tooltip with arrow, follow cursor, rich content
- `NiceSkeleton` — Loading skeleton
- `NiceSpinner` — Loading spinner
- `NiceEmpty` — Empty state placeholder
- `NiceTimeline` — Vertical/horizontal timeline
- `NiceCarousel` — Image/content carousel with autoplay
- `NiceVirtualScroller` — Virtual scrolling container
- `NiceImageViewer` — Image with zoom, rotate, lightbox
- `NicePDFViewer` — Embedded PDF viewer
- `NiceTerminalUI` — CLI-style terminal component
- `NiceIcon` — SVG icon component (78 built-in icons)
- `NiceDataDisplay` — Generic data display

### Feedback (10 components)

- `NiceAlert` — Alert banners (info, success, warning, error)
- `NiceModal` — Modal dialog with fullscreen, stacking
- `NiceDrawer` — Slide-out drawer panel
- `NiceToast` / `NiceToastContainer` — Toast notifications
- `NiceConfirmDialog` — Pre-built confirmation dialog
- `NiceCookieConsent` — GDPR cookie consent banner
- `NiceLoginForm` — Pre-built login form

### Navigation (21 components)

- `NiceTabs` / `NiceTabPanel` — Tab navigation
- `NiceAccordion` — Collapsible accordion
- `NiceBreadcrumb` — Breadcrumb navigation
- `NicePagination` — Page navigation
- `NiceCard` — Card container
- `NiceMenu` — Multi-level menu with keyboard navigation
- `NiceContextMenu` — Right-click context menu
- `NiceMultiView` — View switching container
- `NiceSplitter` — Resizable split panes
- `NiceToolbar` — Toolbar with items
- `NiceAppLayout` — Application shell (header + sidebar + content)
- `NiceBottomNavigation` — Mobile bottom nav bar
- `NiceMegaMenu` — Full-width mega menu
- `NiceDashboardLayout` — Drag-and-drop dashboard panels
- `NiceDock` — macOS-style dock bar
- `NiceDesktop` — Desktop metaphor with taskbar, start menu, system tray
- `NiceConsole` — Developer console with tabs and commands

### Overlays & Layout (14 components)

- `NiceActionSheet` — Bottom action sheet
- `NicePopover` — Popover with positioning
- `NiceLoadPanel` — Loading overlay
- `NiceBox` — Flex box container
- `NiceResponsiveBox` — Responsive layout container
- `NiceResizable` — Resizable wrapper
- `NiceScrollView` — Custom scroll container
- `NiceBlockUI` — UI blocking overlay
- `NiceWindow` — Draggable, resizable window
- `NiceWindowManager` — Multi-window manager with taskbar
- `NiceTutorial` — Step-by-step tutorial overlay
- `NiceTutorialProvider` — Tutorial context provider

### Planning (4 components)

- `NiceScheduler` — Calendar scheduler with day/week/month/timeline/agenda views, recurring events, drag-and-drop, categories, tooltips, work hours, current time indicator
- `NiceGantt` — Gantt chart with dependencies, resource assignment, critical path, baseline comparison, zoom
- `NiceDiagram` — Diagram editor with shapes, snap-to-grid, auto-layout, swimlanes, undo/redo, export
- `NiceStepper` — Step-by-step wizard

### Tools (14 components)

- `NiceChat` — Chat/messaging component
- `NiceDraggable` — Draggable wrapper
- `NiceSortable` — Sortable list
- `NiceFileUploader` — File upload with drag-and-drop, preview, progress, chunked upload, clipboard paste
- `NiceFileManager` — File browser with dual-pane Norton Commander mode
- `NiceFilterBuilder` — Visual query builder with presets, custom operators, nested groups
- `NiceGallery` — Image gallery
- `NiceMap` — Interactive map with markers
- `NiceSpeechToText` — Speech recognition input
- `NiceValidationGroup` / `NiceValidator` / `NiceValidationSummary` — Form validation system
- `NiceThemeDesigner` — Visual theme editor
- `NiceThemeBuilder` — Theme builder tool
- `NiceControlConfigurator` — Component configurator
- `NiceShowcase` — Self-contained library showcase / documentation component

### Advanced Editors (4 components)

- `NiceMarkdownEditor` — Markdown editor with split preview
- `NiceInPlaceEditor` — Click-to-edit inline editor
- `NiceImageEditor` — Image editing (crop, rotate, annotate)
- `NiceDocumentEditor` — Word-processor editor
- `NiceSignaturePad` — Digital signature capture

### View Builder (3 components)

- `NiceViewBuilder` — Visual UI builder
- `NiceViewRenderer` — Renders view definitions
- View definition utilities: `serializeView`, `deserializeView`, `generateViewId`

### Hooks (14 exported hooks)

- `useControlId` — Stable unique ID generation
- `useDebouncedValue` — Debounced value
- `useClickOutside` — Click outside detection
- `useFocusTrap` — Focus trapping
- `useIsTouchDevice` — Touch device detection
- `useInputMode` — Touch vs mouse mode detection
- `useLongPress` — Long press gesture
- `useBreakpoint` — Current breakpoint
- `useMediaQuery` — CSS media query match
- `useResponsiveValue` — Responsive value selection
- `useContainerSize` — Container dimensions
- `useNiceTranslation` — i18n translation hook
- `useNiceToast` — Toast notifications
- `useNiceValidation` — Validation state

### Icons

- **78 built-in SVG icons** accessible via `<NiceIcon name="..." />`
- `NiceIconProvider` for pluggable custom icon resolvers
- Icons: add, alert, arrow-\*, calendar, chart, check, close, copy, delete, download, edit, email, file, filter, folder, grid, heart, help, home, image, info, link, list, lock, mail, menu, minus, notification, paste, person, phone, pin, play, plus, print, refresh, save, search, settings, share, sort, star, sync, table, tag, time, trash, tree, undo, redo, upload, view, warning, zoom-in, zoom-out, and more

### CSS

- **BEM naming convention** throughout
- **CSS Custom Properties** for all theme tokens
- **Dark mode** support via `.nice-dark` class or `prefers-color-scheme`
- **Touch-optimized CSS** — `@media (pointer: coarse)` for larger touch targets
- **Responsive breakpoints** — Mobile (≤575px), Tablet (≤767px), Desktop (≥992px)
- **Print styles** — `@media print` with hidden scrollbars, no shadows
- Two CSS files: `controls.css` (~1500 lines) + `controls-extended.css` (~2400 lines)

---

_This is the first official release. For feature requests or bug reports, please open an issue on GitHub._
