Add JSDoc documentation and file headers to all source files

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

src/views/Discover/Performance/FreqChart.vue

@@ -3,6 +3,17 @@
 </template>
 
 <script setup>
+// The Lucia project.
+// Copyright 2024-2026 DSP, inc.  All rights reserved.
+// Authors:
+//   cindy.chang@dsp.im (Cindy Chang), 2024/5/30
+//   imacat.yang@dsp.im (imacat), 2023/9/23
+/**
+ * @module views/Discover/Performance/FreqChart
+ *   Frequency chart component displaying activity
+ *   occurrence data with Chart.js bar charts.
+ */
+
 import { ref, onMounted } from 'vue';
 import {
   setTimeStringFormatBaseOnTimeDifference,
@@ -126,8 +137,8 @@ const customizeScaleChartOptionTicks = (scaleObjectToAlter, ticksOfXAxis) => {
 };
 
 /** Compare page and Performance have this same function.
- * 在一個基本的物件上加以客製化這個物件，客製化的參照來源是 content 的內容
- * 之所以有辦法這樣撰寫，是因為我們知道物件的順序是先 x 再 title 再 text
+ * Customizes a base tooltip object using the content data.
+ * The object order is known to be: x, then title, then text.
  * This function alters the title property of known scales object of Chart option
  * This is based on the fact that we know the order must be x -> title -> text.
  * @param {object} whichScaleObj PrimeVue scale option object to reference to
@@ -160,6 +171,12 @@ const customizeScaleChartOptionTitleByContent = (whichScaleObj, content) => {
     };
 };
 
+/**
+ * Builds the PrimeVue line chart data and options configuration.
+ * @param {object} chartData - The chart data from the API.
+ * @param {object} content - The axis label content.
+ * @param {string} pageName - 'Compare' or page identifier.
+ */
 const getLineChartPrimeVueSetting = (chartData, content, pageName) => {
   let datasetsArr;
   let datasets;