# Inline Context - Complete Changelog

This file contains the complete changelog for all versions of the Inline Context plugin.
For major version highlights, see README.md and readme.txt.

## Version 2.8.1 - May 2, 2026
* FIX: Inline context popover no longer closes when inserting an image from the WordPress
  Media Library. Root cause: the Media Library frame is a body-level modal, so its clicks
  registered as "outside the popover" and triggered the close handler. The fix flips a guard
  ref while the frame is open and releases it 200ms after close, which also covers the focus-
  restore click that happens immediately after the modal tears down.

## Version 2.8.0 - May 2, 2026
* NEW: Embed images inside inline context notes via the WordPress Media Library
* NEW: Image button in the note editor toolbar (shown when image support is enabled)
* NEW: "Allow images in notes" admin setting in the General tab (default: enabled)
* NEW: Custom Quill image blot preserves alt, loading, decoding, and class attributes
  through Quill's serialization, so attributes survive editor round-trips
* NEW: `inline_context_allowed_image_protocols` filter for sites that need data URIs or
  other schemes
* NEW: Three CSS variables for theme-level image sizing customization:
  --wp--custom--inline-context--image--tooltip-max-width (default 280px)
  --wp--custom--inline-context--image--tooltip-max-height (default 200px)
  --wp--custom--inline-context--image--inline-max-height (default 400px)
* IMPROVED: Tooltip mode caps images at ~280×200 to keep tooltips compact
* IMPROVED: Inline mode caps image height at 400px while allowing full content width
* IMPROVED: Print styles handle images with page-break avoidance and sensible sizing
* IMPROVED: Confirmed WordPress 7.0 compatibility — "Tested up to" header bumped to 7.0
* IMPROVED: Always sets alt="" on images missing alt text so screen readers don't fall
  back to announcing filenames
* IMPROVED: Image src restricted to http(s) and relative paths by default; data URIs and
  other protocols can be opted into via the new filter
