Fixed infinite growing charts

CHANGELOG.md

@@ -1,5 +1,30 @@
 # Changelog
 
+## 1.5.2 - 2020-11-09
+
+- Fixed infinite growing charts
+
+## 1.5.1 - 2020-11-09
+
+- Removed unused Alpine directives
+
+## 1.5.0 - 2020-11-09
+
+- Added `LivewireCharts` facade to create any chart model
+- Added `sparklined` Apex Chart feature to all charts (https://apexcharts.com/javascript-chart-demos/sparklines/basic/)
+
+## 1.4.0 - 2020-11-07
+
+- Added Multi Column Chart 
+- Added Stacked Multi Column Chart 
+- Added support for custom X Axis categories
+
+## 1.3.0 - 2020-11-03
+
+- Added Multi Line Chart 
+- Added Data Labels configuration for all charts
+- Refactored title and animation to traits
+
 ## 1.2.0 - 2020-10-25
 
 - Fixed column chart growing infinitely 

README.md

@@ -1,11 +1,15 @@
-# Livewire Charts
+[![GitHub release](https://img.shields.io/github/release/asantibanez/livewire-charts.svg)](https://github.com/asantibanez/livewire-charts/releases/)
 
-Neat Livewire Charts for your Laravel projects.
+![Livewire Charts](https://banners.beyondco.de/Livewire%20Charts.png?theme=light&packageName=asantibanez%2Flivewire-charts&pattern=graphPaper&style=style_1&description=Neat+Livewire+Charts+for+your+Laravel+projects&md=1&fontSize=100px&images=chart-square-bar)
 
 ## Preview
 
 ![preview](https://github.com/asantibanez/livewire-charts/raw/master/preview.gif)
 
+## Demo
+
+https://github.com/asantibanez/livewire-charts-demo
+
 ## Installation
 
 You can install the package via composer:
@@ -23,7 +27,7 @@ This package requires the following packages/libraries to work:
 
 Please follow each package/library instructions on how to set them properly in your project.
 
-> Note: At the moment, `Apex Charts` is only supported for drawing charts.  
+>Note: At the moment, `Apex Charts` is only supported for drawing charts.  
 
 ## Usage
 
@@ -50,7 +54,7 @@ $columnChartModel =
     ;
 ``` 
 
-> Note: Chart model methods are chainable 💪 
+>Note: Chart model methods are chainable 💪 
 
 With `$columnChartModel` at hand, we pass it to our `LivewireColumnChart` component in our Blade template. 
 
@@ -64,9 +68,22 @@ And that's it! You have a beautiful rendered chart in seconds. 👌
 
 ![column chart example](https://github.com/asantibanez/livewire-charts/raw/master/column-chart-example.png)
 
-> Note: You can use these charts inside other Livewire components too. Just render them in your Blade template and you
+>Note: You can use these charts inside other Livewire components too. Just render them in your Blade template and you
 are good to go. 👍 
 
+## LivewireCharts facade
+
+Chart models can also be created using the `LivewireCharts` facade.
+
+```php
+LivewireCharts::lineChartModel();
+LivewireCharts::multiLineChartModel();
+LivewireCharts::columnChartModel();
+LivewireCharts::multiColumnChartModel();
+LivewireCharts::pieChartModel();
+LivewireCharts::areaChartModel();
+```
+
 ## Enabling Interactions
 
 To enable click events, you must use the `with[XXX]ClickEvent($eventName)` method present in every model class and 
@@ -125,23 +142,40 @@ The parent component renders the charts as follows
 For each chart, a specific model class needs to be used. Here, it is detailed the api available
 for each type of chart.
 
-#### LivewireLineChart
+#### All
 
 | Method | Description |
 |--------|-------------|
 | setTitle(string $title) | Sets chart title |
 | setAnimated(boolean $animated) | Enables/disables animation |
-| addPoint(string $title, double $value, array $extras = []) | Adds a point to the line chart. `$extras` is forwarded on click event |
+| setDataLabelsEnabled(boolean $enabled) | Enables/disables data labels |
-| addMarker(string $title, double $value) | Adds a marker point to the line chart. Markers are used to emphasize particular points in the chart |
+| withDataLabels() | Enables data labels |
+| withoutDataLabels() | Disables data labels |
+| withLegends() | Shows legends |
+| withoutLegends() | Hides legends |
+| setXAxisCategories(array $categories) | Enables custom categories for chart X Axis |
+| sparklined() | Enables Apex Charts sparkline feature |
+| setSparklineEnabled(boolean $isEnabled) | Enables/Disables Apex Charts sparkline feature |
+
+#### LivewireLineChart
+
+| Method | Description |
+|--------|-------------|
+| multiLine() | Adds multiline support for line chart |
+| singleLine() | Adds single support for line chart |
+| addPoint(string $title, double $value, array $extras = []) | Adds a point to a single line chart. `$extras` is forwarded on click event |
+| addSeriesPoint(string $seriesName, string $title, double $value, array $extras = []) | Adds a point to series to a multi line chart. `$extras` is forwarded on click event |
+| addMarker(string $title, double $value) | Adds a marker point to the line chart. Markers are used to emphasize particular points in the chart (singleLine only) |
 | withOnPointClickEvent(string $eventName) | Event Name that will be fired when a point/marker of the chart is clicked |
 
 #### LivewireColumnChart
 
 | Method | Description |
 |--------|-------------|
-| setTitle(string $title) | Sets chart title |
-| setAnimated(boolean $animated) | Enables/disables animation |
 | setOpacity(int $opacity) | Sets columns' opacity |
+| multiColumn() | Sets chart to display multiple column series |
+| singleColumn() | Sets chart to display a single column series |
+| stacked() | Sets chart to display column series stacked |
 | addColumn(string $title, double $value, string $color, array $extras = []) | Adds a column to the chart with the specified color. `$extras` is forwarded on click event |
 | onColumnClickEventName(string $eventName) | Event Name that will be fired when a column of the chart is clicked |
 
@@ -149,8 +183,6 @@ for each type of chart.
 
 | Method | Description |
 |--------|-------------|
-| setTitle(string $title) | Sets chart title |
-| setAnimated(boolean $animated) | Enables/disables animation |
 | setOpacity(int $opacity) | Sets slices' opacity |
 | addSlice(string $title, double $value, string $color, array $extras = []) | Adds a slice to the chart with the specified color. `$extras` is forwarded on click event |
 | withOnSliceClickEvent(string $eventName) | Event Name that will be fired when a column of the chart is clicked |
@@ -159,13 +191,24 @@ for each type of chart.
 
 | Method | Description |
 |--------|-------------|
-| setTitle(string $title) | Sets chart title |
-| setAnimated(boolean $animated) | Enables/disables animation |
 | addPoint(string $title, double $value, array $extras = []) | Adds a point to the area chart. `$extras` is forwarded on click event |
 | withOnPointClickEvent(string $eventName) | Event Name that will be fired when a point of the chart is clicked |
 | setXAxisVisible(boolean $visible) | Shows/hides xAxis labels |
 | setYAxisVisible(boolean $visible) | Shows/hides yAxis labels |
 
+## Troubleshooting
+
+Chart components must be placed inside a container with fixed height. This is because the chart will use all the given
+vertical space. A fixed height is needed to render properly.
+
+ ```blade
+<div style="height: 32rem;">
+    <livewire:livewire-column-chart .../>
+</div>
+ ``` 
+
+>Note: if a fixed height is not given, the chart will grow vertically infinitely. That's not what we want, right?
+
 ## Testing
 
 ``` bash

resources/views/livewire-area-chart.blade.php

@@ -1,8 +1,7 @@
 <div
-    class="w-full h-full"
+    style="width: 100%; height: 100%;"
     x-data="{ ...areaChart() }"
     x-init="drawChart(@this)"
-    x-on:draw-column-chart.window="drawChart(@this)"
 >
     <div wire:ignore x-ref="container"></div>
 
@@ -16,39 +15,48 @@
                         this.chart.destroy()
                     }
 
+                    const title = component.get('areaChartModel.title');
+                    const animated = component.get('areaChartModel.animated') || false;
+                    const dataLabels = component.get('areaChartModel.dataLabels') || {};
+                    const onPointClickEventName = component.get('areaChartModel.onPointClickEventName')
+                    const data = component.get('areaChartModel.data');
+                    const sparkline = component.get('areaChartModel.sparkline');
+
+                    const categories = component.get('areaChartModel.xAxis.categories').length > 0
+                        ? component.get('areaChartModel.xAxis.categories')
+                        : data.map(item => item.title)
+                    ;
+
                     var options = {
                         series: [{
-                            name: component.get('areaChartModel.title'),
+                            name: title,
-                            data: component.get('areaChartModel.data').map(item => item.value)
+                            data: data.map(item => item.value)
                         }],
                         chart: {
                             type: 'area',
                             height: '100%',
 
+                            ...sparkline,
+
                             zoom: { enabled: false },
 
                             toolbar: { show: false },
 
-                            animations: {
+                            animations: { enabled: animated },
-                                enabled: component.get('areaChartModel.animated') || false,
-                            },
 
                             events: {
                                 markerClick: function(event, chartContext, { dataPointIndex }) {
-                                    const onPointClickEventName = component.get('areaChartModel.onPointClickEventName')
                                     if (!onPointClickEventName) {
                                         return
                                     }
 
-                                    const point = component.get('areaChartModel.data')[dataPointIndex]
+                                    const point = data[dataPointIndex]
                                     component.call('onPointClick', point)
                                 }
                             }
                         },
 
-                        dataLabels: {
+                        dataLabels: dataLabels,
-                            enabled: false
-                        },
 
                         colors: [component.get('areaChartModel.color') || '#2E93fA'],
 
@@ -57,13 +65,16 @@
                         },
 
                         title: {
-                            text: component.get('areaChartModel.title'),
+                            text: title,
                             align: 'center'
                         },
 
-                        labels: component.get('areaChartModel.data').map(item => item.title),
+                        labels: data.map(item => item.title),
 
-                        xaxis: component.get('areaChartModel.xAxis') || {},
+                        xaxis: {
+                            labels: component.get('areaChartModel.xAxis.labels'),
+                            categories: categories,
+                        },
 
                         yaxis: component.get('areaChartModel.yAxis') || {},
 

resources/views/livewire-column-chart.blade.php

@@ -1,8 +1,7 @@
 <div
-    class="w-full h-full"
+    style="width: 100%; height: 100%;"
     x-data="{ ...columnChart() }"
     x-init="drawChart(@this)"
-    x-on:draw-column-chart.window="drawChart(@this)"
 >
     <div wire:ignore x-ref="container"></div>
 
@@ -12,49 +11,47 @@
                 chart: null,
 
                 drawChart(component) {
-                    this.renderApex(component)
-                },
-
-                renderApex(component) {
                     if (this.chart) {
                         this.chart.destroy()
                     }
 
+                    const animated = component.get('columnChartModel.animated') || false;
+                    const onColumnClickEventName = component.get('columnChartModel.onColumnClickEventName')
+                    const dataLabels = component.get('columnChartModel.dataLabels') || {};
+                    const data = component.get('columnChartModel.data');
+                    const sparkline = component.get('columnChartModel.sparkline');
+
                     const options = {
-                        series: [{ data: component.get('columnChartModel.data').map(item => item.value)}],
+                        series: [{ data: data.map(item => item.value)}],
 
                         chart: {
                             type: 'bar',
                             height: '100%',
 
-                            toolbar: {
+                            ...sparkline,
-                                show: false
-                            },
 
-                            animations: {
+                            toolbar: { show: false },
-                                enabled: component.get('columnChartModel.animated') || false,
+
-                            },
+                            animations: { enabled: animated },
 
                             events: {
                                 dataPointSelection: function(event, chartContext, config) {
-                                    const onColumnClickEventName = component.get('columnChartModel.onColumnClickEventName')
-
                                     if (!onColumnClickEventName) {
                                         return
                                     }
 
                                     const { dataPointIndex } = config
-                                    const column = component.get('columnChartModel.data')[dataPointIndex]
+                                    const column = data[dataPointIndex]
                                     component.call('onColumnClick', column)
                                 },
                             }
                         },
 
-                        colors: component.get('columnChartModel.data').map(item => item.color),
+                        colors: data.map(item => item.color),
 
                         labels: {
                             style: {
-                                colors: component.get('columnChartModel.data').map(item => item.color),
+                                colors: data.map(item => item.color),
                             },
                         },
 
@@ -68,12 +65,10 @@
                             },
                         },
 
-                        dataLabels: {
+                        dataLabels: dataLabels,
-                            enabled: false,
-                        },
 
                         xaxis: {
-                            categories: component.get('columnChartModel.data').map(item => item.title),
+                            categories: data.map(item => item.title),
                         },
 
                         yaxis: {

resources/views/livewire-line-chart.blade.php

@@ -1,5 +1,5 @@
 <div
-    class="w-full h-full"
+    style="width: 100%; height: 100%;"
     x-data="{ ...lineChart() }"
     x-init="drawChart(@this)"
 >
@@ -15,51 +15,61 @@
                         this.chart.destroy()
                     }
 
+                    const title = component.get('lineChartModel.title');
+                    const animated = component.get('lineChartModel.animated') || false;
+                    const dataLabels = component.get('lineChartModel.dataLabels') || {};
+                    const data = component.get('lineChartModel.data');
+                    const onPointClickEventName = component.get('lineChartModel.onPointClickEventName');
+                    const sparkline = component.get('lineChartModel.sparkline');
+
+                    const series = [{
+                        name: title,
+                        data: data.map(item => item.value),
+                    }]
+
+                    const categories = component.get('lineChartModel.xAxis.categories').length > 0
+                        ? component.get('lineChartModel.xAxis.categories')
+                        : data.map(item => item.title)
+
                     const options = {
-                        series: [{
+                        series: series,
-                            name: component.get('lineChartModel.title'),
-                            data: component.get('lineChartModel.data').map(item => item.value),
-                        }],
 
                         chart: {
                             type: 'line',
                             height: '100%',
-                            zoom: {
+
-                                enabled: false
+                            ...sparkline,
-                            },
+
-                            toolbar: {
+                            zoom: { enabled: false },
-                                show: false
+
-                            },
+                            toolbar: { show: false },
-                            animations: {
+
-                                enabled: component.get('lineChartModel.animated') || false,
+                            animations: { enabled: animated },
-                            },
+
                             events: {
                                 markerClick: function(event, chartContext, { dataPointIndex }) {
-                                    const onPointClickEventName = component.get('lineChartModel.onPointClickEventName')
                                     if (!onPointClickEventName) {
                                         return
                                     }
 
-                                    const point = component.get('lineChartModel.data')[dataPointIndex]
+                                    const point = data[dataPointIndex]
                                     component.call('onPointClick', point)
                                 }
                             }
                         },
 
-                        dataLabels: {
+                        dataLabels: dataLabels,
-                            enabled: false
-                        },
 
                         stroke: component.get('lineChartModel.stroke') || {},
 
                         title: {
-                            text: component.get('lineChartModel.title'),
+                            text: title,
                             align: 'center'
                         },
 
                         xaxis: {
-                            ...component.get('lineChartModel.xAxis') || {},
+                            labels: component.get('lineChartModel.xAxis.labels'),
-                            categories: component.get('lineChartModel.data').map(item => item.title),
+                            categories: categories,
                         },
 
                         yaxis: component.get('lineChartModel.yAxis') || {},

resources/views/livewire-multi-column-chart.blade.php

@@ -0,0 +1,95 @@
+<div
+    style="width: 100%; height: 100%;"
+    x-data="{ ...multiColumnChart() }"
+    x-init="drawChart(@this)"
+>
+    <div wire:ignore x-ref="container"></div>
+
+    <script>
+        function multiColumnChart() {
+            return {
+                chart: null,
+
+                drawChart(component) {
+                    if (this.chart) {
+                        this.chart.destroy()
+                    }
+
+                    const stacked = component.get('columnChartModel.isStacked');
+                    const animated = component.get('columnChartModel.animated');
+                    const onColumnClickEventName = component.get('columnChartModel.onColumnClickEventName')
+                    const dataLabels = component.get('columnChartModel.dataLabels');
+                    const data = component.get('columnChartModel.data');
+                    const sparkline = component.get('columnChartModel.sparkline');
+
+                    const series = Object.keys(data)
+                        .map(seriesName => ({
+                            name: seriesName,
+                            data: data[seriesName].map(item => item.value)
+                        }))
+
+                    const categories = component.get('columnChartModel.xAxis.categories').length > 0
+                        ? component.get('columnChartModel.xAxis.categories')
+                        : data[series[0].name].map(item => item.title)
+                    ;
+
+                    const options = {
+                        series: series,
+
+                        chart: {
+                            type: 'bar',
+                            height: '100%',
+                            stacked: stacked,
+
+                            ...sparkline,
+
+                            toolbar: { show: false },
+
+                            animations: { enabled: animated },
+
+                            events: {
+                                dataPointSelection: function(event, chartContext, {seriesIndex, dataPointIndex}) {
+                                    if (!onColumnClickEventName) {
+                                        return
+                                    }
+
+                                    const column = data[series[seriesIndex].name][dataPointIndex]
+                                    component.call('onColumnClick', column)
+                                },
+                            }
+                        },
+
+                        legend: component.get('columnChartModel.legend'),
+
+                        plotOptions: {
+                            bar: {
+                                horizontal: false,
+                                columnWidth: '50%',
+                            },
+                        },
+
+                        dataLabels: dataLabels,
+
+                        xaxis: {
+                            categories: categories,
+                        },
+
+                        yaxis: {
+                            title: {
+                                text: component.get('columnChartModel.title'),
+                            }
+                        },
+
+                        fill: {
+                            opacity: component.get('columnChartModel.opacity'),
+                        },
+                    };
+
+                    this.chart = new ApexCharts(this.$refs.container, options);
+                    this.chart.render();
+                }
+            }
+        }
+    </script>
+</div>
+

resources/views/livewire-multi-line-chart.blade.php

@@ -0,0 +1,87 @@
+<div
+    style="width: 100%; height: 100%;"
+    x-data="{ ...multiLineChart() }"
+    x-init="drawChart(@this)"
+>
+    <div wire:ignore x-ref="container"></div>
+
+    <script>
+        function multiLineChart() {
+            return {
+                chart: null,
+
+                drawChart(component) {
+                    if (this.chart) {
+                        this.chart.destroy()
+                    }
+
+                    const title = component.get('lineChartModel.title');
+                    const animated = component.get('lineChartModel.animated') || false;
+                    const dataLabels = component.get('lineChartModel.dataLabels') || {};
+                    const data = component.get('lineChartModel.data');
+                    const onPointClickEventName = component.get('lineChartModel.onPointClickEventName');
+                    const sparkline = component.get('lineChartModel.sparkline');
+
+                    const series = Object.keys(data).map(key => {
+                        return {
+                            name: key,
+                            data: data[key].map(item => item.value),
+                        }
+                    })
+
+                    const categories = component.get('lineChartModel.xAxis.categories').length > 0
+                        ? component.get('lineChartModel.xAxis.categories')
+                        : data[series[0].name].map(item => item.title)
+
+                    const options = {
+                        series: series,
+
+                        chart: {
+                            type: 'line',
+                            height: '100%',
+
+                            ...sparkline,
+
+                            zoom: { enabled: false },
+
+                            toolbar: { show: false },
+
+                            animations: { enabled: animated },
+
+                            events: {
+                                markerClick: function(event, chartContext, { seriesIndex, dataPointIndex }) {
+                                    if (!onPointClickEventName) {
+                                        return
+                                    }
+
+                                    const point = data[series[seriesIndex].name][dataPointIndex]
+                                    component.call('onPointClick', point)
+                                }
+                            }
+                        },
+
+                        dataLabels: dataLabels,
+
+                        stroke: component.get('lineChartModel.stroke') || {},
+
+                        title: {
+                            text: title,
+                            align: 'center'
+                        },
+
+                        xaxis: {
+                            labels: component.get('lineChartModel.xAxis.labels'),
+                            categories: categories,
+                        },
+
+                        yaxis: component.get('lineChartModel.yAxis') || {},
+                    };
+
+                    this.chart = new ApexCharts(this.$refs.container, options);
+                    this.chart.render();
+                }
+            }
+        }
+    </script>
+</div>
+

resources/views/livewire-pie-chart.blade.php

@@ -1,5 +1,5 @@
 <div
-    class="w-full h-full"
+    style="width: 100%; height: 100%;"
     x-data="{ ...pieChart() }"
     x-init="drawChart(@this)"
 >
@@ -15,46 +15,49 @@
                         this.chart.destroy()
                     }
 
+                    const title = component.get('pieChartModel.title');
+                    const animated = component.get('pieChartModel.animated') || false
+                    const dataLabels = component.get('pieChartModel.dataLabels') || {}
+                    const onSliceClickEventName = component.get('pieChartModel.onSliceClickEventName')
+                    const data = component.get('pieChartModel.data')
+                    const sparkline = component.get('pieChartModel.sparkline')
+
                     const options = {
-                        series: component.get('pieChartModel.data').map(item => item.value),
+                        series: data.map(item => item.value),
 
                         chart: {
                             height: '100%',
                             type: 'pie',
 
-                            animations: {
+                            ...sparkline,
-                                enabled: component.get('pieChartModel.animated') || false,
+
-                            },
+                            animations: { enabled: animated },
 
                             events: {
                                 dataPointSelection: function(event, chartContext, config) {
-                                    const onSliceClickEventName = component.get('pieChartModel.onSliceClickEventName')
-
                                     if (!onSliceClickEventName) {
                                         return
                                     }
 
                                     const { dataPointIndex } = config
-                                    const slice = component.get('pieChartModel.data')[dataPointIndex]
+                                    const slice = data[dataPointIndex]
                                     component.call('onSliceClick', slice)
                                 },
                             }
                         },
 
-                        labels: component.get('pieChartModel.data').map(item => item.title),
+                        labels: data.map(item => item.title),
 
-                        dataLabels: {
+                        dataLabels: dataLabels,
-                            enabled: false,
-                        },
 
-                        colors: component.get('pieChartModel.data').map(item => item.color),
+                        colors: data.map(item => item.color),
 
                         fill: {
                             opacity: component.get('pieChartModel.opacity'),
                         },
 
                         title: {
-                            text: component.get('pieChartModel.title'),
+                            text: title,
                             align: 'center',
                         },
 

src/Charts/LivewireColumnChart.php

@@ -31,6 +31,10 @@ class LivewireColumnChart extends Component
 
     public function render()
     {
+        if ($this->columnChartModel['isMultiColumn']) {
+            return view('livewire-charts::livewire-multi-column-chart');
+        }
+
         return view('livewire-charts::livewire-column-chart');
     }
 }

src/Charts/LivewireLineChart.php

@@ -31,6 +31,10 @@ class LivewireLineChart extends Component
 
     public function render()
     {
+        if ($this->lineChartModel['isMultiLine']) {
+            return view('livewire-charts::livewire-multi-line-chart');
+        }
+
         return view('livewire-charts::livewire-line-chart');
     }
 }

src/Facades/LivewireCharts.php

@@ -0,0 +1,27 @@
+<?php
+
+namespace Asantibanez\LivewireCharts\Facades;
+
+use Asantibanez\LivewireCharts\Models\AreaChartModel;
+use Asantibanez\LivewireCharts\Models\ColumnChartModel;
+use Asantibanez\LivewireCharts\Models\LineChartModel;
+use Asantibanez\LivewireCharts\Models\PieChartModel;
+use Illuminate\Support\Facades\Facade;
+
+/**
+ * Class LivewireCharts
+ * @package Asantibanez\LivewireCharts\Facades
+ * @method static LineChartModel lineChartModel()
+ * @method static LineChartModel multiLineChartModel()
+ * @method static ColumnChartModel columnChartModel()
+ * @method static ColumnChartModel multiColumnChartModel()
+ * @method static AreaChartModel areaChartModel()
+ * @method static PieChartModel pieChartModel()
+ */
+class LivewireCharts extends Facade
+{
+    protected static function getFacadeAccessor()
+    {
+        return 'livewirecharts';
+    }
+}

src/LivewireCharts.php

@@ -0,0 +1,47 @@
+<?php
+
+
+namespace Asantibanez\LivewireCharts;
+
+
+use Asantibanez\LivewireCharts\Models\AreaChartModel;
+use Asantibanez\LivewireCharts\Models\ColumnChartModel;
+use Asantibanez\LivewireCharts\Models\LineChartModel;
+use Asantibanez\LivewireCharts\Models\PieChartModel;
+
+class LivewireCharts
+{
+    public function lineChartModel()
+    {
+        return (new LineChartModel)
+            ->singleLine();
+    }
+
+    public function multiLineChartModel()
+    {
+        return (new LineChartModel)
+            ->multiLine();
+    }
+
+    public function columnChartModel()
+    {
+        return (new ColumnChartModel)
+            ->singleColumn();
+    }
+
+    public function multiColumnChartModel()
+    {
+        return (new ColumnChartModel)
+            ->multiColumn();
+    }
+
+    public function areaChartModel()
+    {
+        return new AreaChartModel;
+    }
+
+    public function pieChartModel()
+    {
+        return new PieChartModel;
+    }
+}

src/LivewireChartsServiceProvider.php

@@ -35,6 +35,6 @@ class LivewireChartsServiceProvider extends ServiceProvider
      */
     public function register()
     {
-        //
+        $this->app->bind('livewirecharts', LivewireCharts::class);
     }
 }

src/Models/AreaChartModel.php

@@ -9,10 +9,6 @@ namespace Asantibanez\LivewireCharts\Models;
  */
 class AreaChartModel extends BaseChartModel
 {
-    public $title;
-
-    public $animated;
-
     public $color;
 
     public $data;
@@ -23,10 +19,6 @@ class AreaChartModel extends BaseChartModel
     {
         parent::__construct();
 
-        $this->title = '';
-
-        $this->animated = false;
-
         $this->color = '#90cdf4';
 
         $this->onPointClickEventName = null;
@@ -34,20 +26,6 @@ class AreaChartModel extends BaseChartModel
         $this->data = collect();
     }
 
-    public function setTitle($title)
-    {
-        $this->title = $title;
-
-        return $this;
-    }
-
-    public function setAnimated($animated)
-    {
-        $this->animated = $animated;
-
-        return $this;
-    }
-
     public function setColor($color)
     {
         $this->color = $color;
@@ -76,8 +54,6 @@ class AreaChartModel extends BaseChartModel
     public function toArray()
     {
         return array_merge(parent::toArray(), [
-            'title' => $this->title,
-            'animated' => $this->animated,
             'color' => $this->color,
             'onPointClickEventName' => $this->onPointClickEventName,
             'data' => $this->data->toArray(),
@@ -88,10 +64,6 @@ class AreaChartModel extends BaseChartModel
     {
         parent::fromArray($array);
 
-        $this->title = data_get($array, 'title', '');
-
-        $this->animated = data_get($array, 'animated', false);
-
         $this->color = data_get($array, 'color', '#90cdf4');
 
         $this->onPointClickEventName = data_get($array, 'onPointClickEventName', null);

src/Models/BaseChartModel.php

@@ -9,15 +9,23 @@ namespace Asantibanez\LivewireCharts\Models;
  */
 class BaseChartModel
 {
+    use HasTitle;
+    use HasAnimation;
     use HasAxis;
     use HasStroke;
     use HasLegend;
+    use HasDataLabels;
+    use HasSparkline;
 
     public function __construct()
     {
+        $this->initTitle();
+        $this->initAnimation();
         $this->initAxis();
         $this->initStroke();
         $this->initLegend();
+        $this->initDataLabels();
+        $this->initSparkline();
     }
 
     public function reactiveKey()
@@ -28,16 +36,24 @@ class BaseChartModel
     public function toArray()
     {
         return array_merge(
+            $this->titleToArray(),
+            $this->animationToArray(),
             $this->axisToArray(),
             $this->strokeToArray(),
-            $this->legendToArray()
+            $this->legendToArray(),
+            $this->dataLabelsToArray(),
+            $this->sparklineToArray()
         );
     }
 
     public function fromArray($array)
     {
+        $this->titleFromArray($array);
+        $this->animationFromArray($array);
         $this->axisFromArray($array);
         $this->strokeFromArray($array);
         $this->legendFromArray($array);
+        $this->dataLabelsFromArray($array);
+        $this->sparklineFromArray($array);
     }
 }

src/Models/ColumnChartModel.php

@@ -6,15 +6,17 @@ namespace Asantibanez\LivewireCharts\Models;
 /**
  * Class ColumnChartModel
  * @package Asantibanez\LivewireCharts\Models
+ * @property boolean $isMultiColumn
+ * @property boolean $isStacked
  */
 class ColumnChartModel extends BaseChartModel
 {
-    public $title;
-
-    public $animated;
-
     public $opacity;
 
+    public $isMultiColumn;
+
+    public $isStacked;
+
     public $onColumnClickEventName;
 
     public $data;
@@ -23,27 +25,34 @@ class ColumnChartModel extends BaseChartModel
     {
         parent::__construct();
 
-        $this->title = '';
-
-        $this->animated = false;
-
         $this->onColumnClickEventName = null;
 
         $this->opacity = 0.5;
 
+        $this->isMultiColumn = false;
+
+        $this->isStacked = false;
+
         $this->data = collect();
     }
 
-    public function setTitle($title)
+    public function multiColumn()
     {
-        $this->title = $title;
+        $this->isMultiColumn = true;
 
         return $this;
     }
 
-    public function setAnimated($animated)
+    public function singleColumn()
     {
-        $this->animated = $animated;
+        $this->isMultiColumn = false;
+
+        return $this;
+    }
+
+    public function stacked()
+    {
+        $this->isStacked = true;
 
         return $this;
     }
@@ -74,13 +83,29 @@ class ColumnChartModel extends BaseChartModel
         return $this;
     }
 
+    public function addSeriesColumn($seriesName, $title, $value, $extras = [])
+    {
+        $series = $this->data->get($seriesName, collect());
+
+        $series->push([
+            'seriesName' => $seriesName,
+            'title' => $title,
+            'value' => $value,
+            'extras' => $extras,
+        ]);
+
+        $this->data->put($seriesName, $series);
+
+        return $this;
+    }
+
     public function toArray()
     {
         return array_merge(parent::toArray(), [
-            'title' => $this->title,
-            'animated' => $this->animated,
             'onColumnClickEventName' => $this->onColumnClickEventName,
             'opacity' => $this->opacity,
+            'isMultiColumn' => $this->isMultiColumn,
+            'isStacked' => $this->isStacked,
             'data' => $this->data->toArray(),
         ]);
     }
@@ -89,14 +114,14 @@ class ColumnChartModel extends BaseChartModel
     {
         parent::fromArray($array);
 
-        $this->title = data_get($array, 'title', '');
-
-        $this->animated = data_get($array, 'animated', false);
-
         $this->onColumnClickEventName = data_get($array, 'onColumnClickEventName', null);
 
         $this->opacity = data_get($array, 'opacity', 0.5);
 
+        $this->isMultiColumn = data_get($array, 'isMultiColumn', false);
+
+        $this->isStacked = data_get($array, 'isStacked', false);
+
         $this->data = collect(data_get($array, 'data', []));
     }
 }

src/Models/HasAnimation.php

@@ -0,0 +1,39 @@
+<?php
+
+
+namespace Asantibanez\LivewireCharts\Models;
+
+
+trait HasAnimation
+{
+    private $animated;
+
+    public function setAnimated($animated)
+    {
+        $this->animated = $animated;
+
+        return $this;
+    }
+
+    protected function initAnimation()
+    {
+        $this->animated = $this->defaultAnimated();
+    }
+
+    private function defaultAnimated()
+    {
+        return false;
+    }
+
+    protected function animationFromArray($array)
+    {
+        $this->animated = data_get($array, 'animated', $this->defaultAnimated());
+    }
+
+    protected function animationToArray()
+    {
+        return [
+            'animated' => $this->animated,
+        ];
+    }
+}

src/Models/HasAxis.php

@@ -10,7 +10,7 @@ trait HasAxis
 
     private $yAxis;
 
-    public function initAxis()
+    protected function initAxis()
     {
         $this->xAxis = $this->defaultXAxis();
         $this->yAxis = $this->defaultYAxis();
@@ -19,6 +19,7 @@ trait HasAxis
     private function defaultXAxis()
     {
         return [
+            'categories' => [],
             'labels' => [
                 'show' => true,
             ],
@@ -39,6 +40,13 @@ trait HasAxis
         return $this;
     }
 
+    public function setXAxisCategories($categories = [])
+    {
+        data_set($this->xAxis, 'categories', $categories);
+
+        return $this;
+    }
+
     public function setYAxisVisible($visible)
     {
         data_set($this->yAxis, 'show', $visible);

src/Models/HasDataLabels.php

@@ -0,0 +1,55 @@
+<?php
+
+
+namespace Asantibanez\LivewireCharts\Models;
+
+
+trait HasDataLabels
+{
+    private $dataLabels;
+
+    public function setDataLabelsEnabled($enabled)
+    {
+        data_set($this->dataLabels, 'enabled', $enabled);
+
+        return $this;
+    }
+
+    public function withDataLabels()
+    {
+        data_set($this->dataLabels, 'enabled', true);
+
+        return $this;
+    }
+
+    public function withoutDataLabels()
+    {
+        data_set($this->dataLabels, 'enabled', false);
+
+        return $this;
+    }
+
+    protected function initDataLabels()
+    {
+        $this->dataLabels = $this->defaultDataLabels();
+    }
+
+    private function defaultDataLabels()
+    {
+        return [
+            'enabled' => false,
+        ];
+    }
+
+    protected function dataLabelsFromArray($array)
+    {
+        $this->dataLabels = data_get($array, 'dataLabels', $this->defaultDataLabels());
+    }
+
+    protected function dataLabelsToArray()
+    {
+        return [
+            'dataLabels' => $this->dataLabels,
+        ];
+    }
+}

src/Models/HasSparkline.php

@@ -0,0 +1,48 @@
+<?php
+
+
+namespace Asantibanez\LivewireCharts\Models;
+
+
+trait HasSparkline
+{
+    private $sparkline;
+
+    public function setSparklineEnabled($isEnabled)
+    {
+        data_set($this->sparkline, 'sparkline.enabled', $isEnabled);
+
+        return $this;
+    }
+
+    public function sparklined()
+    {
+        return $this->setSparklineEnabled(true);
+    }
+
+    protected function initSparkline()
+    {
+        $this->sparkline = $this->defaultSparkline();
+    }
+
+    private function defaultSparkline()
+    {
+        return [
+            'sparkline' => [
+                'enabled' => false,
+            ],
+        ];
+    }
+
+    protected function sparklineFromArray($array)
+    {
+        $this->sparkline = data_get($array, 'sparkline', $this->defaultSparkline());
+    }
+
+    protected function sparklineToArray()
+    {
+        return [
+            'sparkline' => $this->sparkline,
+        ];
+    }
+}

src/Models/HasTitle.php

@@ -0,0 +1,39 @@
+<?php
+
+
+namespace Asantibanez\LivewireCharts\Models;
+
+
+trait HasTitle
+{
+    private $title;
+
+    public function setTitle($title)
+    {
+        $this->title = $title;
+
+        return $this;
+    }
+
+    protected function initTitle()
+    {
+        $this->title = $this->defaultTitle();
+    }
+
+    private function defaultTitle()
+    {
+        return '';
+    }
+
+    protected function titleFromArray($array)
+    {
+        $this->title = data_get($array, 'title', $this->defaultTitle());
+    }
+
+    protected function titleToArray()
+    {
+        return [
+            'title' => $this->title,
+        ];
+    }
+}

src/Models/LineChartModel.php

@@ -3,15 +3,16 @@
 
 namespace Asantibanez\LivewireCharts\Models;
 
+use Illuminate\Support\Collection;
+
 /**
  * Class LineChartModel
  * @package Asantibanez\LivewireCharts\Models
+ * @property boolean $isMultiLine
  */
 class LineChartModel extends BaseChartModel
 {
-    public $title;
+    public $isMultiLine;
-
-    public $animated;
 
     public $data;
 
@@ -23,9 +24,7 @@ class LineChartModel extends BaseChartModel
     {
         parent::__construct();
 
-        $this->title = '';
+        $this->isMultiLine = false;
-
-        $this->animated = false;
 
         $this->onPointClickEventName = null;
 
@@ -34,16 +33,20 @@ class LineChartModel extends BaseChartModel
         $this->markers = collect();
     }
 
-    public function setTitle($title)
+    public function multiLine()
     {
-        $this->title = $title;
+        $this->isMultiLine = true;
+
+        $this->data = collect();
 
         return $this;
     }
 
-    public function setAnimated($animated)
+    public function singleLine()
     {
-        $this->animated = $animated;
+        $this->isMultiLine = false;
+
+        $this->data = collect();
 
         return $this;
     }
@@ -59,6 +62,22 @@ class LineChartModel extends BaseChartModel
         return $this;
     }
 
+    public function addSeriesPoint($seriesName, $title, $value, $extras = [])
+    {
+        $series = $this->data->get($seriesName, collect());
+
+        $series->push([
+            'seriesName' => $seriesName,
+            'title' => $title,
+            'value' => $value,
+            'extras' => $extras,
+        ]);
+
+        $this->data->put($seriesName, $series);
+
+        return $this;
+    }
+
     public function addMarker($title,
                               $value,
                               $strokeColor = 'green',
@@ -88,8 +107,7 @@ class LineChartModel extends BaseChartModel
     public function toArray()
     {
         return array_merge(parent::toArray(), [
-            'title' => $this->title,
+            'isMultiLine' => $this->isMultiLine,
-            'animated' => $this->animated,
             'onPointClickEventName' => $this->onPointClickEventName,
             'data' => $this->data->toArray(),
             'markers' => $this->markers->toArray(),
@@ -100,9 +118,7 @@ class LineChartModel extends BaseChartModel
     {
         parent::fromArray($array);
 
-        $this->title = data_get($array, 'title', '');
+        $this->isMultiLine = data_get($array, 'isMultiLine', false);
-
-        $this->animated = data_get($array, 'animated', false);
 
         $this->onPointClickEventName = data_get($array, 'onPointClickEventName', null);
 

src/Models/PieChartModel.php

@@ -9,10 +9,6 @@ namespace Asantibanez\LivewireCharts\Models;
  */
 class PieChartModel extends BaseChartModel
 {
-    public $title;
-
-    public $animated;
-
     public $onSliceClickEventName;
 
     public $opacity;
@@ -23,10 +19,6 @@ class PieChartModel extends BaseChartModel
     {
         parent::__construct();
 
-        $this->title = '';
-
-        $this->animated = false;
-
         $this->onSliceClickEventName = null;
 
         $this->opacity = 0.75;
@@ -34,20 +26,6 @@ class PieChartModel extends BaseChartModel
         $this->data = collect();
     }
 
-    public function setTitle($title)
-    {
-        $this->title = $title;
-
-        return $this;
-    }
-
-    public function setAnimated($animated)
-    {
-        $this->animated = $animated;
-
-        return $this;
-    }
-
     public function setOpacity($opacity)
     {
         $this->opacity = $opacity;
@@ -77,8 +55,6 @@ class PieChartModel extends BaseChartModel
     public function toArray()
     {
         return array_merge(parent::toArray(), [
-            'title' => $this->title,
-            'animated' => $this->animated,
             'onSliceClickEventName' => $this->onSliceClickEventName,
             'opacity' => $this->opacity,
             'data' => $this->data->toArray(),
@@ -89,10 +65,6 @@ class PieChartModel extends BaseChartModel
     {
         parent::fromArray($array);
 
-        $this->title = data_get($array, 'title', '');
-
-        $this->animated = data_get($array, 'animated', false);
-
         $this->onSliceClickEventName = data_get($array, 'onSliceClickEventName', null);
 
         $this->opacity = data_get($array, 'opacity', 0.75);