@nice2dev/ui 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,258 @@
+# Changelog
+
+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.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._

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 NiceToDev
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.