@flogeez/angular-tiptap-editor 2.0.3 → 2.1.1

package/CHANGELOG.md

@@ -5,36 +5,63 @@ All notable changes to `@flogeez/angular-tiptap-editor` will be documented in th
 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).
 
+## [2.1.1] - 2026-01-20
+
+### Fixed
+
+- **Height Units**: Fixed a bug where `minHeight` would result in a double "px" unit (e.g., `200pxpx`) in the DOM.
+- **Character Count Styling**: Improved the footer readability by adding padding to the character/word count area.
+
+## [2.1.0] - 2026-01-20
+
+### Added
+
+- **Unified Configuration**: Introduced `AteEditorConfig`, a single flatter interface to manage all editor settings (fundamentals, display options, and modules) via a new `[config]` input.
+- **Enhanced Image Upload Config**: Restructured image upload settings with dedicated `AteImageUploadConfig`, supporting quality, dimensions, max size (in MB), and allowed types.
+- **Menu Visibility Controls**: Added root-level boolean flags to toggle specific bubble menus (`showBubbleMenu`, `showTableMenu`, `showCellMenu`, `showImageBubbleMenu`) and slash commands (`enableSlashCommands`).
+- **Improved Developer Experience**: Updated the demo's code generator to produce consolidated `AteEditorConfig` boilerplate, making it easier for developers to copy-paste configurations.
+
+### Changed
+
+- **Configuration Precedence**: Standardized the merging logic across all components, ensuring individual inputs correctly override global configuration values while maintaining sensible defaults.
+- **Public API**: Exported `AteEditorConfig` in the public API for better type safety in host applications.
+
 ## [2.0.3] - 2026-01-19
 
 ### Added
+
 - **Edit Toggle**: Added an optional toggle button to switch between editable and view-only modes.
 - **Design Tokens Improvements**: Refined menu border-radius and image styling for a more consistent visual experience.
 
 ## [2.0.2] - 2026-01-18
 
 ### Added
+
 - **Peer Dependencies Optimization**: Added `@tiptap/pm` to `peerDependencies`. This ensures a single shared instance of ProseMirror across the application.
 
 ### Fixed
-- **Slash Commands**: Migrated internal ProseMirror imports (`state`, `view`) to the official `@tiptap/pm` bridge. This aligns the library with Tiptap's recommended architecture and improves compatibility with modern bundlers.
 
+- **Slash Commands**: Migrated internal ProseMirror imports (`state`, `view`) to the official `@tiptap/pm` bridge. This aligns the library with Tiptap's recommended architecture and improves compatibility with modern bundlers.
 
 ## [2.0.1] - 2026-01-17
 
 ### Added
+
 - **Global Footer Toggle**: Added `[showFooter]` input to easily toggle the entire editor footer (counters and limits).
 
 ### Changed
+
 - **Enhanced Slash Commands**: Complete visual overhaul of the slash command menu with improved padding and consistent token-based styling.
 
 ## [2.0.0] - 2026-01-17
+
 🚀 **Major Release**
 
 > **Note:** I decided to skip v1.0.0 to align the version number with **Tiptap v2**.
 > This structure prepares the project for the upcoming migration to **Tiptap v3** (which will correspond to my v3.0.0).
 
 ### Added
+
 - **Extensible I18n**: The translation system is now open. You can add any language (e.g., `es`, `it`) via `addTranslations()`, and the `SupportedLocale` type now accepts any string with autocomplete for default languages.
 - **Per-Instance I18n Override**: Added ability to define a specific language for a given editor instance via the `[locale]` input, without affecting the global language of other editors.
 - **Global I18n Singleton**: The translation service is now a global singleton (`providedIn: 'root'`), allowing for application-wide language switching with a single call.
@@ -45,18 +72,22 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - **Precise Inline Code**: Separated "Inline Code" and "Code Block" in menus and translations for better clarity.
 
 ### Fixed
+
 - **Inline Code Toggle**: Fixed a reactivity bug where the "Code" button in the toolbar became disabled when already inside a code mark, preventing it from being toggled off.
 
 ### Changed
+
 - **Service Isolation**: `EditorCommandsService`, `LinkService`, `ColorPickerService`, and `ImageService` are no longer global (`root`). They are now provided at the component level for each editor instance, ensuring perfect isolation in multi-editor scenarios.
 - **Internal Refactoring**: Systemic use of `currentTranslations` (computed signal) across all internal components for perfect reactivity to language changes.
 
 ### Breaking Changes
