Rework selected core APIs (WIP)

Co-authored-by: Patryk Goworowski <[email protected]>
patrykandpatrick · Nov 30, 2023 · fe23983 · fe23983
1 parent b72630e
commit fe23983
Show file tree

Hide file tree

Showing 139 changed files with 3,522 additions and 4,674 deletions.
diff --git a/sample/src/main/java/com/patrykandpatrick/vico/sample/previews/AxisLinePreviews.kt b/sample/src/main/java/com/patrykandpatrick/vico/sample/previews/AxisLinePreviews.kt
@@ -25,20 +25,22 @@ import com.patrykandpatrick.vico.compose.axis.axisLabelComponent
 import com.patrykandpatrick.vico.compose.axis.horizontal.rememberBottomAxis
 import com.patrykandpatrick.vico.compose.axis.vertical.rememberEndAxis
 import com.patrykandpatrick.vico.compose.axis.vertical.rememberStartAxis
-import com.patrykandpatrick.vico.compose.chart.Chart
-import com.patrykandpatrick.vico.compose.chart.column.columnChart
+import com.patrykandpatrick.vico.compose.chart.CartesianChartHost
+import com.patrykandpatrick.vico.compose.chart.column.rememberColumnCartesianLayer
+import com.patrykandpatrick.vico.compose.chart.rememberCartesianChart
 import com.patrykandpatrick.vico.compose.component.lineComponent
 import com.patrykandpatrick.vico.compose.component.shapeComponent
 import com.patrykandpatrick.vico.compose.style.LocalChartStyle
 import com.patrykandpatrick.vico.core.axis.vertical.VerticalAxis
+import com.patrykandpatrick.vico.core.chart.CartesianChartModel
+import com.patrykandpatrick.vico.core.chart.column.ColumnCartesianLayerModel
 import com.patrykandpatrick.vico.core.component.shape.Shapes
 import com.patrykandpatrick.vico.core.component.shape.cornered.Corner
 import com.patrykandpatrick.vico.core.component.shape.cornered.CorneredShape
 import com.patrykandpatrick.vico.core.component.shape.cornered.CutCornerTreatment
 import com.patrykandpatrick.vico.core.component.shape.cornered.RoundedCornerTreatment
-import com.patrykandpatrick.vico.core.entry.entryModelOf
 
