jQuery Charts

A flexible, modern chart visualization library for Angular applications,
offering a wide range of chart types and customization options with a unified syntax
for multiple charts libraries

---

✨ Features

• 📊 Multiple chart types: Pie, Bar, Line, Treemap, Heatmap, Range, Funnel charts and more
• 🎨 Highly customizable with extensive configuration options
• 🔄 Interactive demos with source code preview for each chart type
• 🧩 Modular architecture for easy integration

---

📋 Table of Contents

• Installation
• Development Setup
• Project Structure
• Available Chart Types
• Documentation
• Contributing
• License

---

🚀 Installation

Using npm:

npm install @oneteme/jquery-core @oneteme/jquery-apexcharts

---

🛠️ Development Setup

1. Clone the repository:

git clone https://github.com/oneteme/jquery-charts.git
cd jquery-charts

2. Install dependencies:

npm install

3. Start the development server:

npm run dev

This will concurrently:

• Build the jquery-core library in watch mode
• Build the jquery-apexcharts library in watch mode (after core library is built)
• Start the Angular application in development mode

4. If you just want to work on the demo, you can simply enter this command :

npm run start

5. If you want, a basic-test page is available to test the integration of the libraries. You can simply uncomment the 'BasicTestComponent' in the following files:

• src/app/app-routing.module.ts
• src/app/app.module.ts

and uncomment the quick access button in the following file:

• src/app/components/footer/footer.component.html

This will allow you to access the basic-test page at /basic-test.

---

📁 Project Structure

jquery-charts/
├── projects/
│   └── oneteme/
│       ├── jquery-core/        # Core library with chart models and utilities
│       └── jquery-apexcharts/  # ApexCharts integration components
│
└── src/                        # Main application demo
    ├── app/
    │   ├── core/               # Core services
    │   ├── data/               # Sample chart data
    │   ├── pages/              # Application pages
    │   └── components/         # Shared components
    └── assets/                 # Static assets

---

📊 Available Chart Types

• Pie Charts: Standard pie, donut, polar area, and radial charts
• Bar Charts: Vertical, horizontal, stacked, and grouped bar charts
• Line Charts: Basic, curved, stepped, and annotated line charts
• Treemap Charts: Hierarchical visualization of data
• Heatmap Charts: Color-coded data visualization
• Range Charts: Range area, range bar charts
• Funnel Charts: Visualization for sequential data

---

📖 Documentation

The project includes comprehensive documentation with:

• Configuration options for each chart type
• Usage examples with code snippets
• Best practices and customization tips

Visit the documentation section in the application to learn more about using jQuery Charts.

---

👥 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

---

📄 License

This project is licensed under the Apache 2.0 License - see the LICENSE file for details.

---

⚠️ Third-Party Licenses

IMPORTANT LEGAL NOTICE: This section contains critical licensing information that may have legal implications for users. By using this library, you agree to comply with all applicable third-party licenses.

The library integrates with the following charting libraries. Please be aware of their respective licensing terms:

• ApexCharts - MIT License
• Highcharts - Commercial License (requires purchase for commercial use)