@nice2dev/icons 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,124 @@
+# Changelog
+
+All notable changes to `@nice2dev/icons` 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-17
+
+### Added
+
+#### Icon Library
+- **350+ icons** across 21 categories (UI, Navigation, Media, Communication, Commerce, Files, Weather, Social, Arrows, Shapes, Devices, Finance, Health, Food, Travel, Sports, Animals, E-commerce, Fintech, SaaS, SmartHome)
+- **DevTech Logo Icons:** Vite, Bun, Deno, Tauri, Svelte, Next.js, Astro, Qwik, SolidJS
+
+#### Icon Variants
+- `solid` — Filled icon shapes
+- `outline` — Stroked paths only
+- `duotone` — Two-tone rendering with background layer
+- `flat` — Badge-style with colored background
+- `sharp` — Solid with sharp corners (no rounded edges)
+- `rounded` — Solid with extra-rounded corners
+- `mini` — Compact, optimized for small sizes (12-16px)
+- `3d` — Pseudo-3D with SVG filter shadows and highlights
+
+#### Multi-Color System
+- `primaryColor`, `secondaryColor`, `accentColor` props
+- Per-color opacity controls (`primaryOpacity`, `secondaryOpacity`, `accentOpacity`)
+
+#### Gradient Fills
+- 12 gradient presets: `sunset`, `ocean`, `aurora`, `fire`, `forest`, `candy`, `steel`, `royal`, `neon`, `earth`, `ice`, `lava`
+- Linear and radial gradient types
+- Configurable gradient angle
+- Gradient animations: `shift`, `spin`, `pulse`
+
+#### CSS Animations
+- **65+ CSS animations** organized in categories:
+  - Core transforms: spin, pulse, bounce, shake, float, flip, glow, wiggle, rubber, swing, tada, heartbeat
+  - Entrances: fade-in, slide-up/down/left/right, drop, rise, roll-in, materialize, vortex, meteor, scale-in, signature, draw-sequence, reveal, unfold, assemble, draw
+  - Exits: scale-out, fold, dissolve
+  - Organic: breathe, drift, orbit, sway, tilt, rock, pendulum, levitate, flap, skate
+  - Energetic: jello, pop, squeeze, crush, stretch, stomp, snap, twist, dash, surge
+  - Effects: flash, blink, flicker, vibrate, tremble, glitch, neon, earthquake
+  - Complex: wobble, spiral, warp, morph, zoom-pulse, ripple, radar
+  - Dramatic: ping, implode, explode, scatter, rotate-x, draw-loop
+
+#### SMIL Animations (SVG-native)
+- **25 SMIL animation types** as CSS alternative:
+  - spin, pulse, bounce, shake, float, flip, wiggle, heartbeat
+  - scale-pulse, grow, shrink, rubber, pop, fade, blink, glow
+  - slide-x, slide-y, orbit, wave, draw, draw-reverse, color-shift
+- `SmilAnimationWrapper` component
+- `generateSmilAnimation` utility function
+- Configurable duration, easing, repeat count, delay
+
+#### Animation Controls
+- `AnimationController` component with play/pause/reset/goToStep
+- `InteractiveIcon` component with trigger support:
+  - `hover` — animate on mouse enter/leave
+  - `click` — animate on click
+  - `focus` — animate on focus/blur
+  - `visible` — animate when scrolled into view (IntersectionObserver)
+- Animation sequences (chain multiple animations)
+- Preset sequences: attention, success, error, loading, celebrate, notification, gentle, reveal
+- Preset interactions: hoverBounce, hoverPulse, hoverSpin, clickPop, clickTada, visibleFadeIn, visibleBounce
+
+#### NiceIconPicker Component
+- Searchable dropdown with category tabs
+- Grid preview with configurable icon size
+- Controlled selection (`value`/`onChange`)
+- Multi-select mode (`multiSelect`, `values`, `onChangeMulti`)
+- Maximum selection limit (`maxSelections`)
+- Virtualization for 1000+ icons
+- Favorites with localStorage persistence
+- History of recently used icons
+- **Drag & drop** to external applications (SVG data, JSON metadata)
+- Keyboard navigation (Escape to close)
+- Click-outside dismissal
+- Clearable selection
+- Imperative handle for programmatic control
+
+#### Figma/Sketch Export
+- `exportIconToSvgString()` — clean SVG string for Figma import
+- `exportIconToDataUrl()` — base64 data URL
+- `downloadIconAsSvg()` — browser download as SVG
+- `downloadIconAsPng()` — browser download as PNG (with scale support)
+- `copyIconToClipboard()` — copy SVG to clipboard
+- `batchExportIcons()` — export multiple icons at once
+- `generateFigmaPluginManifest()` — JSON manifest for Figma plugins
+- Figma-compatible type definitions (FigmaVectorPath, FigmaIconFrame, etc.)
+
+#### NiceVectorEditor Component
+- Simple vector editor for creating custom icons
+- Layer management (vector, text, image layers)
+- SVG export functionality
+
+#### Developer Experience
+- `createIcon()` factory function for custom icons
+- Full TypeScript with strict mode
+- TSDoc documentation for all public APIs
+- Zero runtime dependencies (React as peer)
+- Rollup build (CJS + ESM bundles)
+- Vitest for unit testing
+- Storybook for documentation
+
+### Technical Details
+
+- **Package name:** `@nice2dev/icons`
+- **Peer dependencies:** React 18+
+- **Bundle formats:** CommonJS (`dist/cjs`), ESM (`dist/esm`)
+- **TypeScript:** Strict mode enabled
+- **CSS:** BEM-style classes with CSS custom properties for theming
+
+---
+
+## [Unreleased]
+
+### Planned
+- Figma / Sketch export plugin
+- PNG sprite-sheet generation
+- Icon font generation (TTF/WOFF2)
+- Rollup plugin for tree-shaking analysis
+- CDN standalone build
+- Visual regression testing (Chromatic/Percy)

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.