+
 - **Service Injection**: If you were injecting `EditorCommandsService` (or other internal services) directly into your own global services/components, it will no longer work. You must now interact with the editor via its public API (`@ViewChild`).
 
 ## [0.6.0] - 2026-01-14
 
 ### Added
+
 - **Reactive State Management**: New "Snapshot & Signal" architecture with optimized change detection (OnPush).
 - **Custom Extension Tracking**: Automatic state tracking for custom Tiptap Marks and Nodes (zero-config).
 - **Extensible State**: New `stateCalculators` input to inject custom logic into the reactive editor state.
@@ -68,6 +99,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - **Danger Button Variant**: New `danger` variant for actions like "Reset Color" or "Remove Link", providing clear visual feedback for destructive operations.
 
 ### Fixed
+
 - **Multi-instance Support**: Full service isolation, allowing multiple editors on the same page without shared state.
 - **Bubble Menu Conflicts**: Fixed overlapping menus by implementing a strict priority system (specialized menus now hide the main text menu).
 - **Image Bubble Menu Persistence**: Corrected Tippy.js behavior to prevent menus from disappearing when re-clicking an already-selected image.
@@ -76,6 +108,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - **Atomic Image Replacement**: Refactored image service to perform atomic updates, fixing the "extra space" bug and preventing layout shifts during asynchronous uploads.
 
 ### Changed
+
 - **Architectural Refactoring**: `EditorCommandsService` is now a clean facade/proxy for specialized services (`ImageService`, `ColorPickerService`, `LinkService`).
 - **Optimized State Performance**: Refactored state calculators (notably `MarksCalculator`) to minimize DOM access and avoid unnecessary layout recalculations (reflow).
 - **Centralized Color Utilities**: Consolidated color normalization, luminance, and contrast calculations into a shared utility for perfect consistency.
@@ -85,10 +118,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [0.5.5] - 2026-01-09
 
 ### Added
+
 - **Bubble Menus Confinement**: Menus now properly respect the editor's boundaries and are clipped by the container when scrolling, specifically optimized for `fillContainer` mode.
 - **Unified Command Execution**: Centralized all editor operations within `EditorCommandsService`, ensuring consistent behavior between the toolbar and bubble menus.
 
 ### Fixed
+
 - **Bubble Menus Positionning**: Refactored positioning logic for all bubble menus (Text, Image, Table, Cell, Slash) using Tippy's `sticky` plugin for real-time tracking during resizing and scrolling.
 - **Bubble Menus Performances**: Significant performance boost in `getImageRect` and `getTableRect` using direct ProseMirror DOM lookups.
 - **Performance Optimization**: Implemented `ChangeDetectionStrategy.OnPush` across all library components to minimize change detection cycles. Improved resource management by enabling Tippy's sticky polling only while menus are visible.
@@ -96,12 +131,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [0.5.4] - 2026-01-08
 
 ### Added
+
 - **Enhanced Color Pickers**: Refactored text and highlight pickers with a curated palette of predefined colors for faster styling.
 - **Intelligent Bubble Menus**: Automatic hiding when approaching the toolbar and smart restoration when leaving, ensuring a non-obstructive editing experience.
 
 ## [0.5.3] - 2026-01-08
 
 ### Added
+
 - **Unified Color Picker**: Refactored text and highlight color pickers into a single, generic `TiptapColorPickerComponent` for better maintainability (DRY).
 - **Advanced Highlight Picker**: The highlight button now displays the selected color as its background, with automatic icon contrast (black/white) for perfect visibility.
 - **Improved Text Color Picker**: Added an adaptive contrast background to the text color button when a very light color is selected, ensuring the icon remains visible.
@@ -111,6 +148,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [0.5.2] - 2026-01-07
 
 ### Added
+
 - **Word Count Toggle**: Added `showWordCount` input to independently control the visibility of the word counter.
 - **Character Limit**: Added `maxCharacters` support with visual feedback and dynamic blocking.
 - **Footer Configuration Section**: New section in the demo to manage counters and limits with a design consistent with other panels.
@@ -118,101 +156,119 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [0.5.1] - 2026-01-07
 
 ### Fixed
