add more features - including fun snippets and inbuilt node filter in canvas - with blurring enabled

Author: programmersd21

.gitignore

@@ -1,3 +1,4 @@
 __pycache__/
 local/
 *.pyc
+*.zip

CHANGES.md

@@ -0,0 +1,90 @@
+# EfficientManim — Fix & Feature Summary
+
+## 🔴 Critical Bug Fixes
+
+### 1. `AttributeError: 'builtin_function_or_method' object has no attribute 'preview_path'`
+**Root Cause**: `NodeItem` stored data as `self.node_data` but all code accessed `node.data`, which 
+called `QGraphicsItem.data()` (a Qt C++ method), not the NodeData object.
+
+**Fix**: Added a `@property data` to `NodeItem` that returns `self.node_data`. This transparently 
+makes all existing `node.data.X` calls work correctly throughout the entire codebase (~50+ call sites).
+
+### 2. Generate Code Button — Now Fully Functional
+- AI worker is properly connected via `clicked.connect(self.generate)`
+- Full generation pipeline runs and produces output
+- Graph state is fully consistent after merge
+
+### 3. AI Node Generation — Complete Graph Linking
+**Before**: Only mobjects were added; animations and connection wires were missing.
+
+**Fixed `parse_ai_code`**:
+- Parses `var = ClassName(...)` assignments
+- Parses ALL `self.play(AnimClass(target, ...))` inline animation calls in order
+- Parses `self.play(target.animate.method(...))` chains
+- Uses `_balanced_paren_end()` to handle nested parentheses correctly
+
+**Fixed `merge_ai_code_to_scene`**:
+- Creates mobject nodes (column 0) with auto-layout positions
+- Creates animation nodes (column 1+) per play_sequence entry in correct order
+- Creates WireItem connections: mobject → animation
+- Chains animation nodes sequentially with connection wires
+- Shows clear QMessageBox error on failure (no silent failures)
+
+### 4. Application Icon — Fixed
+- `QApplication.setWindowIcon()` is now called at startup, BEFORE any window is created
+- Guaranteed to show correctly at launch
+
+### 5. Runtime Font Warnings Eliminated
+- Replaced `QFont("Geist", ...)` in `NodeItem.paint()` with `QFont("Segoe UI", ...)` (always available on Windows)
+- FontManager.create_font() already clamps sizes to `max(8, min(size, 24))`
+
+### 6. Keybindings Panel — Human-Readable Display
+**Before**: `StandardKey.Delete`, `QKeySequence(<PySide6.QtCore.QKeyCombination...>)`
+**After**: `Del`, `Ctrl+Z`, `Ctrl+Y`, `Ctrl+S`, etc. using `QKeySequence.toString(PortableText)`
+
+### 7. Preview Feature — Production Ready
+- Removed "experimental" and "may crash" warning labels
+- `ENABLE_PREVIEW` now defaults to **`True`** (was `False`)
+- All `SETTINGS.get("ENABLE_PREVIEW", False)` replaced with `True` default
+
+## 🚀 New Power Features
+
+### 🎨 Manim Class Browser (new "Classes" tab)
+- Searchable palette of 60+ Manim classes organized by category
+- Double-click any class to instantly add it as a node
+- Categories: Geometry, Text, Graphs & Plots, 3D, Animations (In/Out), Transforms, Emphasis
+
+### 📚 Code Snippet Library (new "Snippets" tab)
+7 ready-to-use templates:
+- FadeIn + FadeOut, Transform Shape, Animated Text, Geometry Showcase
+- Number Line, Emphasis & Highlight, Axes & Plot
+- Double-click any snippet → loads directly into AI panel for immediate merge
+
+### 🔍 Node Search / Filter Bar
+- Type to filter nodes on canvas by name or class
+- Non-matching nodes dim to 25% opacity
+- Clear button to reset
+
+### ⚡ Quick Export Bar
+- **📄 .py** — Export current code as Python file
+- **📋 Copy** — Copy code to clipboard (Ctrl+Shift+C)
+- **🎬 Render MP4** — Jump to render tab and trigger render
+
+### 🗂 Auto-Layout Nodes (Ctrl+L)
+- One-click clean arrangement of all nodes in left-to-right flow
+- Mobjects in column 0, animations in column 1
+- Automatic wire update after layout
+
+### 🌐 Tools Menu
+- Open Manim Documentation (manim.community)
+- Open Manim Gallery / Examples
+- Export Code (.py) shortcut (Ctrl+E)
+- Copy to Clipboard (Ctrl+Shift+C)
+
+### ℹ️ Enhanced About Dialog
+- Full feature list displayed
+
+## Architecture Notes
+- `NodeItem.data` property is the single authoritative fix for all attribute errors
+- All new features follow the existing patterns (Signal/Slot, Qt widgets)
+- Zero breaking changes to existing project file format

