=== Cyphex Image Hunter ===
Contributors: cyphexagency, hamaza7867
Tags: ai image generator, image optimizer, webp converter, stock photos, ai images
Requires at least: 5.8
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 3.1.2
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Search, generate, optimize, and insert images with Pexels, Pixabay, Openverse, Unsplash, Gemini, OpenAI, Puter, and bulk media tools.

== Short Description ==

Multi-provider AI image studio and WordPress media optimizer with stock search, WebP conversion, SEO metadata, bulk tools, and connector support.

== Description ==

Stop wasting hours hunting for the perfect stock photo, resizing it in Photoshop, and manually typing Alt text. **Cyphex Image Hunter** is the all-in-one AI image generator and WordPress media library optimizer designed to automate your entire visual workflow.

**Cyphex Image Hunter is fully free and open source.** There are no paid tiers, license keys, remote activation checks, or feature gates. Some integrations require API credentials from their respective third-party providers, and any provider usage costs are governed by that provider.

=== 🚀 The Ultimate AI Image Generator for WordPress ===
Whether you are a blogger, developer, or agency, this plugin eliminates manual media management. In one single click, you can find royalty-free stock photos, generate custom AI images, optimize file sizes for lightning-fast speed, and write perfect SEO alt text—without ever leaving your WordPress dashboard.

=== 🧠 Smart Image Sourcing & AI Sideloading ===
Don't settle for generic results. Our "Smart Search" uses Groq AI (Llama 3.3) to understand your content intent and rewrite simple prompts into highly effective search terms.
*   **Universal Stock Photos:** Search Pexels, Pixabay, Openverse, and optional Unsplash directly inside the WordPress Media Library.
*   **Multi-Provider Image Lab:** Generate visuals using free Puter models or configured Gemini and OpenAI image models.
*   **AI Image Refinement:** Need a change? Tell the AI to "make it night time" or "remove the car" to tweak your generated images on the fly.

=== ⚡ Automated WebP Converter & Image Optimizer ===
Speed matters for Google rankings. Cyphex Image Hunter ensures every image you upload is perfectly sized and formatted for peak Core Web Vitals performance.
*   **Exact Batch Resizing:** Specify your target dimensions; the plugin auto-scales and crops featured images to fit your theme perfectly.
*   **Instant WebP Converter:** Boost your site speed by automatically converting legacy JPEG and PNG uploads into ultra-fast WebP format.
*   **Smart Target KB Compression:** Set your maximum file size (e.g., "Under 100KB") and let our iterative AI image optimizer compress files without sacrificing visual clarity.

=== 🏷️ AI-Powered SEO Alt Text & Metadata ===
Search engines love well-documented media. Our AI-SEO engine reads the visual context of your image to automatically generate:
*   **Contextual Image Titles:** Descriptive, keyword-rich attachment titles.
*   **Optimized SEO Alt Text:** Perfect for accessibility compliance and dominating Google Image Search.
*   **Smart Captions & Descriptions:** Engaging captions that reduce bounce rates and keep visitors reading.
*   **Auto-Credit Attribution:** Automatically attribute photographers from Pexels and Pixabay with clean, clickable links.

== Key Features ==

=== 🌟 Smart Sourcing & AI Creation ===
*   **Universal Media Tab:** A seamless "Image Search" tab directly inside your WordPress "Add Media" modal.
*   **Groq AI Prompt Optimization:** High-speed prompt engineering for superior AI image generator results.
*   **Multi-Model AI Support:** Choose between DALL-E 3, Flux 1.1 Pro, or Stable Diffusion 3.

=== ⚙️ Professional WordPress Media Workflow ===
*   **One-Click Media Sideloading:** Automatically downloads external stock photos to your local server.
*   **Batch Image Resizing:** Ensures all your featured images match your theme's exact dimensions.
*   **Settings Link:** Quick access directly from the WordPress Plugins dashboard.

== Free and Open Source ==

Every included feature is available without a Cyphex license or subscription, including bulk library tools, Auto-Hunt, Logo Lab, model selection, API-key rotation, background removal, and monitoring. Development will continue as a fully free GPL-licensed project.


== External services ==

This plugin relies on the following third-party services to fetch images and process AI metadata. Each service provides functionality of substance that cannot be performed locally:

1. Groq AI (api.groq.com): Used to optimize search prompts and generate SEO metadata. 
   - Data sent: User-provided search queries and image context.
   - Privacy Policy: https://groq.com/privacy-policy/
2. Cyphex Image Search Proxy (cyphex-worker-image.zimswatchinternational.workers.dev): Securely forwards stock-image searches without exposing provider API keys.
   - Data sent: Selected provider, search keywords, page, result count, and orientation.
3. Pexels (api.pexels.com): Used by the Cyphex proxy to fetch high-quality stock images.
   - Data sent by the proxy: Search keywords and filters.
   - Privacy Policy: https://www.pexels.com/privacy-policy/
4. Pixabay (pixabay.com): Used by the Cyphex proxy to fetch royalty-free stock images.
   - Data sent by the proxy: Search keywords and filters.
   - Privacy Policy: https://pixabay.com/service/privacy/
5. Puter.js (js.puter.com): Used to generate images via models like DALL-E 3 and Flux.
   - Data sent: Image generation prompts.
   - Terms of Service: https://puter.com/terms
   - Privacy Policy: https://puter.com/privacy

== Installation ==

1. Download the **cyphex-image-hunter.zip** file.
2. Log in to your WordPress Dashboard and navigate to **Plugins > Add New**.
3. Click **Upload Plugin**, choose the zip file, and click **Install Now**.
4. **Activate** the plugin.

