Add JSDoc documentation and file headers to all source files

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

src/views/MainContainer.vue

@@ -11,6 +11,19 @@
 </template>
 
 <script lang='ts'>
+// 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 views/MainContainer Main application layout with
+ *   header, navbar, and router view. Handles authentication
+ *   checks via beforeRouteEnter and unsaved-changes confirmation
+ *   via beforeRouteUpdate.
+ */
+
 import { useLoginStore } from "@/stores/login";
 import { usePageAdminStore } from "@/stores/pageAdmin";
 import { useAllMapDataStore } from "@/stores/allMapData";
@@ -116,6 +129,7 @@ const router = useRouter();
 const { tempFilterId, createFilterId, temporaryData, postRuleData, ruleData } = storeToRefs(allMapDataStore);
 const { conformanceLogTempCheckId, conformanceFilterTempCheckId } = storeToRefs(conformanceStore);
 
+/** Sets the highlighted navbar item based on the current URL path on page load. */
 const setHighlightedNavItemOnLanding = () => {
   const currentPath = router.currentRoute.value.path;
   const pathSegments: string[] = currentPath.split('/').filter(segment => segment !== '');