# @nice2dev/ui-graphics — Changelog

All notable changes to the graphics editors package.

## [Unreleased] — OmniVerk Professional Roadmap

### Planned — Vector Editor Pro (PRO-4.1)

- **Pen Tool Pro** — bezier z simplifikacją i wygładzaniem ścieżek
- **Shape Builder** — interaktywne operacje boolowskie
- **Gradient Mesh** — mesh gradient fills
- **Symbol Library** — wielokrotnego użytku symbole z override'ami
- **Perspective Grid** — rysunek w perspektywie 1/2/3 punktowej
- **Image Trace** — konwersja bitmap na wektory

### Planned — Photo Editor Pro (PRO-4.2)

- **RAW Development** — pełne przetwarzanie RAW (exposure, WB, curves, HSL)
- **Layer System Pro** — warstwy dopasowania, style, smart objects
- **Masking Pro** — szybkie zaznaczanie, luminosity masks
- **HDR Merge** — łączenie ekspozycji bracketing
- **Focus Stacking** — rozszerzona głębia ostrości
- **16-bit/32-bit** — obsługa wysokiej głębi bitowej

### Planned — Pixel Art Editor Pro (PRO-4.3)

- **Indexed Color Mode** — paleta z cyklowaniem kolorów
- **Animation Tags** — oznaczone zakresy animacji
- **Tilemap Mode** — zintegrowana edycja tilemap
- **NES/SNES Palette Limits** — ograniczenia konsol retro

### Planned — Animation Editor Pro (PRO-4.4)

- **Character Rigging** — system kości z IK, constraints
- **Graph Editor** — pełna edycja krzywych animacji
- **Lip Sync** — animacja ust sterowana audio
- **Lottie/Spine Export** — formaty animacji webowych i gier

---

## [1.0.1] — 2026-03-25

### Added (FAZA 7.4)

- **AI-powered tools** — auto-colorization, background removal, style transfer, upscale (ESRGAN)
- **Font editor** — create/edit fonts (OTF/TTF), glyph editor, kerning, OpenType features
- **Collaborative editing** — multi-user canvas (Yjs/CRDT)
- **Plugin system** — API for custom tools / filters / exporters
- **Brush engine v2** — pressure sensitivity (Wacom), tilt, rotation, custom brush shapes
- **SVG to code** — export SVG as React/Vue component with props

---

## [1.0.0] — 2025-06-01

Initial production release — 9 editor modes.

- Pixel editor (layers, palette, animation frames, sprite sheet export)
- Vector editor (paths, shapes, boolean ops, SVG export)
- Photo editor (filters, adjustments, crop, transform, layers, masks)
- Animation editor (keyframes, timeline, onion skin, GIF/APNG export)
- Game asset editor (sprite atlas, tile palette, animation strips)
- Icon editor (SVG, multiple sizes, export React/Vue components)
- UI editor (wireframes, mockups, components, responsive preview)
- Texture editor (seamless tile, normal map gen, PBR channels)
- Font editor — OTF/TTF glyph editing

All notable changes to `@nice2dev/ui-graphics` 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.2.0] — 2026-06-16

### 🎮 Game Asset Editors & Sprite Generation

Major expansion with game asset creation tools, procedural sprite generation, and deep sub-editor features.

### Game Asset Editors (`game/`)

- **GameAsset2dEditor** — full 2D game asset editor with canvas tools, layers, and export
- **CollisionEditor** — visual collision shape editor (box, circle, polygon, compound)
- **AnimationPreviewPlayer** — frame-by-frame preview with speed control and looping
- **GameAssetExportPanel** — export panel with sprite sheet, atlas, and format settings
- **IsometricEditor** — isometric tile editor with grid snapping and stacking
- **IsometricTilePanel** — tile palette and tileset management
- Hooks: `useGameAssetEditor`, `useCollisionEditor`, `useAnimationPreview`, `useGameAssetExport`
- Types/Utils: `gameAssetTypes.ts`, `gameAssetUtils.ts`, `gameAssetExport.ts`, `isometricTiles.ts`

### Pixel Editor — Sprite Generation

- **SpriteGeneratorPanel** — procedural sprite generator with symmetry, noise, and palette mapping
- **spriteGeneratorCore** — core generation engine with configurable algorithms
- **characterGeneratorPresets** — humanoid character sprite presets (warrior, mage, rogue, etc.)
- **buildingGeneratorPresets** — building sprite presets (house, castle, tower, shop)
- **animalGeneratorPresets** — animal sprite presets (bird, cat, dog, dragon, etc.)
- **pixelAnimationPresets** — walk cycle, idle, attack, and effect animation presets
- **pixelEffectsEngine** — pixel-level effects (glow, outline, shadow, dithering)
- **pixelEquipmentSystem** — equipment overlay system for character sprites
- **pixelSkeletonSystem** — skeleton-based pixel animation rig
- **pixelSpriteTemplates** — base sprite templates for generation

### Pixel Editor — Additional Features

- **PaletteExtractorPanel / paletteExtractor** — extract color palettes from images
- **HSVPicker** — HSV color picker component
- **TileMapPanel / tileMapMode** — tile map painting mode
- **asepriteFormat** — Aseprite .ase/.aseprite file import/export
- Sub-components: `PixelEditorCanvas`, `PixelEditorMenuBar`, `PixelEditorRightPanel`, `PixelEditorStatusBar`, `PixelEditorTimeline`, `PixelEditorToolbar`

### Vector Editor — New Features