=== Configuration ===

1. Go to **Settings > Cyphex Image Hunter**.
2. Enter API keys only for optional AI features such as Groq and Replicate. Pexels and Pixabay work without configuration through the secure image proxy.
3. Click **Save API Keys**.

Open the built-in **User Handbook** for a searchable, text-based guide covering every tool and connector.

== Support Cyphex Agency ==

Thank you for using Cyphex Image Hunter and supporting Cyphex Agency. Need help with a custom project? We provide complete WordPress plugin development, custom theme development, full security and quality audits, bug fixing, performance optimization, API integrations, maintenance, and other tailored development services.

Visit our WordPress profile: https://profiles.wordpress.org/cyphexagency/

Project inquiries: contact@cyphex.agency
Plugin support: support@cyphex.agency

== What's New in v3.1.0 ==

* Added a consolidated, responsive Media Intelligence workspace.
* Added private Reuse Before Generate search across local titles, alt text, captions, descriptions, and filenames.
* Added resumable SEO, file-health, rights-risk, and exact-duplicate reporting.
* Added bounded broken local image URL detection across published content.
* Added preview-first, reversible Safe Rename with operation-ledger records.
* Added editable creator, source URL, and licence metadata to attachments.
* Added a live standards-based image sitemap and permissioned media REST report.
* Added a weekly local audit snapshot and `wp cyphex media-audit` command.
* Added capability-filtered WooCommerce product context without requiring WooCommerce.
* Preserved the 3.0.1 exact-resize, deterministic target-compression, and Auto-Hunt layout fixes.

== What's New in v3.0.1 ==

* Restored exact-dimension resizing when both width and height are supplied.
* Made target-size compression deterministic by testing each quality from an untouched source snapshot.
* Corrected Auto-Hunt editor-sidebar spacing, wrapping, controls, and narrow-screen alignment.

== What's New in v3.0.0 ==

Cyphex now creates non-destructive WebP and AVIF siblings for full images and registered sub-sizes, serves them through picture markup with original fallback, and adds backup-first EXIF/GPS privacy controls for new uploads and bulk processing.

The **v2.6 release series** expands Cyphex into a multi-provider creative media suite.

*   **Image Lab:** Generate with Puter, Gemini Nano Banana, and OpenAI GPT Image models from a responsive bento workspace.
*   **Connector Hub:** Configure optional providers, prefer wp-config.php constants, and test connection health and latency.
*   **Expanded Stock Search:** Use Pexels, Pixabay, Openverse, and optional Unsplash with creator and license metadata.
*   **Complete Text Handbook:** Search a designed in-plugin manual instead of loading obsolete screenshot galleries.
*   **Official Profile Navigation:** Agency links now use the Cyphex Agency WordPress.org profile for Playground compatibility.

== Frequently Asked Questions ==

= How does the Target Size Compressor work? =
Unlike standard compressors that just use a fixed quality setting, our AI engine is iterative. It analyzes the resulting file size and keeps optimizing until your exact KB target (e.g. 100kb) is met without destroying image clarity.

= Can I undo an optimization? =
Yes. The **Restoration Engine** creates a hidden `.cyphex-backup` of every image before it is compressed or resized. You can restore the original high-res file at any time from the Media Library.

= Is the Background Remover free? =
Yes. The plugin does not charge for access to background removal. You must provide any API credentials required by the selected processing provider, and that provider may apply its own usage charges.

= What models are available in the Logo Lab? =
The Logo Lab supports the latest high-fidelity models including **Flux 1.1 (Fast)**, **SDXL**, and **DALL-E 3**. You can generate a logo and instantly set it as your site's Favicon with a single click.

= Does this work on mobile? =
Absolutely. The entire Cyphex dashboard is built on a responsive mobile-first grid. You can hunt, generate, and optimize images directly from your phone or tablet.

= Error: Puter.js not loaded =
Ensure you have an active internet connection. Puter.js is loaded from a CDN. Check if an ad-blocker is blocking `js.puter.com`.

= Generation Failed =
DALL-E 3 requires credits on the Puter platform. If you run out, switch the Source to **Flux 1.1** or **Stable Diffusion 3**, which are often free or use fewer credits.

= Images look like cartoons =
Ensure **AI Optimize** is CHECKED. This appends keywords like "photorealistic, 8k, raw photo" to force the AI to generate realistic images.

= Upload failed =
Check your server's `upload_max_filesize` in php.ini or ensure your WordPress user has permission to upload files.

== Screenshots ==

1. **Command Dashboard** — Responsive bento cards for every Cyphex workspace.
2. **Image Lab** — Multi-provider generation, presets, canvas controls, and Media Library saving.
3. **Connector Hub** — Optional provider configuration and connection testing.
4. **Bulk Toolkit** — Categorized optimization, AI enhancement, publishing, and recovery tools.
5. **User Handbook** — Searchable text documentation for every workflow.

== Changelog ==

= 3.1.2 =
* Compatibility: Removed deprecated utf8_decode() call and implemented robust UTF-8 meta-tag prefix fallback to support WordPress 5.8.0+ and PHP 8.2+ compatibility.

= 3.1.1 =
* Reliability: Added mbstring PHP extension fallback and empty content check for Auto-Hunt DOM parser.
* Performance: Optimized iterative compression loop with execution time limit checks to prevent script timeouts.
* Optimization: Implemented transient caching for system capabilities test, invalidating on setting and plugin status changes.
* Compatibility: Added developer filter `cyphex_should_wrap_attachment_picture` and class `cyphex-no-wrap` bypass support to prevent styling conflicts on `<picture>` wrappers.

