Charts (#88)

* Charts * Version bump * Update pnpm-lock.yaml
modrinth · Aug 21, 2023 · e1f4d79 · e1f4d79
1 parent 27172c2
commit e1f4d79
Show file tree

Hide file tree

Showing 7 changed files with 359 additions and 1 deletion.
diff --git a/docs/.vitepress/config.js b/docs/.vitepress/config.js
@@ -45,6 +45,7 @@ export default {
           { text: 'Copy Code', link: '/components/copy-code' },
           { text: 'Notifications', link: '/components/notifications' },
           { text: 'Share Modal', link: '/components/share-modal' },
+          { text: 'Analytics', link: '/components/analytics' },
         ],
       },
     ],

diff --git a/docs/components/analytics.md b/docs/components/analytics.md
@@ -0,0 +1,108 @@
+# Analytics
+
+<DemoContainer>
+    <LineChart 
+        :data="{
+          labels: [
+            '2021-01-01', '2021-01-02', '2021-01-03', '2021-01-04', '2021-01-05',
+            '2021-01-06', '2021-01-07', '2021-01-08', '2021-01-09', '2021-01-10',
+            '2021-01-11', '2021-01-12', '2021-01-13', '2021-01-14', '2021-01-15',
+            '2021-01-16', '2021-01-17'
+          ],
+          data: [
+            {
+              title: 'Spirit',
+              color: 16711680,
+              data: [120, 130, 140, 150, 160, 170, 180, 190, 200, 210, 220, 230, 240, 250, 260, 270, 280],
+            },
+            {
+              title: 'Ad Astra',
+              color: 65280,
+              data: [150, 155, 160, 165, 170, 175, 180, 185, 190, 195, 200, 205, 210, 215, 220, 225, 230],
+            },
+            {
+              title: 'Tempad',
+              color: 255,
+              data: [180, 182, 184, 186, 188, 190, 192, 194, 196, 198, 200, 202, 204, 206, 208, 210, 212],
+            },
+          ]
+        }"
+    />
+    <PieChart
+        :data="{
+            title: 'Downloads',
+            data: [
+                {
+                    title: 'Spirit',
+                    color: 16711680, // Red in decimal (equivalent to #FF0000 in hexadecimal)
+                    data: 120, // Example download numbers for the three dates
+                },
+                {
+                    title: 'Ad Astra',
+                    color: 65280, // Green in decimal (equivalent to #00FF00 in hexadecimal)
+                    data: 150, // Example download numbers for the three dates
+                },
+                {
+                    title: 'Tempad',
+                    color: 255, // Blue in decimal (equivalent to #0000FF in hexadecimal)
+                    data: 180, // Example download numbers for the three dates
+                },
+            ],    
+        }"
+    />
+</DemoContainer>
+
+```vue
+<LineChart 
+  :formatLabel="(label) => doFormattingThings(label)" 
+  :data="{
+          labels: [
+            '2021-01-01', '2021-01-02', '2021-01-03', '2021-01-04', '2021-01-05',
+            '2021-01-06', '2021-01-07', '2021-01-08', '2021-01-09', '2021-01-10',
+            '2021-01-11', '2021-01-12', '2021-01-13', '2021-01-14', '2021-01-15',
+            '2021-01-16', '2021-01-17'
+          ],
+          data: [
+            {
+              title: 'Spirit',
+              color: 16711680,
+              data: [120, 130, 140, 150, 160, 170, 180, 190, 200, 210, 220, 230, 240, 250, 260, 270, 280],
+            },
+            {
+              title: 'Ad Astra',
+              color: 65280,
+              data: [150, 155, 160, 165, 170, 175, 180, 185, 190, 195, 200, 205, 210, 215, 220, 225, 230],
+            },
+            {
+              title: 'Tempad',
+              color: 255,
+              data: [180, 182, 184, 186, 188, 190, 192, 194, 196, 198, 200, 202, 204, 206, 208, 210, 212],
+            },
+          ]
+        }"
+/>
+```
+```vue
+<PieChart
+  :data="{
+            title: 'Downloads',
+            data: [
+                {
+                    title: 'Spirit',
+                    color: 16711680, // Red in decimal (equivalent to #FF0000 in hexadecimal)
+                    data: 120, // Example download numbers for the three dates
+                },
+                {
+                    title: 'Ad Astra',
+                    color: 65280, // Green in decimal (equivalent to #00FF00 in hexadecimal)
+                    data: 150, // Example download numbers for the three dates
+                },
+                {
+                    title: 'Tempad',
+                    color: 255, // Blue in decimal (equivalent to #0000FF in hexadecimal)
+                    data: 180, // Example download numbers for the three dates
+                },
+            ],    
+        }"
+/>
+```
diff --git a/lib/components/base/LineChart.vue b/lib/components/base/LineChart.vue
@@ -0,0 +1,125 @@
+<template>
+  <Line :options="chartOptions" :data="chartData" />
+</template>
+
+<script setup>
+import { ref } from 'vue'
+import { Line } from 'vue-chartjs'
+import {
+  Chart as ChartJS,
+  Title,
+  Tooltip,
+  PointElement,
+  LineElement,
+  CategoryScale,
+  LinearScale,
+  Filler,
+} from 'chart.js'
+import dayjs from 'dayjs'
+
+ChartJS.register(Title, Tooltip, PointElement, LineElement, CategoryScale, LinearScale, Filler)
+
+const props = defineProps({
+  data: {
+    type: Object,
+    required: true,
+  },
+  formatLabels: {
+    type: Function,
+    default: (label) => dayjs(label).format('MMM D'),
+  },
+})
+
+const decimalToRgba = (decimalColor, alpha = 0.75) => {
+  const red = (decimalColor >> 16) & 255
+  const green = (decimalColor >> 8) & 255
+  const blue = decimalColor & 255
+
+  return `rgba(${red}, ${green}, ${blue}, ${alpha})`
+}
+
+const chartData = ref({
+  labels: props.data.labels.map((date) => props.formatLabels(date)),
+  datasets: props.data.data.map((project) => ({
+    label: project.title,
+    backgroundColor: decimalToRgba(project.color, 0.75),
+    borderColor: decimalToRgba(project.color),
+    data: project.data,
+  })),
+})
+
+const chartOptions = ref({
+  responsive: true,
+  scales: {
+    x: {
+      grid: {
+        color: getComputedStyle(document.documentElement).getPropertyValue('--color-button-bg'),
+      },
+      ticks: {
+        color: getComputedStyle(document.documentElement).getPropertyValue('--color-base'),
+      },
+    },
+    y: {
+      grid: {
+        color: getComputedStyle(document.documentElement).getPropertyValue('--color-button-bg'),
+      },
+      ticks: {
+        color: getComputedStyle(document.documentElement).getPropertyValue('--color-base'),
+      },
+    },
+  },
+  interaction: {
+    mode: 'x',
+  },
+  plugins: {
+    legend: {
+      position: 'right',
+      align: 'start',
+      labels: {
+        color: getComputedStyle(document.documentElement).getPropertyValue('--color-base'),
+        font: {
+          size: 12,
+          family: 'Inter',
+        },
+      },
+    },
+    tooltip: {
+      position: 'nearest',
+      backgroundColor: getComputedStyle(document.documentElement).getPropertyValue(
+        '--color-raised-bg'
+      ),
+      borderColor: getComputedStyle(document.documentElement).getPropertyValue('--color-button-bg'),
+      borderWidth: 1,
+      titleColor: getComputedStyle(document.documentElement).getPropertyValue('--color-contrast'),
+      titleFont: {
+        size: 14,
+        family: 'Inter',
+      },
+      bodyColor: getComputedStyle(document.documentElement).getPropertyValue('--color-base'),
+      bodyFont: {
+        size: 12,
+        family: 'Inter',
+      },
+      boxPadding: 8,
+      intersect: false,
+      padding: 12,
+    },
+  },
+})
+
+/*
+The data for the graph should look like this
+
+downloads, views, likes = {
+  dates: [ '2021-01-01', '2021-01-02', '2021-01-03' ], // Last 2 weeks
+  data: [
+    {
+      title: projectName,
+      color: projectColor,
+      data: [ ... ],
+    },
+    ...
+  ]
+}
+ */
+</script>
diff --git a/lib/components/base/PieChart.vue b/lib/components/base/PieChart.vue
@@ -0,0 +1,93 @@
+<script setup>
+import { ref } from 'vue'
+import { Pie } from 'vue-chartjs'
+import {
+  Chart as ChartJS,
+  Title,
+  Tooltip,
+  PieController,
+  ArcElement,
+  Legend,
+  CategoryScale,
+  LinearScale,
+} from 'chart.js'
+
+ChartJS.register(Title, Tooltip, PieController, ArcElement, Legend, CategoryScale, LinearScale)
+
+const props = defineProps({
+  data: {
+    type: Object,
+    required: true,
+  },
+})
+
+const decimalToRgba = (decimalColor, alpha = 0.75) => {
+  const red = (decimalColor >> 16) & 255
+  const green = (decimalColor >> 8) & 255
+  const blue = decimalColor & 255
+
+  return `rgba(${red}, ${green}, ${blue}, ${alpha})`
+}
+
+const chartData = ref({
+  labels: props.data.data.map((project) => project.title),
+  datasets: [
+    {
+      label: props.data.title,
+      backgroundColor: props.data.data.map((project) => decimalToRgba(project.color)),
+      borderColor: getComputedStyle(document.documentElement).getPropertyValue('--color-button-bg'),
+      data: props.data.data.map((project) => project.data),
+      fill: true,
+    },
+  ],
+})
+
+const chartOptions = ref({
+  responsive: true,
+  elements: {
+    point: {
+      radius: 0,
+    },
+  },
+  plugins: {
+    legend: {
+      position: 'right',
+      labels: {
+        color: getComputedStyle(document.documentElement).getPropertyValue('--color-base'),
+        font: {
+          size: 12,
+          family: 'Inter',
+        },
+      },
+    },
+    tooltip: {
+      position: 'nearest',
+      backgroundColor: getComputedStyle(document.documentElement).getPropertyValue(
+        '--color-raised-bg'
+      ),
+      borderColor: getComputedStyle(document.documentElement).getPropertyValue('--color-button-bg'),
+      borderWidth: 1,
+      titleColor: getComputedStyle(document.documentElement).getPropertyValue('--color-contrast'),
+      titleFont: {
+        size: 16,
+        family: 'Inter',
+      },
+      bodyColor: getComputedStyle(document.documentElement).getPropertyValue('--color-base'),
+      bodyFont: {
+        size: 12,
+        family: 'Inter',
+      },
+      boxPadding: 8,
+      intersect: false,
+      padding: 12,
+      displayColors: false,
+    },
+  },
+})
+</script>
+
+<template>
+  <Pie :options="chartOptions" :data="chartData" />
+</template>
+
+<style scoped lang="scss"></style>
diff --git a/lib/components/index.js b/lib/components/index.js
@@ -24,6 +24,8 @@ export { default as ModalConfirm } from './base/ModalConfirm.vue'
 export { default as Breadcrumbs } from './base/Breadcrumbs.vue'
 export { default as DropdownButton } from './base/DropdownButton.vue'
 export { default as ShareModal } from './base/ShareModal.vue'
+export { default as LineChart } from './base/LineChart.vue'
+export { default as PieChart } from './base/PieChart.vue'
 
 export { default as Categories } from './search/Categories.vue'
 export { default as SearchFilter } from './search/SearchFilter.vue'

diff --git a/package.json b/package.json
@@ -1,7 +1,7 @@
 {
   "name": "omorphia",
   "type": "module",
-  "version": "0.4.38",
+  "version": "0.4.39",
   "files": [
     "dist",
     "lib"
@@ -25,12 +25,14 @@
     "docs:preview": "vitepress preview docs"
   },
   "dependencies": {
+    "chart.js": "^4.3.3",
     "dayjs": "^1.11.7",
     "floating-vue": "^2.0.0-beta.20",
     "highlight.js": "^11.8.0",
     "markdown-it": "^13.0.1",
     "qrcode.vue": "^3.4.0",
     "vue": "^3.3.4",
+    "vue-chartjs": "^5.2.0",
     "vue-router": "^4.2.1",
     "vue-select": "^4.0.0-beta.6",
     "xss": "^1.0.14"