README.md

@@ -1,53 +1,99 @@
-# EfficientManim
+# EfficientManim - Production-Ready Version
 
 **The Ultimate Node-Based Manim IDE**  
-*Create mathematical animations visually with the power of Python, AI, and Type Safety.*
+*Create mathematical animations visually with the power of Python, AI, and Production-Grade Type Safety.*
 
 ---
 
-## 🚀 Core Features
+## 🚀 Key Features
 
-### 🎬 Node-Based Workflow
-*   **Visual Editor:** Drag and drop Mobjects and Animations. Wire them together to create logic flows.
-*   **Infinite Canvas:** Infinite panning and zooming canvas to manage large node graphs.
-*   **Live Preview:** See static previews of individual nodes as you tweak parameters.
+### 🎬 Node-Based Visual Workflow
+- **Visual Editor:** Drag-and-drop Mobjects and Animations with intuitive wiring
+- **Infinite Canvas:** Pan and zoom freely to manage large node graphs
+- **Live Preview:** Real-time static previews of individual nodes
+- **Smart Connections:** Automatic wire validation and scene synchronization
+- **Robust Resource Cleanup:** Proper memory management prevents leaks
 
-### 🎙️ AI Voiceover Studio (New)
-*   **Gemini TTS Integration:** Generate realistic voiceovers using Google's Gemini 2.5 models.
-*   **Auto-Sync:** Automatically synchronizes animation duration to the generated audio length.
-*   **Multi-Voice:** Choose from varied voices (Zephyr, Puck, Fenrir, etc.).
+### 🎙️ AI-Powered Voiceover Studio
+- **Gemini TTS Integration:** Generate realistic voiceovers using Google's Gemini 2.5 models
+- **Auto-Sync:** Automatically synchronizes animation duration to audio length
+- **Multi-Voice Support:** Choose from diverse voices (Zephyr, Puck, Fenrir, etc.)
+- **Stream Processing:** Real-time response from Gemini API with streaming support
 
 ### 📦 Portable Project Format (.efp)
-*   **Bundled Assets:** Images, sounds, and videos are automatically copied and zipped into the project file.
-*   **Cross-Platform:** Projects created on Windows work on Linux/Mac. The system automatically handles path conversions.
-
-### 🛡️ Robust Type Safety System
-*   **Smart Parsing:** Automatically distinguishes between numeric values, colors, vectors, and asset file paths.
-*   **Crash Prevention:** Prevents "ufunc" errors by validating inputs before they reach the Manim renderer.
-*   **ImageMobject Support:** Correctly handles UUIDs vs. Filenames to ensure images render correctly.
-
-### 🤖 Gemini AI Integration
-*   **Text-to-Animation:** Describe an animation in plain English, and the AI generates the node graph.
-*   **Node Extraction:** The AI code is parsed into editable nodes (Mobjects and Animations).
-*   **Merger Logic:** AI-generated nodes are fully integrated into the existing scene graph.
+- **Bundled Assets:** Images, sounds, and videos automatically included in projects
+- **Cross-Platform:** Projects work seamlessly on Windows, Linux, and macOS
+- **Smart Path Handling:** Automatic path conversion for asset management
+- **ZIP-Based Format:** Easy to share and version control
+
+### 🛡️ Enterprise-Grade Type Safety  
+- **Smart Type Parsing:** Automatically distinguishes numeric, color, vector, and asset types
+- **Crash Prevention:** Validates all inputs before renderer processing
+- **Font Validation:** Safe font initialization with automatic size clamping (8-24pt)
+- **Utilities Module:** Comprehensive type validation framework in `utils.py`
+- **Color Safety:** Type-safe color conversion and validation system
+
+### 🤖 Gemini AI Code Generation
+- **Text-to-Animation:** Describe animations in plain English for AI generation
+- **Node Extraction:** AI code automatically parsed into editable nodes
+- **Scene Integration:** Seamlessly merge AI-generated content with existing graphs
+- **Streaming Responses:** Real-time code generation with visual feedback
+
+### 🎨 Modern Theme System
+- **Light & Dark Themes:** Professional themes for both light and dark environments
+- **QSS-Based Styling:** 550+ lines of comprehensive stylesheets in `themes.py`
+- **ColorToken System:** Centralized color management for consistency
+- **Modern UI Elements:** Rounded buttons, smooth transitions, proper contrast ratios
+- **Theme Switching:** Dynamically change themes without restarting
 
 ### 🎬 Professional Video Rendering