= 3.1.0 =
* Intelligence: Added local reuse search, media SEO scoring, rights risk, exact duplicates, and broken URL inspection.
* Recovery: Added preview-first Safe Rename and reversible filename maps.
* Discovery: Added a live image sitemap and authenticated REST attachment assessments.
* Automation: Added weekly bounded audits and a read-only WP-CLI audit command.
* Commerce: Added optional WooCommerce product context with automatic eligibility detection.
* UI: Added a responsive, CSS-isolated bento workspace and dashboard/navigation entry points.

= 3.0.1 =
* Resize: Restored exact width-and-height output while retaining proportional one-axis resizing.
* Compression: Rebuilt target-size quality search so every attempt starts from an untouched source snapshot.
* Reliability: Added explicit editor/save error handling and honest closest-safe-result feedback.
* Auto-Hunt: Scoped and normalized the editor metabox grid for classic, block-editor, and narrow sidebars.

= 3.0.0 =
* Modern formats: Added capability-filtered WebP and AVIF sibling generation.
* URL safety: Original attachments and URLs remain unchanged while browsers receive picture-based format choices.
* Responsive delivery: Generates modern siblings for full images and registered WordPress sub-sizes.
* Fallbacks: Original img markup remains the final picture fallback.
* Privacy: Added Keep, GPS-only, and remove-all metadata modes for new uploads.
* Bulk privacy: Added EXIF/GPS Privacy to the categorized Bulk Toolkit.
* Recovery: Metadata changes use the existing original-image backup and record an operation ledger.
* Compatibility: GPS-only processing requires Imagick; unsupported sites receive a clear no-change response.

= 2.9.0 =
* Security: Validates MIME content, extension agreement, file presence, and a 50 MB safety ceiling after every sideload.
* Reliability: Added up to three safe remote-download attempts and generic user-facing failure messages.
* Attribution: Persists source, creator, creator URL, and license metadata on imported attachments.
* Cache: Added generation-based search cache invalidation when connector/search settings change.
* Cache: Added a manual Clear Search Cache control in Settings.
* Auto-Hunt: Added eligible public custom-post-type support through a filterable post-type list.
* Social tools: Made crop presets filterable and validates custom dimensions.
* Product: Confirmed all functionality remains free, open source, local-first, and without artificial quotas.

= 2.8.2 =
* Standards: Replaced the direct upload-directory writability check with WP_Filesystem.
* Security: Sanitized every bulk Accessibility Audit attachment ID immediately after unslashing.

= 2.8.1 =
* Readiness: Added centralized capability detection for uploads, WebP, stock search, browser AI, optional AI providers, and WooCommerce.
* UX: Added a responsive “What you can use right now” dashboard matrix.
* Progressive disclosure: WooCommerce workflows remain hidden when WooCommerce is inactive.
* Fallbacks: Smart Fix preserves original formats when WebP is unavailable.
* Controls: WebP and AI-only options are disabled when their requirements are unavailable.
* Simplicity: Removed planned R2/S3 fields from normal Settings and Connector Hub; standard WordPress storage requires no external server.
* Developer support: Exposed non-sensitive capability status to the plugin JavaScript runtime.

= 2.8.0 =
* Health Score: Added a complete local Media Library health scan with a clear score out of 100.
* Health Score: Detects oversized files, missing alt text, weak filenames, missing files, incomplete metadata, and exact binary duplicates.
* Smart Fix: Added one-click, backup-first website image optimization with batched progress.
* Smart Fix: Resizes oversized originals, compresses, converts JPEG/PNG to WebP, and fills missing local metadata without an API key.
* Reporting: Added per-image before/after size and total storage-savings results.
* Safety: Every modified image is backed up through the existing Restoration Engine before processing.
* Performance: Duplicate hashes are cached in attachment metadata and invalidated after modification.

= 2.7.0 =
* Accessibility: Added a dedicated bento-style Alt-Text and Accessibility Audit workspace.
* Accessibility: Detects empty, filename-like, very short, and incomplete image metadata.
* Accessibility: Added individual and selected-batch AI repair with capability checks and 30-minute report caching.
* Analytics: Added private, local cumulative impact statistics and rolling 30-day daily counters.
* Analytics: Dashboard now reports storage reclaimed, optimized images, WebP conversions, metadata fixes, AI generations, and estimated transfer-time savings.
* Privacy: Impact analytics remain entirely inside the WordPress database and can be reset by administrators.

= 2.6.5 =
* Media Library: Rebuilt Image Hunt as a responsive bento workspace.
* Sideload: Improved result cards, source attribution, import actions, feedback, and accessible status messaging.
* Editors: Confirmed universal integration through the standard WordPress media modal used by Gutenberg, Classic Editor, Elementor, WPBakery, and compatible builders.
* Isolation: Scoped all new media workspace styles to the media frame to prevent theme and plugin CSS collisions.

= 2.6.4 =
* ONBOARDING: Updated the setup wizard for Image Lab, Connector Hub, four stock sources, and optional Gemini, OpenAI, Unsplash, Groq, and Replicate credentials.
* NOTICES: Added a dismissible current-release banner with direct Image Lab and Connector Hub actions, and refreshed welcome and maintenance notices.
* UI: Added responsive bento feature cards and connector fields to the setup wizard.

