Add JSDoc documentation and file headers to all source files

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

src/components/Compare/SidebarStates.vue

@@ -147,6 +147,17 @@
   </Sidebar>
 </template>
 <script setup>
+// The Lucia project.
+// Copyright 2024-2026 DSP, inc.  All rights reserved.
+// Authors:
+//   chiayin.kuo@dsp.im (chiayin), 2023/1/31
+//   imacat.yang@dsp.im (imacat), 2023/9/23
+/**
+ * @module components/Compare/SidebarStates Summary sidebar for
+ *   the Compare view showing side-by-side statistics (cases,
+ *   traces, activities, timeframes, durations) of two files.
+ */
+
 import { ref, onMounted } from 'vue';
 import { useRoute } from 'vue-router';
 import { useCompareStore } from '@/stores/compare';
@@ -175,9 +186,9 @@ const primaryStatData = ref(null);
 const secondaryStatData = ref(null);
 
 /**
- * Number to percentage
- * @param   {number} val 原始數字
- * @returns {string} 轉換完成的百分比字串
+ * Converts a ratio (0–1) to a percentage number (0–100), capped at 100.
+ * @param {number} val - The ratio value to convert.
+ * @returns {number} The percentage value.
  */
 const getPercentLabel = (val) => {
   if((val * 100).toFixed(1) >= 100) return 100;
@@ -185,10 +196,10 @@ const getPercentLabel = (val) => {
 };
 
 /**
- * setting stats data
- * @param { object } data fetch API stats data
- * @param { string } fileName file Name
- * @returns { object }  primaryStatData | secondaryStatData，回傳 primaryStatData 或 secondaryStatData
+ * Transforms raw API stats into display-ready stat data.
+ * @param {Object} data - The raw stats from the API.
+ * @param {string} fileName - The file name to display.
+ * @returns {Object} The formatted stat data object.
  */
 const getStatData = (data, fileName) => {
   return {
@@ -224,9 +235,7 @@ const getStatData = (data, fileName) => {
   }
 };
 
-/**
- * Behavior when show
- */
+/** Populates progress bar values when the sidebar is shown. */
 const show = () => {
   primaryValueCases.value = primaryStatData.value.cases.ratio;
   primaryValueTraces.value = primaryStatData.value.traces.ratio;
@@ -238,9 +247,7 @@ const show = () => {
   secondaryValueTasks.value = secondaryStatData.value.tasks.ratio;
 };
 
-/**
- * Behavior when hidden
- */
+/** Resets all progress bar values to zero when the sidebar is hidden. */
 const hide = () => {
   primaryValueCases.value = 0;
   primaryValueTraces.value = 0;