* IMPROVED: Settings export/import now includes the image-support toggle
* DEV: Added project-wide babel.config.json so ESLint's parser stops warning when
  walking @wordpress/* dependencies
* DEV: Declared react-dom as an explicit dependency (was pulled in transitively, used
  via WordPress's wp-element global)
* DEV: Cleaned up pre-existing JSDoc and PHPCS suppression-comment placement issues

## Version 2.7.3 - March 21, 2026
* FIX: Category icons now align correctly with text at all icon placement settings
* FIX: Category icon double-scaling issue where font-size and width/height both used em values,
  causing icons to render at 0.49em instead of the intended 0.7em
* IMPROVED: Separated icon sizing between default chevron (width/height only) and category icons
  (font-size for glyph + 1em width/height to match), ensuring both render at the same physical size
* IMPROVED: Reverted middle placement to CSS keyword "middle" for cross-theme compatibility

## Version 2.7.2 - March 20, 2026
* FIX: Custom category icons now respond to size and placement settings
* FIX: Default chevron icon now responds to color and placement settings
* FIX: Tooltip hover mode no longer shows erratic show/hide behavior
* FIX: Admin settings JS toggles now work (screen ID mismatch prevented all JS from running)
* NEW: Icon right margin CSS variable (chevron-margin-right) for theme.json and admin settings
* IMPROVED: Refactored icon rendering from CSS ::after pseudo-element to real <span> elements
* IMPROVED: Shared base styles between default chevron and category icons for consistent positioning
* IMPROVED: Override Dashicons ::before sizing so category icon glyphs respect the Size setting
* IMPROVED: Fine-tuned icon placement: top (text-top), middle (0.05em), bottom (-0.15em)
* IMPROVED: Pill style always centers icons regardless of icon placement setting
* IMPROVED: Icon Placement option hidden in admin when Pill style is selected
* IMPROVED: Tooltip hover uses direct per-trigger event listeners instead of delegated capture events

## Version 2.6.0 - December 27, 2025
* NEW: Color preset system with five pre-configured professional color schemes
* NEW: Modern Blue (Default) preset - clean, professional look with blue accents
* NEW: Minimalist Gray preset - subtle, understated design in grayscale
* NEW: High Contrast preset - bold colors for maximum visibility and accessibility
* NEW: Warm Earth Tones preset - cozy, natural palette with browns and oranges
* NEW: Dark Mode preset - dark theme with light text for reduced eye strain
* NEW: Automatic preset detection and persistence across page reloads
* NEW: "Custom" indicator when user modifies preset values
* NEW: Warning dialog before applying preset over custom settings
* NEW: note-text-color CSS variable for better typography control (37 total variables)
* IMPROVED: All presets meet WCAG 2.1 AA accessibility standards (minimum 4.5:1 contrast)
* IMPROVED: Dark Mode text color with proper inheritance for WordPress block elements
* IMPROVED: One-click preset application with instant visual feedback
* IMPROVED: Seamless integration with existing WordPress Settings API

## Version 2.4.1 - December 19, 2025
* IMPROVED: documentation

## Version 2.4.0 - December 19, 2025
* NEW: Add new pill style
* NEW: WordPress 6.9+ Abilities API integration for AI assistant discovery
* NEW: Five REST API abilities for AI-powered content enhancement
* NEW: `create-note` ability - Create new inline context notes via API
* NEW: `search-notes` ability - Search existing notes by title/content
* NEW: `get-categories` ability - Retrieve all available categories
* NEW: `get-note` ability - Fetch specific note by ID
* NEW: `create-inline-note` ability - Create note and get ready-to-embed HTML markup (AI helper)
* NEW: Browser-based AI integration (Claude, ChatGPT) with automatic capability discovery
* NEW: Comprehensive ABILITIES-API.md documentation with workflows and examples
* NEW: Test infrastructure for Abilities API (test-abilities.sh, tests/test-abilities.php)
* NEW: AIFeatures component for future in-editor AI UI (currently disabled by default)
* IMPROVED: Authentication support via cookie auth (browser) or Application Passwords
* IMPROVED: Complete JSON Schema validation for all ability inputs
* IMPROVED: Permission callbacks ensure proper WordPress capability checks
* IMPROVED: Backward compatible - works on WordPress 6.0+ (Abilities API optional on 6.9+)
* IMPROVED: Updated "Tested up to" WordPress 6.9

## Version 2.3.5 - 2.3.9 - November 29, 2025
* Minor fixes, updated documentation and readme.txt, added Dutch translations

## Version 2.3.4 - November 28, 2025
* FIX: WordPress.org compliance - replaced all inline <script> tags with wp_add_inline_script()
* FIX: WordPress.org compliance - added source code documentation section to readme.txt
* NEW: Created .distignore file to exclude screenshots from plugin zip (belong in SVN assets only)
* IMPROVED: Script enqueueing follows WordPress best practices and plugin guidelines
* IMPROVED: Better separation of concerns - scripts properly enqueued via admin hooks

## Version 2.3.3 - November 21, 2025
* FIX: Tooltip hover event handling refactored for multi-link reliability
* FIX: Direct event listeners on triggers eliminate race conditions
* FIX: Tooltip DOM association with data-anchor-id attribute
* IMPROVED: Independent timeout management per trigger
* IMPROVED: Robust hover/click interaction without interference

## Version 2.3.2 - November 16, 2025
* FIX: Tooltip hover logic uses WeakMap for per-trigger state
* FIX: Event delegation improved for tooltip association
* IMPROVED: Timeout management isolated per trigger

## Version 2.3.1 - November 16, 2025
* FIX: Tooltip hover logic refactored for reliability with multiple links
* FIX: Each tooltip now manages its own open/close state and timeouts
* FIX: Rapid mouse movement between links no longer causes tooltips to fail
* FIX: Tooltip DOM association improved for robust event handling
* IMPROVED: Release process and documentation for bugfix branch

## Version 2.3.0 - November 16, 2025
* NEW: Hover activation option for tooltips with configurable 300ms delay
* NEW: Admin setting to enable tooltip display on mouse hover
* NEW: Smart hover behavior - keep tooltip open when moving mouse to tooltip content
* NEW: Conditional admin UI - hover option only visible when tooltip mode is selected
* NEW: 100ms grace period for smooth mouse transition between trigger and tooltip
* NEW: Separate show/hide timeout management for robust interaction
* IMPROVED: Enhanced user experience for interacting with tooltip content and links
* IMPROVED: Smooth transition between trigger and tooltip without closing
* IMPROVED: Demo.html page now includes hover functionality demonstration
* FIX: Settings persistence in demo.html using localStorage
* FIX: Direct link anchor reference corrected in demo.html

## Version 2.2.0 - November 15, 2025
* NEW: Convert reusable notes to non-reusable with automatic synchronization
* NEW: Modal confirmation dialog prevents accidental conversions
* NEW: PopoverActions component with reusable checkbox control
* NEW: PHPUnit testing infrastructure with WordPress Test Suite integration
* NEW: 18 comprehensive test methods covering CPT, REST API, and sync functionality
* NEW: .env configuration support for secure database credentials
* NEW: Testing documentation (TESTING.md, tests/README.md, TESTING-SETUP.md)
* NEW: Interactive test setup wizard (bin/setup-tests.sh)
* NEW: Display mode switcher in demo.html for testing inline/tooltip modes
* NEW: Dynamic display mode detection instead of static configuration
* NEW: Consolidated bin/ directory for all scripts
* NEW: Markdown linting for documentation consistency
* NEW: RELEASE.md documentation with complete release process
* IMPROVED: Enhanced PopoverActions component for better reusability control
* IMPROVED: Documentation structure and testing guides

## Version 2.1.0 - November 14, 2025
* NEW: Tooltip display mode as alternative to inline expansion
* NEW: General settings tab with display mode selection (inline/tooltip)
* NEW: Smart tooltip positioning with viewport boundary detection
* NEW: Automatic position flipping to prevent off-screen tooltips
* NEW: Close button on tooltips with proper event cleanup
* NEW: Full keyboard support (Space/Enter to activate, Escape to close)
* NEW: Automatic focus management for keyboard users
* NEW: DOMPurify integration for secure HTML rendering
* NEW: CSS animations for smooth tooltip reveal
* NEW: Click toggle behavior (click again to close)
* IMPROVED: Organized styling sections (shared settings first, mode-specific after)
* IMPROVED: Admin settings reorganized into 4 tabs (General, Categories, Styling, Uninstall)
* IMPROVED: Click/keyboard-only activation for tooltips (no hover by default)
* IMPROVED: Comprehensive tooltip accessibility with ARIA attributes
* REMOVED: Non-functional live preview from Styling tab (will be reimplemented properly later)

## Version 2.0.1 - November 12, 2025
* NEW: Taxonomy meta fields UI for managing category icons and colors
* NEW: Live icon preview in category add/edit forms
* NEW: WordPress color picker integration for category colors
* NEW: Custom columns in category list showing icon previews and colors
* IMPROVED: Frontend category icon rendering now works correctly
* IMPROVED: Post list display in Uninstall tab shows which posts contain inline context links
* IMPROVED: Uninstall cleanup query accuracy (excludes revisions, more specific matching)
* IMPROVED: Added backup warning for content cleanup option in Uninstall settings
* FIX: Category icons now display properly on frontend with correct colors
* FIX: Default chevron appears when no category is selected (proper CSS selector)

## Version 2.0.0 - November 12, 2025
* NEW: Complete modular class-based architecture (83% main file reduction from 2,291 to 395 lines)
* NEW: Six dedicated class-based modules for optimal separation of concerns
* NEW: Inline_Context_CPT class (855 lines) for Custom Post Type management
* NEW: Inline_Context_Taxonomy_Meta class (372 lines) for taxonomy meta fields
* NEW: Inline_Context_Sync class (496 lines) for synchronization and usage tracking
* NEW: Inline_Context_Deletion class (198 lines) for bulk deletion with cleanup
* NEW: Inline_Context_REST_API class (340 lines) for REST API endpoints
* NEW: Inline_Context_Frontend class (276 lines) for frontend rendering
* NEW: Inline_Context_Utils class (182 lines) for utility functions
* IMPROVED: Full WordPress coding standards compliance (JavaScript and PHP)
* IMPROVED: ESLint and PHPCS compliance with pre-release gates
* IMPROVED: Clean bootstrap pattern with class initialization
* IMPROVED: Enhanced maintainability and testability
* IMPROVED: Backward compatibility preserved (zero breaking changes)

## Version 1.5.0 - 2025
* NEW: Custom Post Type (inline_context_note) for reusable notes
* NEW: Category Taxonomy (inline_context_category)
* NEW: Editor popup with live search (AJAX query CPT by title)
* NEW: Two modes: Create new note / Select existing note
* NEW: Dual data storage: data-note-id + cached data-inline-context
* NEW: Frontend uses cached content (zero performance penalty)
* NEW: Usage tracking via REST API (non-blocking)
* NEW: Auto-sync for reusable notes - content automatically syncs to all posts using it
* NEW: Automatic data-inline-context attribute updates across all using posts
* NEW: Enhanced CPT list view with custom columns (Reusable, Usage Count, Used In)
* NEW: Filter dropdown for reusable notes
* NEW: Delete warnings in 3 locations (post list, quick edit, single post delete)
* NEW: QuillEditor component for rich text editing
* NEW: Comprehensive uninstall system with content cleanup options

## Version 1.4.1 - 2025
* NEW: Server-side rendering with endnotes for no-JS environments
* NEW: Full support for text-based browsers (Lynx, w3m, links)
* NEW: NoScript fallback with endnotes at bottom
* NEW: Print-friendly auto-expand all notes
* NEW: RSS feed content inclusion
* IMPROVED: Graceful degradation across all user agents

## Version 1.4.0 - 2025
* NEW: Progressive enhancement with server-side rendering
* NEW: NoScript fallback support
* IMPROVED: Text-based browser compatibility

## Version 1.3.0 - 2025
* NEW: Category management system with custom icons and colors
* NEW: Visual icon picker with 30 curated Dashicons
* NEW: Support for all 300+ Dashicons via manual entry
* NEW: Dual icon states (closed/open) with automatic toggling
* NEW: Keyboard-accessible icon picker (Esc, Tab navigation)
* NEW: Tabbed admin interface (Categories and Styling)
* NEW: Comprehensive styling controls
* NEW: Live preview with interactive note reveal
* NEW: CSS variable integration

## Version 1.2.1 - 2025
* FIX: Updated composer.json version number to match plugin version

## Version 1.2.0 - 2025
* NEW: HTML source editor toggle in ReactQuill toolbar
* NEW: Visual toggle between WYSIWYG and HTML source modes
* IMPROVED: Better icon sizing and styling for toolbar buttons
* IMPROVED: Smooth switching between visual and source editing
* IMPROVED: Automated linting and fixing before releases
* FIX: Toggle button functionality after multiple switches

## Version 1.1.5 - 2025
* NEW: HTML source editor toggle in ReactQuill toolbar for direct HTML editing
* NEW: Visual toggle between WYSIWYG and HTML source modes with dedicated icon
* IMPROVED: Better icon sizing and styling for toolbar buttons
* IMPROVED: Smooth switching between visual and source editing modes
* FIX: Toggle button functionality working correctly after multiple switches

## Version 1.1.4 - 2025
* NEW: Theme.json integration for WordPress Site Editor customization
* NEW: STYLING.md documentation with comprehensive theming examples
* IMPROVED: Conditional asset versioning (filemtime for dev, constant for production)
* IMPROVED: CSS custom properties now use --wp--custom--inline-context--* namespace
* REMOVED: Legacy --jooplaan-* CSS properties (breaking change)

## Version 1.1.3 - 2025
* IMPROVED: Minor updates and refinements
* FIX: Bug fixes and stability improvements

## Version 1.1.2 - 2025
* NEW: Copy link functionality - users can copy direct anchor links to any context note
* NEW: Developer filters for extensive plugin customization (11 filters available)
* IMPROVED: Complete namespace refactoring from trybes to jooplaan
* IMPROVED: Duplicate ID prevention system for copy/paste scenarios
* IMPROVED: HTML validity with semantic button elements instead of anchor tags
* IMPROVED: Automatic unique ID generation when duplicates are detected
* FIX: Frontend display issue - added wp-hooks dependency
* FIX: Demo.html compatibility with standalone usage
* FIX: ESLint compatibility issues with Node.js v24

## Version 1.1.1 - 2025
* FIX: Added wp-hooks dependency for frontend filters support
* FIX: Resolved console error preventing notes from displaying on frontend

## Version 1.1.0 - 2025
* NEW: WordPress LinkControl integration for easy internal page/post linking
* NEW: Familiar WordPress interface for selecting content and adding external URLs
* NEW: Developer filters for customizing plugin behavior (see FILTERS.md)
* IMPROVED: Enhanced rich text editor with better link management capabilities

## Version 1.0.1 - 2025
* IMPROVED: Enhanced VS Code development setup with WordPress coding standards
* IMPROVED: Build process optimization and error fixes
* IMPROVED: Better development workflow with automated formatting configuration
* FIX: Resolved SCSS compilation errors in build process
* FIX: PHP coding standards compliance issues resolved

## Version 1.0.0 - 2025
* NEW: Initial public release with anchor-first architecture
* NEW: Unique anchor IDs for every context note with direct URL linking
* NEW: Auto-opening notes when accessed via URL hash (#context-note-xxx)
* NEW: Subtle design - context links appear as regular text with icon indicator only
* NEW: Hover/focus states change text color to primary for clear interaction feedback
* NEW: Smart link behavior - internal links same tab, external links new tab with security
* NEW: ReactQuill rich text editor for enhanced note authoring experience
* NEW: DOMPurify integration for robust XSS protection on frontend rendering
* IMPROVED: Full WordPress coding standards compliance (PHP and JavaScript)
* IMPROVED: Comprehensive quality assurance with automated linting pipeline
* IMPROVED: Enhanced accessibility with better ARIA attributes and focus management
* REMOVED: Legacy support - v1.0 requires anchor IDs for all context notes

---

## Legend
* **NEW**: New feature or capability
* **IMPROVED**: Enhancement to existing feature
* **FIX**: Bug fix or correction
* **REMOVED**: Deprecated or removed feature