= 2.6.3 =
* SETTINGS: Consolidated AI, workflow, Image Lab, connector, storage, and security configuration into one responsive bento settings page.
* UI: Converted the complete text handbook into a dense, gap-free responsive bento reading grid.
* CLEANUP: Removed 38 obsolete handbook screenshot assets and synchronized all release metadata and documentation.

= 2.6.2 =
* FIX: Replaced agency website navigation with the official WordPress.org profile to avoid iframe blocking in WordPress Playground.

= 2.6.1 =
* BRANDING: Added the official Cyphex Agency WordPress.org profile to the agency card and sidebar footer.

= 2.6.0 =
* NEW: Image Lab bento workspace for multi-provider image generation, presets, aspect ratios, quality controls, downloads, and direct Media Library saving.
* NEW: Free browser generation with Puter Flux Schnell, Stable Diffusion 3, and DALL-E 3 models.
* NEW: Server-side Gemini Nano Banana 2 Lite, Nano Banana 2, and Nano Banana Pro adapters.
* NEW: Server-side OpenAI GPT Image 2, GPT Image 1.5, and GPT Image 1 adapters.
* UI: Introduced responsive bento-grid layouts across Image Lab and the main tool dashboard.
* MONITORING: Added combined Connected Image AI usage and expanded stock connector counts.

= 2.5.0 =
* NEW: Connector Hub with dedicated provider cards, wp-config.php constant support, health checks, and latency reporting.
* NEW: Working Openverse licensed-image search with creator and license metadata.
* NEW: Optional Unsplash search connector with attribution metadata and download tracking.
* PREVIEW: Configuration cards for OpenAI Images, Gemini/Nano Banana, public ComfyUI, and Cloudflare R2 ahead of generation and offload adapters.
* SECURITY: Expanded direct-image compatibility while retaining HTTPS-only, public-IP, redirect-safe SSRF validation.

= 2.4.4 =
* FIX: Agency website links now always launch as external tabs instead of loading inside the WordPress Playground frame.
* UX: Added clear feedback when the browser blocks the external tab as a pop-up.

= 2.4.3 =
* UI: Introduced a shared 4/8-pixel geometry system across every screen, card, field group, action row, and responsive breakpoint.
* FIX: Corrected the legacy direct-child margin rule that removed intended vertical spacing between page sections.
* UI: Equalized Handbook card internals and tips, balanced the Dashboard into a complete tool grid, and aligned action buttons to consistent baselines.

= 2.4.2 =
* UI: Added unified tool cards across the dashboard and workspaces, plus an official Cyphex Agency profile and service links.
* DOCS: Replaced the screenshot gallery with a complete searchable, text-based field manual covering every workflow and common error.
* COMPATIBILITY: Hardened CSS isolation and responsive boundaries for WordPress admin, Media Library modals, tablets, phones, and third-party plugin coexistence.

= 2.4.1 =
* UI: Restored the categorized Bulk Toolkit with separate cards for optimization, AI enhancement, publishing, and recovery tools.
* UX: Each tool now has its own description and selection state while retaining the secure paginated scan and cancellable processing engine.

= 2.4.0 =
* UI: Restored a premium Cyphex visual identity with a dark studio sidebar, amber-gold navigation, layered surfaces, polished cards, richer controls, and responsive mobile treatment.
* UX: Added clearer visual hierarchy, stronger focus states, reduced-motion support, and consistent interaction feedback without changing the repaired workflows.

= 2.3.9 =
* FIX: Completed the v2.3.7 UX audit repair pass, including accessible feedback dialogs, cached stock-service fallback, accurate monitoring, and Handbook search/lightbox support.
* FIX: Removed native alert/confirm dialogs, fragile style-attribute selectors, false quota estimates, and the blocking rate-limit wait loop.
* UX: Added Auto-Hunt slot bulk selection, linked support navigation, stock-proxy onboarding copy, and clearer degraded-service messages.
* SECURITY: Preserved strict provider URL validation, per-attachment permissions, and proxy-held stock API credentials.

= 2.2.8 =
* NEW: Zero-Friction Auto-Discovery Licensing — The plugin automatically registers itself to your central licensing dashboard upon installation.
* NEW: Remote 1-Click Activation — Instantly activate the Pro or Agency tier remotely from your licensing dashboard.
* NEW: Auto-Sync check — Client sites automatically fetch remote license tokens on settings load or via the "Check Status" sync action.

= 2.2.7 =
* FIX: Resolved TypeError: Cannot read properties of undefined (reading 'poll_url') in administrative JavaScript when AJAX action response is empty.
* FIX: Safeguarded asynchronous background processing against unexpected undefined responses.

= 2.2.6 =
* COMPATIBILITY: Added full support for WordPress 7.0 including Connectors API integration.
* COMPATIBILITY: Registered Groq, Replicate, Pexels, and Pixabay services natively within the WordPress Connectors Registry.
* FALLBACK: Implemented WordPress 7.0 native AI Client fallback for prompt optimization and Alt/Description metadata generation when API keys are missing.
* FIX: Routed Google Nano image generation requests directly to the native AI Client on WordPress 7.0+.

= 2.2.5 =
* NEW: Agency Enterprise Tier — Exclusive new license plan for high-volume agencies.
* NEW: Multi-Key Rotation — Plug in multiple Groq API keys to effectively multiply your daily token and request quotas.
* NEW: Live Quota Dashboard — Real-time site-wide capacity monitoring for Agency users.
* NEW: Smart Cooldown Timer — The plugin now parses 429 rate limit errors and displays a countdown before automatically retrying.
* FIX: Resolved Auto-Hunt bug where WebP and AI Metadata settings were not being transmitted to the background sideload processor.
* FIX: Stabilized dashboard layout and sidebar button alignment across all administrative pages.

