Add JSDoc documentation and file headers to all source files

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

src/components/Discover/Conformance/ConformanceResults.vue

@@ -192,6 +192,18 @@
 </section>
 </template>
 <script setup>
+// The Lucia project.
+// Copyright 2023-2026 DSP, inc.  All rights reserved.
+// Authors:
+//   chiayin.kuo@dsp.im (chiayin), 2023/1/31
+//   cindy.chang@dsp.im (Cindy Chang), 2024/5/30
+//   imacat.yang@dsp.im (imacat), 2023/9/23
+/**
+ * @module components/Discover/Conformance/ConformanceResults
+ *   Conformance checking results panel displaying rule
+ *   check outcomes in a data table with status indicators.
+ */
+
 import { ref, watch } from 'vue';
 import { storeToRefs } from 'pinia';
 import { useConformanceStore } from '@/stores/conformance';
@@ -274,8 +286,8 @@ const tooltip = ref({
 
 /**
  * set progress bar width
- * @param   {number} value 百分比數字
- * @returns {string}      樣式的寬度設定
+ * @param   {number} value - The percentage value.
+ * @returns {string} The CSS width style string.
  */
 const progressWidth = (value) => {
   return `width:${value}%;`
@@ -283,8 +295,8 @@ const progressWidth = (value) => {
 
 /**
  * Number to percentage
- * @param   {number} val 原始數字
- * @returns {string} 轉換完成的百分比字串
+ * @param   {number} val - The raw ratio value.
+ * @returns {string} The formatted percentage string.
  */
 const getPercentLabel = (val) => {
   if((val * 100).toFixed(1) >= 100) return 100;
@@ -293,7 +305,7 @@ const getPercentLabel = (val) => {
 
 /**
  * Convert seconds to days
- * @param {number} sec 秒數
+ * @param {number} sec - The number of seconds.
  * @returns {number} day
  */
 const convertSecToDay = (sec) => {
@@ -302,7 +314,7 @@ const convertSecToDay = (sec) => {
 
 /**
  * Open Issues Modal.
- * @param {number} no trace 編號
+ * @param {number} no - The trace number.
  */
 const openMore = async (no) => {
   // async await 解決非同步資料延遲傳遞導致未讀取到而出錯的問題
@@ -315,7 +327,7 @@ const openMore = async (no) => {
 
 /**
  * Open Loop Modal.
- * @param {number} no trace 編號
+ * @param {number} no - The trace number.
  */
 const openLoopMore = async (no) => {
   // async await 解決非同步資料延遲傳遞導致未讀取到而出錯的問題
@@ -328,7 +340,7 @@ const openLoopMore = async (no) => {
 
 /**
  * set conformance report data
- * @param   {object} data new watch's value 監聽到後端傳來的報告 data
+ * @param   {object} data - The report data received from the backend.
  */
 const setConformanceTempReportData = (newData) => {
   const total = getNumberLabel(Object.values(newData.counts).reduce((acc, val) => acc + val, 0));