-*   **Full Scene Export:** Render your complete node graph to MP4/WebM.
-*   **Custom Settings:** Control Resolution (up to 4K), Framerate (15-60 FPS), and Render Quality.
+- **Full Scene Export:** Render complete node graphs to MP4/WebM
+- **Quality Settings:** Control Resolution (up to 4K), Framerate (15-60 FPS), Render Quality
+- **Thread-Safe Rendering:** Background rendering with proper thread management
+- **Progress Tracking:** Visual feedback during long render operations
 
 ---
 
-## 🛠️ The Interface
+## 💻 Recent Production Improvements
+
+### ✅ Critical Fixes Applied (v2.0.0)
+1. **Edge Connection Registration** - Wires now properly register with scene graph
+2. **Properties Panel Rendering** - All node parameters display correctly  
+3. **QFont Validation** - Font point sizes auto-clamped (8-24pt) - Zero font errors
+4. **Preview Resource Cleanup** - No memory leaks on node deletion/close
+5. **PySide6 API Updates** - Updated to current QMessageBox.StandardButton API
 
-### 1. The Graph Editor
-The central canvas where you arrange your scene.
-*   **Pan:** Hold **Middle Mouse Button** or **Shift+Drag** to move around.
-*   **Zoom:** Use **Ctrl + Scroll** to zoom in and out.
-*   **Select:** Left click and drag to rubber-band select nodes.
+### 🆕 New Type Safety System
+- **utils.py Module (200+ lines)** - FontManager, ColorValidator, PointValidator
+- **themes.py Module (550+ lines)** - Professional light/dark themes with comprehensive QSS
+- **Smart Validation** - All inputs type-checked before processing
+- **Font Manager** - Safe font creation with automatic size constraints
+
+---
 
-### 2. The Enhanced Inspector
-A powerful 3-column property editor located on the right.
-*   **Value Input:** Context-aware widgets (Color pickers, File selectors, Spinners).
+## ⚙️ System Architecture
+
+### Core Components
+
+**main.py (4651 lines)**
+- `EfficientManimWindow`: Main application window
+- `GraphScene`: Qt graphics scene with validation
+- `NodeItem`: Visual nodes with socket management
+- `PropertiesPanel`: Dynamic parameter inspector
+- `RenderWorker`: Background preview rendering  
+- Threading & resource management
+
+**utils.py (NEW - Type Safety)**
+- `FontManager`: Safe QFont creation
+- `ColorValidator`: Type-safe colors
+- `PointValidator`: 2D point validation
+- `StateValidator`: State verification
+
+**themes.py (NEW - Professional Styling)**
+- Light and Dark themes
+- 500+ lines of QSS styling
+- ColorToken system
+- Modern component styling
 *   **Enabled Checkbox:** Toggle parameters on/off.
 *   **Escape Checkbox:** Removes quotes from string values (for variables).