= 2.2.3 =
* Fix: Prevented Media Library white screen crash on mobile/small screens.
* UI: Optimized search toolbar layout for responsive wrapping.

= 2.2.2 =
* FIX: Resolved a fatal JavaScript 'set of null' error in the Media Library modal extension.
* CACHE: Forced asset refresh to ensure all users receive the latest stability fixes.

= 2.2.1 =
* CRITICAL: Resolved a fatal PHP syntax error that caused a White Screen of Death (WSoD) upon activation.
* SECURITY: Implemented a secure server-side proxy for Replicate API polling, preventing the exposure of API keys in the browser.
* SECURITY: Hardened the secure proxy with strict URL sanitization and unslashing for all remote endpoint requests.
* FIX: Corrected the wp.ajax.post signature mismatch to resolve "400 Bad Request" errors in background processing loops.
* FIX: Hardened the AI Inpainting modal with namespaced event destructors to eliminate browser-wide memory leaks.
* FIX: Implemented idempotent sidebar rendering to prevent duplicate controls during rapid Media Library navigation.
* UI: Appended A-tier responsive CSS overrides for perfect mobile and admin-theme synchronization.
* STABILITY: Unified project versioning across all headers and assets to ensure 100% reliable cache-busting.

= 2.1.0 =
* NEW: Universal Licensing Engine — The plugin now intelligently recognizes any valid CYPHEX key, regardless of date format or hyphenation.
* SECURITY: Hardened Production Build — Permanently removed all development bypass keys and master access logic.
* SECURITY: Input Sanitization — Implemented strict WPCS-compliant sanitization for all domain detection superglobals.
* IMPROVEMENT: Switched to home_url() for domain validation to ensure perfect parity with the plugin dashboard.
* UI: Enhanced license activation feedback with specific server-side error reporting.

= 2.0.3 =
* FIX: Asset versioning now tied to plugin version — browser cache auto-busts on every update. Users on stale cache now automatically receive fresh JS/CSS.
* FIX: Bumped from 2.0.2 to force cache refresh for users who installed 2.0.2 with stale 1.8.0 assets.

= 2.0.2 =
* FIX: Auto-Hunt image duplication eliminated — images now sideloaded once and reused by Insert button (no double upload).
* FIX: Auto-Hunt exact resize now working — images cropped to user-specified dimensions (e.g., 1024×557) during initial upload.
* FIX: Photographer credit now correctly saved to image caption in Auto-Hunt flow.
* FIX: AI Alt Text and Description no longer blocked by Pro license check — these features use the user's own Groq API key.
* FIX: Removed `response_format: json_object` from all Groq API calls — was causing API rejections on some Groq model versions.
* FIX: JSON parsing hardened — markdown code fences stripped before parsing, regex fallback added for all Groq responses.
* FIX: AI caption no longer overwrites photographer credit — now prepended: "AI Caption | Credit: Photographer".
* IMPROVEMENT: Groq now receives full post content (300 words) for Auto-Hunt instead of 50 words.
* IMPROVEMENT: Auto-Hunt images placed at semantically correct positions (featured, after intro, mid-content, conclusion) based on Groq analysis.
* IMPROVEMENT: 5-breakpoint responsive CSS system (mobile → ultra-wide).
* IMPROVEMENT: All CSS strictly scoped to plugin wrapper — zero conflict with themes or other plugins.

= 2.0.0 =
* NEW: Target Size Compressor: Set a specific KB limit (e.g., "Under 100kb") and let the AI iteratively optimize your images to meet it.
* NEW: Pro Restoration Engine: Gated behind the Pro license, this tool allows you to restore any optimized image to its original state from an encrypted backup.
* NEW: AI Background Remover: Instantly remove backgrounds from any image directly within the Media Library (Pro).
* NEW: AI Logo Lab 2.0: Completely overhauled logo generation suite with multi-model support (Flux/SDXL) and "Set as Favicon" automation.
* NEW: Single-Image Quick-Fix: A dedicated optimization wizard for individual media items.
* UI/UX: Media Library Overhaul: Redesigned the "Cyphex Image Hunt" tab with a 1:1 square aspect ratio grid and amber-branded action overlays.
* RESPONSIVE: Mobile-First Design: Fully responsive dashboard that stacks perfectly on phones and tablets.
* STABILITY: WPCS Compliance: Resolved multiple parse_url and unlink violations to ensure 100% WordPress Coding Standards compliance.
* SECURITY: Nonce Verification: Added extra layers of security to all sideloading and compression endpoints.

= 1.9.0 =
* BRANDING: Migrated to a premium "Amber & Obsidian" cinematic brand identity.
* UI/UX: Completely overhauled the administrative dashboard with a modern Sidebar-based navigation system.
* AI MODELS: Integrated support for Google Nano and Banana.dev advanced AI models.
* AI GENERATION: Unified AI generation flow via Puter.js (Flux 1.1, SD3, DALL-E 3).
* ARCHITECTURE: Transitioned to an enterprise-grade Singleton architectural pattern for safer initialization.
* LICENSING: Implemented robust Domain Normalization (stripping protocols/www) for consistent hash-based validation.
* SECURITY: 100% Nonce-protected administrative navigation and verified audit compliance.
* SECURITY: Implemented strict capability checks (manage_options, upload_files) for all AJAX and entry points.
* SIDELOAD: Launched the Direct URL Downloader with automatic WebP conversion and AI metadata.
* BULK TOOLKIT: Redesigned the Bulk AI Toolkit with branded Obsidian cards and Amber gold accents.
* OPTIMIZATION: Integrated Groq (Llama-3.3-70b) for high-speed prompt engineering and automated SEO metadata.
* BUG FIX: Resolved activation fatal errors caused by pathing mismatches and rogue tag compiler crashes.
* STABILITY: Synchronized SVN trunk and local development environments for deployment parity.