- **PathSimplificationPanel / pathSimplification** — reduce path complexity (Ramer-Douglas-Peucker)
- **PdfExportPanel / pdfExport** — export vector artwork to PDF
- **TextOnPathPanel / textOnPath** — text flowing along Bézier paths
- **vectorPatternFills / VectorPatternPanel** — repeating pattern fills (dots, stripes, custom SVG)
- **vectorSvgFilters / VectorFilterPanel** — SVG filter effects (blur, shadow, glow, emboss)
- **vectorGradients** — advanced gradient system with multi-stop and mesh gradients
- **vectorBooleanOps** — union, intersect, subtract, exclude path operations
- Import/Export: `vectorEditorImport.ts`, `vectorEditorExport.ts`
- Sub-components: `VectorEditorMenuBar`, `VectorEditorRightPanel`, `VectorEditorShapeRenderer`, `VectorEditorStatusBar`

### Photo Editor — New Features

- **StyleTransferPanel / aiStyleTransfer** — AI neural style transfer
- **BatchProcessingPanel / batchProcessing** — batch process multiple images
- **FaceDetectionPanel / faceDetection** — automatic face detection and tagging
- **PerspectiveCorrectionPanel / perspectiveCorrection** — 4-point perspective correction
- **RawFilePanel / rawFileSupport** — RAW camera file support (CR2, NEF, ARW)
- **photoOverlays** — watermark and overlay system
- **photoSelection** — advanced selection tools (magic wand, lasso, quick select)
- Sub-components: `PhotoEditorCanvas`, `PhotoEditorLeftPanel`, `PhotoEditorToolbar`, `FilterThumb`

### Animation — Rigging System (`animation/rig/`)

- **RiggedBody** — skeleton-rigged character with bone hierarchy
- **RigPlayer** — animation playback for rigged characters
- Inverse kinematics (IK), pose operations, animation presets
- **Audience** — crowd/audience rendering component
- **BodyRenderer** — character body rendering with shape-based anatomy
- **choreoDSL** — choreography domain-specific language
- **choreography** — choreography sequencing system
- **karaokeIntegration** — karaoke sync with animated characters
- Shape libraries: arms, eyes, hair, heads, headwear, legs, mouths, noses, outfits, torsos

### Core

- `useGamepad` — gamepad input hook for editors
- `usePointerPressure` — pressure-sensitive stylus input hook
- `LocalUI` — local UI overlay component for in-editor panels

---

## [1.1.0] — 2026-06-15

### 🚀 Major Feature Release

Massive expansion: 4 new editors, physics engine, integrations, collaboration, and significant UX improvements.

### New Editors

- **NiceIconEditor** — SVG icon design with grid alignment, variant support (outline/filled/duotone), React component export
- **NiceUIDesigner** — drag & drop UI builder with 12 component types and React/TSX code generation
- **Nice3DTexturePainter** — UV texture painting with layer support, brush tools, blend modes
- **NiceFontEditor** — glyph editor with Unicode mapping, SVG font export, text preview

### Animation

- **Physics simulation** — Verlet integration engine with ragdoll (14-bone) and cloth (spring-mass grid)
- **Motion path editor** — cubic Bézier paths with arc-length parameterization, preset paths (linear, circular, figure-8)
- **Lottie/Bodymovin export** — export animations to Lottie JSON format
- **Spine export** — export to Spine 4.1 JSON format for game engine integration

### Shared Editor Features

- **Plugin system** — extensible architecture with tool/filter/exporter/panel/menu registration and React context
- **Visual undo/redo** — timeline-based history with thumbnail previews and jump-to-any-point
- **Customizable shortcuts** — remappable keyboard shortcuts with localStorage persistence
- **External drag & drop** — drop files from desktop with MIME validation and image conversion
- **RTL UI support** — full right-to-left layout with CSS logical properties and auto-detection

### UX Improvements

- **Zoom navigator (minimap)** — draggable viewport overview with position presets
- **Grid, guides & rulers** — configurable grid, horizontal/vertical rulers, draggable guides with snap
- **Color blindness simulation** — 9 vision type simulations (Machado et al.), canvas filter + SVG filter generation
- **Dark/light theme** — 20+ color tokens, auto system theme detection, localStorage persistence

### Integrations

- **Unsplash/Pexels** — stock image search providers
- **Adobe Creative Cloud** — OAuth connector with library import
- **Figma** — file import with SVG extraction and plugin code export
- **Template library** — searchable template system with categories
- **AI image generation** — OpenAI DALL-E 3, Stability AI, and custom provider support

### Collaboration

- **Real-time editing** — WebSocket transport with cursor/selection sync and operation broadcasting
- **Comments & annotations** — threaded comments anchored to canvas coordinates
- **Version history** — snapshot system with named versions and thumbnail previews

### Bug Fixes

- **Retina canvas** — proper devicePixelRatio scaling for sharp rendering on HiDPI displays
- **Vector performance** — SpatialHashGrid for O(1) spatial queries with >100 shapes
- **Animation memory leak** — AnimationCleanup utility for tracking and disposing RAF/timer resources

---

## [1.0.0] — 2026-03-17

### 🎨 Initial Release

First stable release of `@nice2dev/ui-graphics` — pixel, vector, photo & animation editors for React.

### Features

- **NicePixelEditor** — full pixel art editor with layers, palette, tools, animation timeline
- **NiceVectorEditor** — SVG-based vector drawing with shapes, paths, groups, boolean ops
- **NicePhotoEditor** — image editing with filters, adjustments, crop, rotate, resize
- **NiceAnimationEditor** — frame-by-frame and tweened animation with onion skinning
- **NiceAnimatedPerson** — rigged character with poses, limb manipulation, expressions
- **Export** — PNG, JPEG, SVG, GIF, sprite sheet export
- **Undo/Redo** — full history stack for all editors
- **Clipboard** — copy/paste shapes, selections, layers across editors
- **Grid & Snapping** — pixel grid, smart guides, snap-to-grid
- **Color** — RGBA, HSLA, HEX picker with palette management