-private val model = entryModelOf(1, 2, 3, 4)
+private val model = CartesianChartModel(ColumnCartesianLayerModel.build { series(1, 2, 3, 4) })
 
 @Composable
 private fun ProvidePreviewChartStyle(content: @Composable () -> Unit) {
@@ -50,10 +52,10 @@ private fun ProvidePreviewChartStyle(content: @Composable () -> Unit) {
                     axisLineColor = Color.Black.copy(alpha = 0.5f),
                     axisGuidelineColor = Color.Black.copy(alpha = 0.2f)
                 ),
-            columnChart =
-                LocalChartStyle.current.columnChart.copy(
+            columnLayer =
+                LocalChartStyle.current.columnLayer.copy(
                     columns =
-                        LocalChartStyle.current.columnChart.columns.map {
+                        LocalChartStyle.current.columnLayer.columns.map {
                             lineComponent(
                                 color = Color.Gray,
                                 thickness = it.thicknessDp.dp,
@@ -97,8 +99,8 @@ public fun HorizontalAxisTextInside() {
                 verticalMargin = 4.dp,
                 horizontalMargin = 4.dp
             )
-        Chart(
-            chart = columnChart(),
+        CartesianChartHost(
+            chart = rememberCartesianChart(rememberColumnCartesianLayer()),
             model = model,
             startAxis =
                 rememberStartAxis(
@@ -127,8 +129,8 @@ public fun HorizontalAxisTextInsideAndBottomAxis() {
                 verticalMargin = 4.dp,
                 horizontalMargin = 4.dp
             )
-        Chart(
-            chart = columnChart(),
+        CartesianChartHost(
+            chart = rememberCartesianChart(rememberColumnCartesianLayer()),
             model = model,
             startAxis =
                 rememberStartAxis(
@@ -150,8 +152,8 @@ public fun HorizontalAxisTextInsideAndBottomAxis() {
 @Preview(showBackground = true, widthDp = 250)
 public fun HorizontalAxisTextOutside() {
     ProvidePreviewChartStyle {
-        Chart(
-            chart = columnChart(),
+        CartesianChartHost(
+            chart = rememberCartesianChart(rememberColumnCartesianLayer()),
             model = model,
             startAxis =
                 rememberStartAxis(
@@ -170,8 +172,8 @@ public fun HorizontalAxisTextOutside() {
 @Preview(showBackground = true, widthDp = 250)
 public fun HorizontalAxisGuidelineDoesNotOverlayBottomAxisLine() {
     ProvidePreviewChartStyle {
-        Chart(
-            chart = columnChart(),
+        CartesianChartHost(
+            chart = rememberCartesianChart(rememberColumnCartesianLayer()),
             model = model,
             startAxis =
                 rememberStartAxis(

diff --git a/.../java/com/patrykandpatrick/vico/sample/previews/ColumnChartsWithNegativeValuesPreviews.kt b/.../java/com/patrykandpatrick/vico/sample/previews/ColumnChartsWithNegativeValuesPreviews.kt
@@ -25,24 +25,31 @@ import androidx.compose.ui.tooling.preview.Preview
 import androidx.compose.ui.unit.dp
 import com.patrykandpatrick.vico.compose.axis.horizontal.rememberBottomAxis
 import com.patrykandpatrick.vico.compose.axis.vertical.rememberStartAxis
-import com.patrykandpatrick.vico.compose.chart.Chart
-import com.patrykandpatrick.vico.compose.chart.column.columnChart
+import com.patrykandpatrick.vico.compose.chart.CartesianChartHost
+import com.patrykandpatrick.vico.compose.chart.column.rememberColumnCartesianLayer
+import com.patrykandpatrick.vico.compose.chart.rememberCartesianChart
 import com.patrykandpatrick.vico.core.axis.AxisItemPlacer
-import com.patrykandpatrick.vico.core.chart.values.AxisValuesOverrider
+import com.patrykandpatrick.vico.core.chart.CartesianChartModel
+import com.patrykandpatrick.vico.core.chart.line.LineCartesianLayerModel
+import com.patrykandpatrick.vico.core.chart.values.AxisValueOverrider
 import com.patrykandpatrick.vico.core.component.text.textComponent
-import com.patrykandpatrick.vico.core.entry.entryModelOf
 import com.patrykandpatrick.vico.sample.showcase.rememberMarker
 
-private val model = entryModelOf(2f, -1f, 4f, -2f, 1f, 5f, -3f)
+private val model =
+    CartesianChartModel(LineCartesianLayerModel.build { series(2, -1, 4, -2, 1, 5, -3) })
 
 @Preview
 @Composable
 public fun SingleColumnChartWithNegativeValues() {
     val marker = rememberMarker()
     Surface {
-        Chart(
+        CartesianChartHost(
             modifier = Modifier.height(250.dp),
-            chart = columnChart(persistentMarkers = mapOf(2f to marker, 3f to marker)),
+            chart =
+                rememberCartesianChart(
+                    rememberColumnCartesianLayer(),
+                    persistentMarkers = mapOf(2f to marker, 3f to marker)
+                ),
             model = model,
             startAxis =
                 rememberStartAxis(
@@ -57,8 +64,9 @@ public fun SingleColumnChartWithNegativeValues() {
 @Composable
 public fun SingleColumnChartWithNegativeValuesAndDataLabels() {
     Surface {
-        Chart(
-            chart = columnChart(dataLabel = textComponent()),
+        CartesianChartHost(
+            chart =
+                rememberCartesianChart(rememberColumnCartesianLayer(dataLabel = textComponent())),
             model = model,
             startAxis = rememberStartAxis(),
             bottomAxis = rememberBottomAxis()
@@ -70,9 +78,13 @@ public fun SingleColumnChartWithNegativeValuesAndDataLabels() {
 @Composable
 public fun SingleColumnChartWithNegativeValuesAndAxisValuesOverridden() {
     Surface {
-        Chart(
+        CartesianChartHost(
             chart =
-                columnChart(axisValuesOverrider = AxisValuesOverrider.fixed(minY = 1f, maxY = 4f)),
+                rememberCartesianChart(
+                    rememberColumnCartesianLayer(
+                        axisValueOverrider = AxisValueOverrider.fixed(minY = 1f, maxY = 4f)
+                    )
+                ),
             model = model,
             startAxis =
                 rememberStartAxis(
@@ -87,9 +99,13 @@ public fun SingleColumnChartWithNegativeValuesAndAxisValuesOverridden() {
 @Composable
 public fun SingleColumnChartWithNegativeValuesAndAxisValuesOverridden2() {
     Surface {
-        Chart(
+        CartesianChartHost(
             chart =
-                columnChart(axisValuesOverrider = AxisValuesOverrider.fixed(minY = -2f, maxY = 0f)),
+                rememberCartesianChart(
+                    rememberColumnCartesianLayer(
+                        axisValueOverrider = AxisValueOverrider.fixed(minY = -2f, maxY = 0f)
+                    )
+                ),
             model = model,
             startAxis =
                 rememberStartAxis(

diff --git a/sample/src/main/java/com/patrykandpatrick/vico/sample/previews/ContainedChartsPreview.kt b/sample/src/main/java/com/patrykandpatrick/vico/sample/previews/ContainedChartsPreview.kt
@@ -25,60 +25,56 @@ import androidx.compose.ui.unit.dp
 import com.patrykandpatrick.vico.compose.axis.horizontal.rememberBottomAxis
 import com.patrykandpatrick.vico.compose.axis.vertical.rememberEndAxis
 import com.patrykandpatrick.vico.compose.axis.vertical.rememberStartAxis
-import com.patrykandpatrick.vico.compose.chart.Chart
-import com.patrykandpatrick.vico.compose.chart.column.columnChart
-import com.patrykandpatrick.vico.compose.chart.line.lineChart
+import com.patrykandpatrick.vico.compose.chart.CartesianChartHost
+import com.patrykandpatrick.vico.compose.chart.column.rememberColumnCartesianLayer
 import com.patrykandpatrick.vico.compose.chart.line.lineSpec
+import com.patrykandpatrick.vico.compose.chart.line.rememberLineCartesianLayer
+import com.patrykandpatrick.vico.compose.chart.rememberCartesianChart
 import com.patrykandpatrick.vico.compose.component.lineComponent
+import com.patrykandpatrick.vico.compose.component.shape.shader.color
 import com.patrykandpatrick.vico.compose.component.shape.shader.verticalGradient
 import com.patrykandpatrick.vico.compose.component.textComponent
 import com.patrykandpatrick.vico.core.axis.Axis
 import com.patrykandpatrick.vico.core.axis.AxisItemPlacer
 import com.patrykandpatrick.vico.core.axis.AxisPosition.Vertical
 import com.patrykandpatrick.vico.core.axis.AxisPosition.Vertical.End
 import com.patrykandpatrick.vico.core.axis.AxisPosition.Vertical.Start
-import com.patrykandpatrick.vico.core.chart.column.ColumnChart
-import com.patrykandpatrick.vico.core.chart.composed.plus
-import com.patrykandpatrick.vico.core.chart.line.LineChart
+import com.patrykandpatrick.vico.core.chart.CartesianChartModel
+import com.patrykandpatrick.vico.core.chart.column.ColumnCartesianLayerModel
+import com.patrykandpatrick.vico.core.chart.line.LineCartesianLayerModel
 import com.patrykandpatrick.vico.core.component.shape.Shapes
-import com.patrykandpatrick.vico.core.entry.composed.plus
-import com.patrykandpatrick.vico.core.entry.entryModelOf
+import com.patrykandpatrick.vico.core.component.shape.shader.DynamicShaders
 import com.patrykandpatrick.vico.core.marker.Marker
 import com.patrykandpatrick.vico.sample.showcase.rememberMarker
 
-private val model1 = entryModelOf(0 to 1, 1 to 2, 2 to 4, 3 to 1, 4 to 4)
-private val model2 = entryModelOf(1 to 4, 2 to 1, 3 to 8, 4 to 12, 5 to 5)
+private val model =
+    CartesianChartModel(
+        ColumnCartesianLayerModel.build { series(1, 2, 4, 1, 4) },
+        LineCartesianLayerModel.build { series(4, 1, 8, 12, 5) }
+    )
 
 private val markerMap: Map<Float, Marker>
     @Composable get() = mapOf(4f to rememberMarker())
 
 @Composable
-private fun getColumnChart(
-    markerMap: Map<Float, Marker> = emptyMap(),
-    targetVerticalAxisPosition: Vertical? = null
-): ColumnChart =
-    columnChart(
+private fun getColumnLayer(targetVerticalAxisPosition: Vertical? = null) =
+    rememberColumnCartesianLayer(
         columns =
             listOf(lineComponent(color = Color.Black, thickness = 8.dp, shape = Shapes.pillShape)),
-        persistentMarkers = markerMap,
         targetVerticalAxisPosition = targetVerticalAxisPosition
     )
 
 @Composable
-private fun getLineChart(
-    markerMap: Map<Float, Marker> = emptyMap(),
-    targetVerticalAxisPosition: Vertical? = null
-): LineChart =
-    lineChart(
+private fun getLineLayer(targetVerticalAxisPosition: Vertical? = null) =
+    rememberLineCartesianLayer(
         lines =
             listOf(
                 lineSpec(
-                    lineColor = Color.DarkGray,
-                    lineBackgroundShader =
+                    shader = DynamicShaders.color(Color.DarkGray),
+                    backgroundShader =
                         verticalGradient(arrayOf(Color.DarkGray, Color.DarkGray.copy(alpha = 0f)))
                 )
             ),
-        persistentMarkers = markerMap,
         targetVerticalAxisPosition = targetVerticalAxisPosition
     )
 
@@ -101,15 +97,9 @@ private val endAxis: Axis<End>
 @Composable
 @Preview("Chart with independent axes", widthDp = 350)
 public fun ChartWithIndependentAxes(modifier: Modifier = Modifier) {
-    val composedChart =
-        getColumnChart(targetVerticalAxisPosition = Start) +
-            getLineChart(targetVerticalAxisPosition = End)
-
-    composedChart.setPersistentMarkers(markerMap)
-
-    Chart(
-        chart = composedChart,
-        model = model1 + model2,
+    CartesianChartHost(
+        chart = rememberCartesianChart(getColumnLayer(Start), getLineLayer(End)),
+        model = model,
         startAxis = startAxis,
         bottomAxis = rememberBottomAxis(),
         endAxis = endAxis,
@@ -120,13 +110,10 @@ public fun ChartWithIndependentAxes(modifier: Modifier = Modifier) {
 @Composable
 @Preview("Chart with dependent axes", widthDp = 350)
 public fun ChartWithDependentAxes(modifier: Modifier = Modifier) {
-    val composedChart = getColumnChart() + getLineChart()
-
-    composedChart.setPersistentMarkers(markerMap)
-
-    Chart(
-        chart = composedChart,
-        model = model1 + model2,
+    CartesianChartHost(
+        chart =
+            rememberCartesianChart(getColumnLayer(), getLineLayer(), persistentMarkers = markerMap),
+        model = model,
         startAxis = startAxis,
         bottomAxis = rememberBottomAxis(),
         endAxis = endAxis,
@@ -137,9 +124,9 @@ public fun ChartWithDependentAxes(modifier: Modifier = Modifier) {
 @Composable
 @Preview("Column chart", widthDp = 350)
 public fun ColumnChart(modifier: Modifier = Modifier) {
-    Chart(
-        chart = getColumnChart(markerMap = markerMap),
-        model = model1,
+    CartesianChartHost(
+        chart = rememberCartesianChart(getColumnLayer(), persistentMarkers = markerMap),
+        model = model,
         startAxis = startAxis,
         bottomAxis = rememberBottomAxis(),
         modifier = modifier
@@ -149,9 +136,9 @@ public fun ColumnChart(modifier: Modifier = Modifier) {
 @Composable
 @Preview("Line chart", widthDp = 350)
 public fun LineChart(modifier: Modifier = Modifier) {
-    Chart(
-        chart = getLineChart(markerMap = markerMap),
-        model = model2,
+    CartesianChartHost(
+        chart = rememberCartesianChart(getLineLayer(), persistentMarkers = markerMap),
+        model = model,
         startAxis = startAxis,
         bottomAxis = rememberBottomAxis(),
         modifier = modifier