= 1.8.9 =
* Fix: Minor CSS tweak for the WebP progress bar shadow depth.

= 1.8.8 =
* Tweak: Updated translator comments for better localized "Optimizing" strings.

= 1.8.7 =
* Optimization: Reduced background process memory overhead for large image scans.

= 1.8.6 =
* Fix: Resolved a race condition during bulk WebP metadata writing.

= 1.8.5 =
* UI: Improved accessibility labels for the dashboard sidebar.

= 1.8.4 =
* Tweak: Enhanced error messaging for missing GD or Imagick extensions.

= 1.8.3 =
* Optimization: Sped up the initial library scan by 15% using optimized SQL queries.

= 1.8.2 =
* Fix: Corrected a display bug in the Bulk Progress modal for RTL languages.


= 1.8.1 =
* UI: Added a subtle hover state to the dashboard action buttons.

= 1.8.0 =
* NEW: Dedicated Bulk AI Toolkit dashboard for server-safe library optimization.
* NEW: Auto-WebP conversion on upload for JPG and PNG files.
* IMPROVED: Fully refactored library scanner to use get_posts() and caching.
* FIXED: Resolved multiple WPCS warnings and errors for better stability.
* IMPROVED: Enhanced input sanitization and unslashing for all AJAX handlers.

= 1.7.9 =
* Tweak: Updated compatibility checks for WordPress 6.4 branch.

= 1.7.8 =
* Fix: Resolved a conflict with certain object cache plugins.

= 1.7.7 =
* Optimization: Minified the internal admin CSS for a smaller footprint.

= 1.7.6 =
* UI: Refined the appearance of the "Save API Keys" success notification.

= 1.7.5 =
* Tweak: Added a fallback image for when the Pexels API returns an empty result set.

= 1.7.4 =
* Fix: Corrected a potential undefined index error in the license status check.

= 1.7.3 =
* UI: Standardized all modal close icons for visual consistency.

= 1.7.2 =
* Optimization: Improved the speed of the AJAX sideloading process.

= 1.7.1 =
* Fix: Resolved a CSS overlap issue in the Media Library "Grid" view.

= 1.7.0 =
* NEW: Integrated a "Live Preview" for AI-refined images before importing.

= 1.6.9 =
* Tweak: Updated the internal documentation for the Banana.dev integration.

= 1.6.8 =
* Fix: Resolved a minor UI bug in the Handbook navigation arrows.

= 1.6.7 =
* Optimization: Pre-compressed the local documentation assets.

= 1.6.6 =
* Fix: Restored settings visibility by fixing broken tab logic and layout container.
* Optimization: Added lazy loading to all handbook images.

= 1.6.5 =
* Documentation: Launched the Official Visual Handbook (38 High-Def Slides).
* Documentation: Replaced all text-based guides with a comprehensive visual-first setup experience.
* UI: Improved documentation navigation with section-based jumping for the Visual Handbook.

= 1.6.4 =
* Fix: Resolved a pathing issue for local image assets in the Handbook.

= 1.6.3 =
* Documentation: Added a detailed Step-by-Step guide for acquiring Pexels API keys.
* Documentation: Added a detailed Step-by-Step guide for acquiring Pixabay API keys.
* Documentation: Unified visual styling for all setup guides (Groq, Pexels, Pixabay).

= 1.6.2 =
* UI: Refined the padding and margins for the pricing cards.

= 1.6.1 =
* Roadmap: Expanded the feature matrix to include the AI Video Picker for Pexels and Pixabay.
* Roadmap: Refined Nano Banana and Sora AI descriptions to better align with production goals.
* UI: Improved the visual hierarchy of the pricing tables for better readability.

= 1.6.0 =
* Production: Finalized the Cyphex Image Hunter v1.6.0 production build.
* Branding: Integrated the official high-resolution logo and unified brand identity.
* Roadmap: Expanded the Pro/Ultra roadmap with Sora AI, BYOK (OpenAI/Gemini), and Tiered SEO Descriptions.
* Documentation: Completed the official 5-step visual guide with production screenshots.

= 1.5.9 =
* Tweak: Updated the "Pro License" tab description for better clarity.

= 1.5.8 =
* Documentation: Replaced all placeholder guide images with final production-ready assets provided by the user.
* UI: Cleaned up documentation layout for a more streamlined setup experience.

= 1.5.7 =
* Documentation: Updated the Groq API setup guide with precise, user-provided instructions for clarity.
* UI: Synchronized step-by-step text with the official visual guide screenshots.

= 1.5.6 =
* Branding: Replaced Dashicon placeholders with the official high-resolution plugin logo (logo.jpeg) in the header and Pro dashboard.
* UI: Improved logo presentation with professional rounded corners and subtle shadows.

= 1.5.5 =
* Feature: Added BYOK (Bring Your Own Key) roadmap for OpenAI and Gemini integrations.
* Feature: Introduced Sora AI Video waitlist specifically for the Ultra Pro tier.
* UX: Clarified feature feasibility and plan requirements in the Pro matrix.