+
 - **Library Dependencies**: Added missing `@tiptap/extension-color` and `@tiptap/extension-text-style` to peerDependencies.
 
 ## [0.5.0] - 2026-01-07
 
 ### Added
+
 - **Full Theming System**: Introduced a complete set of CSS variables (`--ate-*`) for deep editor customization.
 - **Dark Mode Support**: Native support for dark mode via `.dark` class or `[data-theme="dark"]` attribute on the editor component.
 - **Theme Customizer**: New interactive panel in the demo application to customize and export CSS themes in real-time.
 - **Improved Slash Menu**: Refactored slash menu with better UI, keyboard navigation, and easier command filtering.
 
 ### Breaking Changes
+
 - **Slash Commands API**: The `slashCommands` input now takes a `SlashCommandsConfig` object (a set of boolean flags) to toggle default commands, instead of a list of command items.
 - **Custom Slash Commands**: To provide your own commands, you must now use the new `customSlashCommands` input.
 - **CSS Variables**: The editor now relies heavily on CSS variables. If you had deep CSS overrides, you might need to update them to use the new `--ate-*` tokens.
 
 ### Fixed
+
 - **Text Color Picker**: Improved initial color detection using computed styles and refined UI behavior to accurately reflect text color even when using theme defaults.
 
 ### Changed
+
 - Renamed several internal components and services for better consistency.
 
 ## [0.4.0] - 2026-01-07
 
 ### Added
+
 - Text color picker extension (PR #6 by @nicolashimmelmann)
 - Integrated color picker into the main toolbar and bubble menu
-- New `tiptapExtensions` and `tiptapOptions` inputs for deeper editor customization  (PR #6 by @nicolashimmelmann)
-
+- New `tiptapExtensions` and `tiptapOptions` inputs for deeper editor customization (PR #6 by @nicolashimmelmann)
 
 ## [0.3.7] - 2025-12-19
 
 ### Added
+
 - `fillContainer` input to make the editor fill the full height of its parent container
 
 ## [0.3.6] - 2025-12-19
 
 ### Added
+
 - Custom image upload handler (`imageUploadHandler` input)
 - Support for both `Promise` and `Observable` return types in upload handler
 
 ## [0.3.5] - 2025-12-19
 
 ### Added
+
 - `autofocus` input with multiple options (`false`, `'start'`, `'end'`, `'all'`, or position number)
 - Autofocus property support (PR #5 by @elirov)
 
 ## [0.3.4] - 2025-12-19
 
 ### Fixed
+
 - Removed console.log statements
 
 ## [0.3.3] - 2025-09-05
 
 ### Fixed
+
 - Slash commands functionality improvements
 
 ## [0.3.2] - 2025-09-05
 
 ### Fixed
+
 - Table functionality in slash commands
 
 ## [0.3.1] - 2025-09-03
 
 ### Added
+
 - Table extension with bubble menu for cell editing
 
 ## [0.3.0] - 2025-09-01
 
 ### Added
+
 - Table extension (insert, delete rows/columns, merge cells)
 - Cell bubble menu for table editing
 
 ## [0.2.7] - 2025-08-22
 
 ### Fixed
+
 - FormControls now fully Angular 18+ compliant
 
 ## [0.2.6] - 2025-08-21
 
 ### Fixed
+
 - FormControl update when editor is not ready yet
 
 ## [0.2.5] - 2025-08-21
 
 ### Changed
+
 - Updated README with StackBlitz demo link
 
 ## [0.2.4] - 2025-08-21
 
 ### Fixed
+
 - FormControls improvements
 
 ## [0.2.3] - 2025-08-20
 
 ### Fixed
+
 - Text alignment controls
 - Image positioning
 - Placeholder display
@@ -220,23 +276,27 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [0.2.2] - 2025-08-20
 
 ### Fixed
+
 - Material Symbols font loading
 
 ## [0.2.1] - 2025-08-20
 
 ### Fixed
+
 - Peer dependencies versions
 - Library package name
 
 ## [0.2.0] - 2025-08-20
 
 ### Fixed
+
 - Angular version compatibility
 - GitHub Pages deployment path
 
 ## [0.1.0] - 2025-08-20
 
 ### Added
+
 - Initial release
 - Rich text editing with Tiptap
 - Toolbar with formatting options (bold, italic, underline, strike, code)