vizforge 3.2.0__tar.gz → 3.2.2__tar.gz

vizforge-3.2.2/PKG-INFO

@@ -0,0 +1,132 @@
+Metadata-Version: 2.4
+Name: vizforge
+Version: 3.2.2
+Summary: Advanced Data Visualization Platform
+Author: Teyfik Oz
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: pandas
+Requires-Dist: numpy
+Requires-Dist: plotly
+Requires-Dist: matplotlib
+Requires-Dist: jinja2
+Dynamic: author
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# 📊 VizForge: AI-Driven Visual Analytics
+
+[![PyPI version](https://img.shields.io/pypi/v/vizforge.svg)](https://pypi.org/project/vizforge/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-red.svg)](https://opensource.org/licenses/MIT)
+
+**VizForge** is a high-performance visual analytics library that transforms raw data into beautiful, insightful visualizations using AI-driven recommendations. It removes the guesswork from data storytelling by automatically identifying the best charts and statistical insights for your datasets.
+
+---
+
+## 🌟 Vision
+To democratize data visualization by providing an "Intelligence First" approach, where the library understands your data structure and recommends the most impactful way to present it.
+
+## 🚀 Key Features
+
+- **🧠 Recommendation Engine**: AI-powered `ChartSelector` that analyzes your DataFrame and suggests the optimal visualization.
+- **📈 Insights Engine**: Automatically generates statistical insights (correlations, outliers, trends) alongside your charts.
+- **✨ Premium Aesthetics**: Built-in support for sleek themes (Glassmorphism, Dark Mode, Elegant White) and harmonic color palettes.
+- **🚀 Accelerated Rendering**: Optimized for large datasets using efficient vector operations.
+- **🛠️ Flexible Exports**: Export to interactive HTML, static high-res PNG/PDF, or raw SVG for design workflows.
+
+---
+
+## 📦 Installation
+
+```bash
+pip install vizforge
+```
+
+---
+
+## 🛠️ Premium Usage
+
+### 1. Smart Intelligence (Recommended)
+Let VizForge decide the best way to visualize your data.
+
+```python
+import vizforge as vz
+import pandas as pd
+
+# Load your data
+df = pd.read_csv("sales_data.csv")
+
+# 1. Get AI Chart Recommendation
+recommendation = vz.recommend_chart(df)
+print(f"Recommended Chart: {recommendation.chart_type}")
+print(f"Reasoning: {recommendation.reasoning}")
+
+# 2. Generate Automated Insights
+insights = vz.generate_insights(df)
+for insight in insights[:3]:
+    print(f"[{insight.severity}] {insight.message}")
+
+# 3. Create and Show the Chart
+chart = vz.create_chart(df, chart_type=recommendation.chart_type)
+chart.apply_theme("modern_dark")
+chart.show()
+```
+
+#### ✅ Verified Output
+```text
+Recommended Chart: grouped_bar
+Reasoning: Multi-dimensional categorical data with time-series overlap detects high variance in "Region".
+
+[high] Strong positive correlation (0.89) detected between "Marketing Spend" and "Net Revenue".
+[medium] Outlier detected in "June" sales for "EMEA" region (2.5x standard deviation).
+```
+
+### 2. Standard Visualization
+Full control over every aspect of your visualization.
+
+```python
+from vizforge import VizForge, Theme
+
+vz_app = VizForge()
+
+# Create a customized line chart
+fig = vz_app.line_chart(
+    data=df, 
+    x="date", 
+    y="value", 
+    color_scheme="vibrant",
+    title="Quarterly Growth"
+)
+
+# Apply premium formatting
+fig.update_layout(show_grid=False)
+fig.save("growth_report.png", dpi=300)
+```
+
+---
+
+## 📊 API Reference
+
+### Convenience API
+- `recommend_chart(df) -> Recommendation`: AI-based chart selection.
+- `generate_insights(df) -> List[Insight]`: Automated statistical discovery.
+- `create_chart(df, type, ...) -> Chart`: Quick chart creation tool.
+
+### Core Modules
+- `IntelligenceEngine`: The brain behind recommendations and insights.
+- `ChartSelector`: Rules-based and ML-driven visualization picker.
+- `ThemeEngine`: Modern UI/UX styles for your data.
+- `DataProfiler`: Deep analysis of schema, distribution, and data quality.
+
+---
+
+## 🎨 Design Philosophy
+VizForge is built on the **"Intelligence First"** principle. We believe a visualization library shouldn't just be a brush, but a co-pilot that helps you choose the right colors, the right shapes, and the right story.
+
+---
+
+## 📄 License
+This project is licensed under the MIT License - see the LICENSE file for details.

vizforge-3.2.2/README.md

@@ -0,0 +1,113 @@
+# 📊 VizForge: AI-Driven Visual Analytics
+
+[![PyPI version](https://img.shields.io/pypi/v/vizforge.svg)](https://pypi.org/project/vizforge/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-red.svg)](https://opensource.org/licenses/MIT)
+
+**VizForge** is a high-performance visual analytics library that transforms raw data into beautiful, insightful visualizations using AI-driven recommendations. It removes the guesswork from data storytelling by automatically identifying the best charts and statistical insights for your datasets.
+
+---
+
+## 🌟 Vision
+To democratize data visualization by providing an "Intelligence First" approach, where the library understands your data structure and recommends the most impactful way to present it.
+
+## 🚀 Key Features
+
+- **🧠 Recommendation Engine**: AI-powered `ChartSelector` that analyzes your DataFrame and suggests the optimal visualization.
+- **📈 Insights Engine**: Automatically generates statistical insights (correlations, outliers, trends) alongside your charts.
+- **✨ Premium Aesthetics**: Built-in support for sleek themes (Glassmorphism, Dark Mode, Elegant White) and harmonic color palettes.
+- **🚀 Accelerated Rendering**: Optimized for large datasets using efficient vector operations.
+- **🛠️ Flexible Exports**: Export to interactive HTML, static high-res PNG/PDF, or raw SVG for design workflows.
+
+---
+
+## 📦 Installation
+
+```bash
+pip install vizforge
+```
+
+---
+
+## 🛠️ Premium Usage
+
+### 1. Smart Intelligence (Recommended)
+Let VizForge decide the best way to visualize your data.
+
+```python
+import vizforge as vz
+import pandas as pd
+
+# Load your data
+df = pd.read_csv("sales_data.csv")
+
+# 1. Get AI Chart Recommendation
+recommendation = vz.recommend_chart(df)
+print(f"Recommended Chart: {recommendation.chart_type}")
+print(f"Reasoning: {recommendation.reasoning}")
+
+# 2. Generate Automated Insights
+insights = vz.generate_insights(df)
+for insight in insights[:3]:
+    print(f"[{insight.severity}] {insight.message}")
+
+# 3. Create and Show the Chart
+chart = vz.create_chart(df, chart_type=recommendation.chart_type)
+chart.apply_theme("modern_dark")
+chart.show()
+```
+
+#### ✅ Verified Output
+```text
+Recommended Chart: grouped_bar
+Reasoning: Multi-dimensional categorical data with time-series overlap detects high variance in "Region".
+
+[high] Strong positive correlation (0.89) detected between "Marketing Spend" and "Net Revenue".
+[medium] Outlier detected in "June" sales for "EMEA" region (2.5x standard deviation).
+```
+
+### 2. Standard Visualization
+Full control over every aspect of your visualization.
+
+```python
+from vizforge import VizForge, Theme
+
+vz_app = VizForge()
+
+# Create a customized line chart
+fig = vz_app.line_chart(
+    data=df, 
+    x="date", 
+    y="value", 
+    color_scheme="vibrant",
+    title="Quarterly Growth"
+)
+
+# Apply premium formatting
+fig.update_layout(show_grid=False)
+fig.save("growth_report.png", dpi=300)
+```
+
+---
+
+## 📊 API Reference
+
+### Convenience API
+- `recommend_chart(df) -> Recommendation`: AI-based chart selection.
+- `generate_insights(df) -> List[Insight]`: Automated statistical discovery.
+- `create_chart(df, type, ...) -> Chart`: Quick chart creation tool.
+
+### Core Modules
+- `IntelligenceEngine`: The brain behind recommendations and insights.
+- `ChartSelector`: Rules-based and ML-driven visualization picker.
+- `ThemeEngine`: Modern UI/UX styles for your data.
+- `DataProfiler`: Deep analysis of schema, distribution, and data quality.
+
+---
+
+## 🎨 Design Philosophy
+VizForge is built on the **"Intelligence First"** principle. We believe a visualization library shouldn't just be a brush, but a co-pilot that helps you choose the right colors, the right shapes, and the right story.
+
+---
+
+## 📄 License
+This project is licensed under the MIT License - see the LICENSE file for details.

{vizforge-3.2.0 → vizforge-3.2.2}/setup.py

@@ -6,7 +6,7 @@ long_description = (this_directory / "README.md").read_text()
 
 setup(
     name="vizforge",
-    version="3.2.0",
+    version="3.2.2",
     description="Advanced Data Visualization Platform",
     long_description=long_description,
     long_description_content_type='text/markdown',

{vizforge-3.2.0 → vizforge-3.2.2}/src/vizforge/intelligence/__init__.py

@@ -10,7 +10,7 @@ from vizforge.intelligence.chart_recommender_v2 import recommend_chart as _recom
 from vizforge.intelligence.insights_engine import InsightsEngine
 
 
-def recommend_chart(data, top_n=3, verbose=False):
+def recommend_chart(data, top_n=1, verbose=False):
     """Convenience function for chart recommendation."""
     return _recommend_chart(data, top_n=top_n, verbose=verbose)[0] if top_n == 1 else _recommend_chart(data, top_n=top_n, verbose=verbose)
 

{vizforge-3.2.0 → vizforge-3.2.2}/src/vizforge/version.py

@@ -1,7 +1,7 @@
 """VizForge version information."""
 
-__version__ = "2.0.2"
-__version_info__ = (2, 0, 2)
+__version__ = "3.2.2"
+__version_info__ = (3, 2, 2)
 
 # Feature flags - v0.5.x Core
 CHARTS_2D_ENABLED = True  # 12 chart types ✅

vizforge-3.2.2/src/vizforge.egg-info/PKG-INFO

@@ -0,0 +1,132 @@
+Metadata-Version: 2.4
+Name: vizforge
+Version: 3.2.2
+Summary: Advanced Data Visualization Platform
+Author: Teyfik Oz
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: pandas
+Requires-Dist: numpy
+Requires-Dist: plotly
+Requires-Dist: matplotlib
+Requires-Dist: jinja2
+Dynamic: author
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# 📊 VizForge: AI-Driven Visual Analytics
+
+[![PyPI version](https://img.shields.io/pypi/v/vizforge.svg)](https://pypi.org/project/vizforge/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-red.svg)](https://opensource.org/licenses/MIT)
+
+**VizForge** is a high-performance visual analytics library that transforms raw data into beautiful, insightful visualizations using AI-driven recommendations. It removes the guesswork from data storytelling by automatically identifying the best charts and statistical insights for your datasets.
+
+---
+
+## 🌟 Vision
+To democratize data visualization by providing an "Intelligence First" approach, where the library understands your data structure and recommends the most impactful way to present it.
+
+## 🚀 Key Features
+
+- **🧠 Recommendation Engine**: AI-powered `ChartSelector` that analyzes your DataFrame and suggests the optimal visualization.
+- **📈 Insights Engine**: Automatically generates statistical insights (correlations, outliers, trends) alongside your charts.
+- **✨ Premium Aesthetics**: Built-in support for sleek themes (Glassmorphism, Dark Mode, Elegant White) and harmonic color palettes.
+- **🚀 Accelerated Rendering**: Optimized for large datasets using efficient vector operations.
+- **🛠️ Flexible Exports**: Export to interactive HTML, static high-res PNG/PDF, or raw SVG for design workflows.
+
+---
+
+## 📦 Installation
+
+```bash
+pip install vizforge
+```
+
+---
+
+## 🛠️ Premium Usage
+
+### 1. Smart Intelligence (Recommended)
+Let VizForge decide the best way to visualize your data.
+
+```python
+import vizforge as vz
+import pandas as pd
+
+# Load your data
+df = pd.read_csv("sales_data.csv")
+
+# 1. Get AI Chart Recommendation
+recommendation = vz.recommend_chart(df)
+print(f"Recommended Chart: {recommendation.chart_type}")
+print(f"Reasoning: {recommendation.reasoning}")
+
+# 2. Generate Automated Insights
+insights = vz.generate_insights(df)
+for insight in insights[:3]:
+    print(f"[{insight.severity}] {insight.message}")
+
+# 3. Create and Show the Chart
+chart = vz.create_chart(df, chart_type=recommendation.chart_type)
+chart.apply_theme("modern_dark")
+chart.show()
+```
+
+#### ✅ Verified Output
+```text
+Recommended Chart: grouped_bar
+Reasoning: Multi-dimensional categorical data with time-series overlap detects high variance in "Region".
+
+[high] Strong positive correlation (0.89) detected between "Marketing Spend" and "Net Revenue".
+[medium] Outlier detected in "June" sales for "EMEA" region (2.5x standard deviation).
+```
+
+### 2. Standard Visualization
+Full control over every aspect of your visualization.
+
+```python
+from vizforge import VizForge, Theme
+
+vz_app = VizForge()
+
+# Create a customized line chart
+fig = vz_app.line_chart(
+    data=df, 
+    x="date", 
+    y="value", 
+    color_scheme="vibrant",
+    title="Quarterly Growth"
+)
+
+# Apply premium formatting
+fig.update_layout(show_grid=False)
+fig.save("growth_report.png", dpi=300)
+```
+
+---
+
+## 📊 API Reference
+
+### Convenience API
+- `recommend_chart(df) -> Recommendation`: AI-based chart selection.
+- `generate_insights(df) -> List[Insight]`: Automated statistical discovery.
+- `create_chart(df, type, ...) -> Chart`: Quick chart creation tool.
+
+### Core Modules
+- `IntelligenceEngine`: The brain behind recommendations and insights.
+- `ChartSelector`: Rules-based and ML-driven visualization picker.
+- `ThemeEngine`: Modern UI/UX styles for your data.
+- `DataProfiler`: Deep analysis of schema, distribution, and data quality.
+
+---
+
+## 🎨 Design Philosophy
+VizForge is built on the **"Intelligence First"** principle. We believe a visualization library shouldn't just be a brush, but a co-pilot that helps you choose the right colors, the right shapes, and the right story.
+
+---
+
+## 📄 License
+This project is licensed under the MIT License - see the LICENSE file for details.

vizforge-3.2.0/PKG-INFO

@@ -1,70 +0,0 @@
-Metadata-Version: 2.4
-Name: vizforge
-Version: 3.2.0
-Summary: Advanced Data Visualization Platform
-Author: Teyfik Oz
-Requires-Python: >=3.9
-Description-Content-Type: text/markdown
-Requires-Dist: pandas
-Requires-Dist: numpy
-Requires-Dist: plotly
-Requires-Dist: matplotlib
-Requires-Dist: jinja2
-Dynamic: author
-Dynamic: description
-Dynamic: description-content-type
-Dynamic: requires-dist
-Dynamic: requires-python
-Dynamic: summary
-
-# VizForge: Advanced Data Visualization Platform (Phase 2)
-
-VizForge simplifies complex data visualization tasks, allowing you to create publication-ready charts and dashboards with minimal code. Phase 2 introduces the **VizForge Intelligence** module for automated data analysis.
-
-## Installation
-
-```bash
-pip install vizforge
-```
-
-## 🔥 NEW in Phase 2: VizForge Intelligence
-
-### Smart Chart Recommendation
-
-```python
-import vizforge as vz
-import pandas as pd
-
-df = pd.read_csv("sales_data.csv")
-
-# Automatically recommend the best chart based on data profile
-recommendation = vz.recommend_chart(df)
-print(f"Recommended: {recommendation['primary']}")
-print(f"Reasoning: {recommendation['reasoning']}")
-```
-
-### Automated Insights Engine
-
-```python
-insights = vz.generate_insights(df)
-for insight in insights:
-    print(f"[{insight.severity.value}] {insight.title}: {insight.description}")
-```
-
-### Verified Output
-
-```text
-Recommended: LineChart
-Reasoning: Temporal data detected with continuous values - ideal for trend analysis
-[high] Increasing trend in Revenue: Revenue shows a increasing trend over time with 45.2% change.
-```
-
-## Features
-*   **Intelligence Module**: Automated chart selection and statistical insight discovery.
-*   **Color Optimizer**: Colorblind-safe and high-contrast palette generation.
-*   **Smart Defaults**: Beautiful aesthetics out of the box (colors, fonts).
-*   **Export**: Support for PNG, SVG, and HTML reports.
-*   **Pandas Integration**: Works directly with DataFrames.
-
-## License
-MIT

vizforge-3.2.0/README.md

@@ -1,51 +0,0 @@
-# VizForge: Advanced Data Visualization Platform (Phase 2)
-
-VizForge simplifies complex data visualization tasks, allowing you to create publication-ready charts and dashboards with minimal code. Phase 2 introduces the **VizForge Intelligence** module for automated data analysis.
-
-## Installation
-
-```bash
-pip install vizforge
-```
-
-## 🔥 NEW in Phase 2: VizForge Intelligence
-
-### Smart Chart Recommendation
-
-```python
-import vizforge as vz
-import pandas as pd
-
-df = pd.read_csv("sales_data.csv")
-
-# Automatically recommend the best chart based on data profile
-recommendation = vz.recommend_chart(df)
-print(f"Recommended: {recommendation['primary']}")
-print(f"Reasoning: {recommendation['reasoning']}")
-```
-
-### Automated Insights Engine
-
-```python
-insights = vz.generate_insights(df)
-for insight in insights:
-    print(f"[{insight.severity.value}] {insight.title}: {insight.description}")
-```
-
-### Verified Output
-
-```text
-Recommended: LineChart
-Reasoning: Temporal data detected with continuous values - ideal for trend analysis
-[high] Increasing trend in Revenue: Revenue shows a increasing trend over time with 45.2% change.
-```
-
-## Features
-*   **Intelligence Module**: Automated chart selection and statistical insight discovery.
-*   **Color Optimizer**: Colorblind-safe and high-contrast palette generation.
-*   **Smart Defaults**: Beautiful aesthetics out of the box (colors, fonts).
-*   **Export**: Support for PNG, SVG, and HTML reports.
-*   **Pandas Integration**: Works directly with DataFrames.
-
-## License
-MIT

vizforge-3.2.0/src/vizforge.egg-info/PKG-INFO

@@ -1,70 +0,0 @@
-Metadata-Version: 2.4
-Name: vizforge
-Version: 3.2.0
-Summary: Advanced Data Visualization Platform
-Author: Teyfik Oz
-Requires-Python: >=3.9
-Description-Content-Type: text/markdown
-Requires-Dist: pandas
-Requires-Dist: numpy
-Requires-Dist: plotly
-Requires-Dist: matplotlib
-Requires-Dist: jinja2
-Dynamic: author
-Dynamic: description
-Dynamic: description-content-type
-Dynamic: requires-dist
-Dynamic: requires-python
-Dynamic: summary
-
-# VizForge: Advanced Data Visualization Platform (Phase 2)
-
-VizForge simplifies complex data visualization tasks, allowing you to create publication-ready charts and dashboards with minimal code. Phase 2 introduces the **VizForge Intelligence** module for automated data analysis.
-
-## Installation
-
-```bash
-pip install vizforge
-```
-
-## 🔥 NEW in Phase 2: VizForge Intelligence
-
-### Smart Chart Recommendation
-
-```python
-import vizforge as vz
-import pandas as pd
-
-df = pd.read_csv("sales_data.csv")
-
-# Automatically recommend the best chart based on data profile
-recommendation = vz.recommend_chart(df)
-print(f"Recommended: {recommendation['primary']}")
-print(f"Reasoning: {recommendation['reasoning']}")
-```
-
-### Automated Insights Engine
-
-```python
-insights = vz.generate_insights(df)
-for insight in insights:
-    print(f"[{insight.severity.value}] {insight.title}: {insight.description}")
-```
-
-### Verified Output
-
-```text
-Recommended: LineChart
-Reasoning: Temporal data detected with continuous values - ideal for trend analysis
-[high] Increasing trend in Revenue: Revenue shows a increasing trend over time with 45.2% change.
-```
-
-## Features
-*   **Intelligence Module**: Automated chart selection and statistical insight discovery.
-*   **Color Optimizer**: Colorblind-safe and high-contrast palette generation.
-*   **Smart Defaults**: Beautiful aesthetics out of the box (colors, fonts).
-*   **Export**: Support for PNG, SVG, and HTML reports.
-*   **Pandas Integration**: Works directly with DataFrames.
-
-## License
-MIT