= 1.5.4 =
* Feature: Added Basic AI Auto-Alt & Description to the Free plan.
* Feature: Introduced Advanced SEO-Optimized Descriptions as a Pro roadmap item.
* UI: Updated the feature matrix to clearly show tier differences.

= 1.5.3 =
* Feature: Refined Batch Generation limits in the Pro (5x) and Ultra Pro (Unlimited) tiers.
* UX: Improved feature descriptions for better tier differentiation.

= 1.5.2 =
* Feature: Expanded Pro roadmap with Sora AI Video generation and Nano Banana AI.
* Feature: Added Pexels & Pixabay Video Picker to the Pro feature list.
* Branding: Unified original icon usage across all dashboards.

= 1.5.1 =
* Branding: Replaced placeholder emojis with the official plugin icon in the Pro dashboard for a unified look.
* UI: Refined hero sections to better match the core brand identity.

= 1.5.0 =
* Feature: Overhauled the "Pro" tab with a comprehensive feature matrix and roadmap.
* UI: Implemented high-end pricing cards for Free, Pro, and Ultra Pro tiers.
* Documentation: Detailed the upcoming integrations for Flux 1.1, DALL-E 3, and Brand Watermarking.

= 1.4.9 =
* Tweak: Corrected minor typos in the handbook description.

= 1.4.8 =
* Fix: Resolved a CSS alignment issue for the "AI Refine" button.

= 1.4.7 =
* Optimization: Improved the responsiveness of the settings sidebar.

= 1.4.6 =
* Tweak: Added a link to the official support channel in the Dashboard.

= 1.4.5 =
* Documentation: Finalized the "Official Visual Setup Guide" with 5 high-resolution screenshots.
* Assets: Performed a major cleanup of the images directory, removing 10+ redundant mockup files to reduce plugin size.
* UX: Refined step-by-step instructions for maximum clarity during API setup.

= 1.4.4 =
* UI: Added a progress indicator for the API key validation process.

= 1.4.3 =
* Documentation: Expanded the "Ultimate Visual Guide" with new screenshots covering the Groq console home and list views.
* Security: Fine-tuned CSS blur overlays to protect sensitive usage data and keys in the new screenshots.
* UI: Improved guide typography and spacing for better readability.

= 1.4.2 =
* Documentation: Replaced mockups with authentic Groq console screenshots for better guidance.
* Security: Implemented dynamic CSS blur overlays on tutorial images to protect sensitive API details.
* UX: Improved documentation layout with a clear vertical step-by-step progression.

= 1.4.1 =
* UI: Refined the dashboard hero section for a cleaner layout.

= 1.4.0 =
* Major UI Overhaul: Completely redesigned the settings dashboard for a premium, full-width experience.
* UI: Implemented high-end card designs, refined typography, and a modern navigation system.
* UX: Unified the design language across General, Pro, and User Guide tabs.

= 1.3.9 =
* Tweak: Updated compatibility for the latest version of the WordPress Block Editor.

= 1.3.8 =
* Fix: Resolved a minor JS conflict with certain gallery plugins.

= 1.3.7 =
* Optimization: Improved the loading speed of the dashboard assets.

= 1.3.6 =
* UI: Refined the appearance of the "API Status" indicators.

= 1.3.5 =
* Tweak: Added more descriptive tooltips for the advanced AI settings.

= 1.3.4 =
* Fix: Resolved a potential issue with large image uploads on slow servers.

= 1.3.3 =
* UI: Improved the layout of the "Pixabay Setup" visual guide.

= 1.3.2 =
* Feature: Added an annotated step-by-step visual tutorial for Groq API setup with instructional arrows.
* Security: Added a dedicated "Security & Privacy" section to the dashboard to explain API key safety.
* UI: Finalized the full-width (1200px) layout for a premium experience.

= 1.3.1 =
* Feature: Added a visual infographic guide for Groq API setup in the User Guide.
* UI: Switched to a wider (1200px) full-screen layout for all settings tabs.
* UX: Added detailed explanation of Groq AI benefits (Prompt Engineering, SEO Metadata).

= 1.3.0 =
* Feature: Added a comprehensive "User Guide" tab to the settings page with detailed instructions and troubleshooting.
* UX: Improved navigation between settings and documentation.

= 1.2.9 =
* Tweak: Updated the "Credits" section in the Dashboard.

= 1.2.8 =
* Fix: Resolved a CSS issue for the "AI Inpainting" modal on small screens.

= 1.2.7 =
* UI: Standardized all alert icons across the settings page.

= 1.2.6 =
* Tweak: Updated the labels for the Bulk Toolkit features for better clarity.

= 1.2.5 =
* Fix: Resolved a minor bug in the "Auto-Optimize" toggle logic.

= 1.2.4 =
* UI: Refined the layout of the "Pro Roadmap" section.

= 1.2.3 =
* UX: Added a "Pro Tip" for users to right-click links if their browser blocks direct clicks in secure admin contexts.
* Version: Synchronized all files to 1.2.3.

= 1.2.2 =
* Fix: Implemented "Detached Navigation" via JS to bypass strict Cross-Origin isolation blocks in secure admin contexts.
* Version: Updated all asset and header versions to 1.2.2.

= 1.2.1 =
* Fix: Added direct URL display as a fallback for users whose environments block outgoing links.
* UX: Improved link reliability in secure admin contexts.

= 1.2.0 =
* Fix: Added 'rel="noopener noreferrer"' to external links to prevent browser-level blocks in the WordPress admin.
* Version: Synchronized stable tag with plugin header.

= 1.1.9 =
* Fix: Resolved fatal syntax error in settings page.
* Security: 100% Nonce verification for all admin actions including tab switching.
* Compliance: Full WordPress Coding Standards (WPCS) alignment (Tabs, Yoda conditions, Spacing).

= 1.1.8 =
* UI: Refined the dashboard footer layout.

= 1.1.7 =
* Fix: Resolved a minor CSS bug in the Pro license verification modal.

= 1.1.6 =
* Tweak: Updated the "About" section in the settings page.

= 1.1.5 =
* Feature: Introduced "Pro Roadmap" UI showcasing upcoming premium features.
* AI: Switched to context-aware prompt engineering for higher search/generation accuracy.
* Security: Hardened all AJAX handlers with mandatory sanitization and unslashing.
* Compliance: Renamed internal methods and variables to follow WPCS naming conventions.

= 1.0.33 =
* Fix: Implemented a robust PHP-side download fallback for AI images that bypasses server-side redirect and short-link restrictions.
* Stability: Escaped all localized JavaScript variables to prevent "SyntaxError: Invalid or unexpected token" in certain server environments.
* Robustness: Added explicit dependency checks to prevent "tinyMCEPreInit is not defined" errors during editor initialization.

= 1.0.32 =
* Enhancement: Implemented a two-layer "Ultra-Compatible" injection system to ensure the Cyphex tab appears in all themes, page builders, and custom editor configurations.
* Stability: Optimized the JavaScript event listeners to prevent duplicate tab creation and ensure zero-conflict operation with other plugins.
* Compatibility: Added explicit support for the "Manage" media view used in the WordPress Media Library grid.

= 1.0.31 =
* UI: Refined modal responsive breakpoints for tablet and mobile devices.

= 1.0.30 =
* Fix: Resolved minor Z-index conflict with the Gutenberg editor's top bar.

= 1.0.29 =
* Optimization: Reduced the payload size of the media modal JS by removing unused legacy event listeners.

= 1.0.28 =
* Security: Added extra layer of output escaping for the "Auto-Credit" caption field.

= 1.0.27 =
* Fix: Completely refactored the media modal extension to follow strict WordPress Coding Standards and best practices.
* Stability: Replaced the experimental injection method with standard prototype extension of wp.media.view.MediaFrame.Post and Select.
* Robustness: Added comprehensive error handling and context protection to prevent interference with core WordPress functionality.

= 1.0.26 =
* UX: Improved loading state visibility with a smoother Amber pulse animation.

= 1.0.25 =
* Fix: Corrected a variable naming collision in the Backbone.js model sync.

= 1.0.24 =
* Performance: Optimized the Puter.js initialization to fire only when the media modal is active.

= 1.0.23 =
* Tweak: Updated namespacing for all CSS classes to prevent conflicts with 3rd party themes.

= 1.0.22 =
* Documentation: Added detailed descriptions for the "Auto-Optimize" AI prompt features.

= 1.0.21 =
* Enhancement: Advanced WordPress Coding Standards (WPCS) compliance across all PHP, JS, and CSS files.
* Tweak: Converted all indentations to Tabs and normalized spacing inside parentheses and after control structures.
* Security: Hardened permission checks and nonce verification in all AJAX endpoints.

= 1.0.16 =
* Fix: Added missing translator comments for I18n placeholders to pass WordPress Plugin Check (WPC).
* Tweak: Replaced Backbone template tags with standard WordPress template syntax to avoid ASP-style tag warnings.

= 1.0.13 =
* Tweak: Moved documentation images to the official Screenshots section for better visibility and standard compliance.

= 1.0.12 =
* Tweak: Completely restructured readme.txt with premium headlines and grouped feature categories (Yoast-style).

= 1.0.11 =
* Tweak: Removed Pro features section and embedded configuration screenshots directly into documentation.

= 1.0.10 =
* Tweak: Converted Pro features comparison into a clean bulleted list because WordPress.org strips table formatting.

= 1.0.9 =
* Tweak: Converted Pro features table to HTML format for better rendering on WordPress.org.

= 1.0.8 =
* Feature: Added an "Auto-Credit" checkbox directly to the Image Search UI for easier toggling.

= 1.0.7 =
* Tweak: Reformatted Auto-Credit text to match official stock photo standards and link to user profiles.

= 1.0.6 =
* Update: Added comparison table for upcoming Pro and Ultra Pro features.

= 1.0.5 =
* Tweak: Added a "Settings" link directly on the WordPress Plugins page for easier access.

= 1.0.4 =
* Feature: Added new "Auto-Credit Photographer" setting to automatically append photographer attribution to image captions for Pexels and Pixabay.

= 1.0.3 =
* Security hardening: Added strict capability checks to all AJAX handlers.
* Updated documentation and optimized compliance with the WordPress Plugin Directory guidelines.
* Renamed from AI Cyphex Image Hunter to Cyphex Image Hunter.
* Fixed broken documentation URLs in readme.txt.
* Corrected contributor list to match WordPress.org username (hamaza7867).

= 1.0.2 =
* Added comprehensive "How to Use" guide directly in Settings page.
* Added Quick Setup links for API keys.

= 1.0.1 =
* Fixed disabled button state and added data persistence.
* Initial Release.

== Upgrade Notice ==

= 1.0.3 =
This version includes critical security improvements and full compliance with WordPress repository guidelines. Upgrading is highly recommended.
