@tnotesjs/core 0.1.23 → 0.1.25

package/vitepress/components/Layout/Layout.vue

@@ -1,3 +1,7 @@
+<!-- 
+vitepress/components/Layout/Layout.vue 
+-->
+
 <template>
   <Layout>
     <template v-if="showNotFound" #not-found>

package/vitepress/components/Layout/NavBarSettingsTrigger.vue

@@ -1,3 +1,7 @@
+<!-- 
+vitepress/components/Layout/NavBarSettingsTrigger.vue 
+-->
+
 <template>
   <button
     type="button"

package/vitepress/components/Layout/NoteStatus.vue

@@ -1,3 +1,7 @@
+<!-- 
+vitepress/components/Layout/NoteStatus.vue 
+-->
+
 <template>
   <h1 v-if="shouldShow" class="note-status-title">
     <span v-if="statusEmoji" class="status-emoji">{{ statusEmoji }}</span>

package/vitepress/components/Layout/SidebarItems.vue

@@ -1,3 +1,7 @@
+<!-- 
+vitepress/components/Layout/SidebarItems.vue 
+-->
+
 <template>
   <template v-for="item in items" :key="getItemKey(item)">
     <!-- 只有在不超过最大层级时才渲染组 -->

package/vitepress/components/Layout/SidebarNavBefore.vue

@@ -1,3 +1,7 @@
+<!-- 
+vitepress/components/Layout/SidebarNavBefore.vue 
+-->
+
 <template>
   <div class="sidebar-toggle-wrapper">
     <div class="toolbar-row">

package/vitepress/components/Layout/SidebarResizeHandle.vue

@@ -1,5 +1,10 @@
+<!-- 
+vitepress/components/Layout/SidebarResizeHandle.vue 
+-->
+
 <template>
   <div
+    v-if="isSidebarAvailable"
     class="sidebar-resize-handle"
     :class="{
       'is-hidden': hidden,
@@ -30,7 +35,8 @@
 </template>
 
 <script setup lang="ts">
-import { computed, onBeforeUnmount, onMounted, ref } from 'vue'
+import { useRoute } from 'vitepress'
+import { computed, nextTick, onBeforeUnmount, onMounted, ref, watch } from 'vue'
 
 import { useSidebarLayout } from './composables/useSidebarLayout'
 import { icon__next, icon__prev } from '../../assets/icons'
@@ -46,9 +52,12 @@ const {
   saveSidebarWidth,
 } = useSidebarLayout()
 
+const route = useRoute()
 const isDragging = ref(false)
 const isContentFullscreen = ref(false)
+const isSidebarAvailable = ref(false)
 const shortcutText = ref('Ctrl + Alt + ,')
+const WIDE_LAYOUT_MIN_WIDTH = 1440
 let fullscreenObserver: MutationObserver | null = null
 
 const toggleIcon = computed(() => (hidden.value ? icon__next : icon__prev))
@@ -62,6 +71,7 @@ const toggleTitle = computed(
 onMounted(() => {
   initSidebarLayout()
   shortcutText.value = getShortcutText()
+  updateSidebarAvailability()
   updateContentFullscreen()
   fullscreenObserver = new MutationObserver(updateContentFullscreen)
   fullscreenObserver.observe(document.documentElement, {
@@ -85,13 +95,13 @@ function startResize(event: MouseEvent) {
   document.body.classList.add('is-sidebar-resizing')
   window.addEventListener('mousemove', resize)
   window.addEventListener('mouseup', stopResize)
-  setSidebarWidth(event.clientX)
+  setSidebarWidth(getSidebarWidthFromClientX(event.clientX))
 }
 
 function resize(event: MouseEvent) {
   if (!isDragging.value) return
 
-  setSidebarWidth(event.clientX)
+  setSidebarWidth(getSidebarWidthFromClientX(event.clientX))
 }
 
 function stopResize() {
@@ -105,17 +115,60 @@ function stopResize() {
 }
 
 function handleShortcut(event: KeyboardEvent) {
-  if (!isToggleShortcut(event) || isEditableTarget(event.target)) return
+  if (
+    !isSidebarAvailable.value ||
+    !isToggleShortcut(event) ||
+    isEditableTarget(event.target)
+  ) {
+    return
+  }
 
   event.preventDefault()
   toggleSidebar()
 }
 
+watch(
+  () => route.path,
+  async () => {
+    await nextTick()
+    updateSidebarAvailability()
+    updateContentFullscreen()
+  },
+)
+
+function updateSidebarAvailability() {
+  if (typeof document === 'undefined') return
+
+  isSidebarAvailable.value = Boolean(
+    document.querySelector('.VPContent.has-sidebar') &&
+      document.querySelector('.VPSidebar'),
+  )
+}
+
 function updateContentFullscreen() {
   isContentFullscreen.value =
     document.documentElement.classList.contains('content-fullscreen')
 }
 
+function getSidebarWidthFromClientX(clientX: number): number {
+  return clientX - getSidebarLayoutOffset()
+}
+
+function getSidebarLayoutOffset(): number {
+  if (typeof window === 'undefined' || typeof document === 'undefined') return 0
+  if (window.innerWidth < WIDE_LAYOUT_MIN_WIDTH) return 0
+
+  const layoutMaxWidth = Number.parseFloat(
+    window
+      .getComputedStyle(document.documentElement)
+      .getPropertyValue('--vp-layout-max-width'),
+  )
+
+  if (!Number.isFinite(layoutMaxWidth)) return 0
+
+  return Math.max(0, (window.innerWidth - layoutMaxWidth) / 2)
+}
+
 function isToggleShortcut(event: KeyboardEvent): boolean {
   return (
     (event.ctrlKey || event.metaKey) && event.altKey && event.code === 'Comma'
@@ -308,4 +361,12 @@ function isEditableTarget(target: EventTarget | null): boolean {
     display: none;
   }
 }
+
+@media (min-width: 1440px) {
+  .sidebar-resize-handle {
+    left: calc(
+      (100vw - var(--vp-layout-max-width)) / 2 + var(--tn-sidebar-width, 260px) - 5px
+    );
+  }
+}
 </style>

package/vitepress/components/Layout/Swiper.vue

@@ -1,3 +1,7 @@
+<!-- 
+vitepress/components/Layout/Swiper.vue 
+-->
+
 <template></template>
 
 <script setup>

package/vitepress/components/Layout/ToggleFullContent.vue

@@ -1,3 +1,7 @@
+<!-- 
+vitepress/components/Layout/ToggleFullContent.vue 
+-->
+
 <template>
   <img @click="toggle" class="contentToggleBtn" :title="full ? '退出全屏内容区' : '全屏显示内容区'" :src="full ? icon__fullscreen_exit : icon__fullscreen" alt="" />
 </template>

package/vitepress/components/Layout/ToggleSidebar.vue

@@ -1,4 +1,7 @@
-<!-- .vitepress\components\Layout\ToggleSidebar.vue -->
+<!-- 
+vitepress/components/Layout/ToggleSidebar.vue
+-->
+
 <template>
   <img
     @click="toggleSidebar"

package/vitepress/components/Layout/composables/useCollapseControl.ts

@@ -1,3 +1,9 @@
+/**
+ * vitepress/components/Layout/composables/useCollapseControl.ts
+ *
+ * 全局折叠/展开功能的组合式函数
+ */
+
 import { useRoute } from 'vitepress'
 import { ref, watch } from 'vue'
 

package/vitepress/components/Layout/composables/useNoteConfig.ts

@@ -1,3 +1,10 @@
+/**
+ * vitepress/components/Layout/composables/useNoteConfig.ts
+ * 
+ * 管理笔记配置状态
+ * 包括可编辑字段、原始值、变更检测等
+ */
+
 import { ref, computed, watch } from 'vue'
 
 import type { NoteConfig } from '../../../../types'

package/vitepress/components/Layout/composables/useNoteSave.ts

@@ -1,3 +1,7 @@
+/**
+ * vitepress/components/Layout/composables/useNoteSave.ts
+ */
+
 import { useData } from 'vitepress'
 import { ref, computed } from 'vue'
 

package/vitepress/components/Layout/composables/useNoteValidation.ts

@@ -1,3 +1,11 @@
+/**
+ * vitepress/components/Layout/composables/useNoteValidation.ts
+ * 
+ * 笔记标题验证组合式函数
+ * 包含标题验证逻辑和输入事件处理器
+ * 用于确保笔记标题合法，避免文件系统错误和用户困惑
+ */
+
 import type { Ref } from 'vue'
 
 /**

package/vitepress/components/Layout/composables/useRedirect.ts

@@ -1,3 +1,10 @@
+/**
+ * vitepress/components/Layout/composables/useRedirect.ts
+ * 
+ * 处理 404 重定向逻辑
+ * 当用户访问旧的笔记 URL 时,自动重定向到新的 URL
+ */
+
 import { useRoute, useData } from 'vitepress'
 import { ref, watch } from 'vue'
 

package/vitepress/components/Layout/composables/useRenameOverlay.ts

@@ -1,9 +1,12 @@
 /**
+ * vitepress/components/Layout/composables/useRenameOverlay.ts
+ * 
  * 全局「重命名遮罩」状态。
  *
  * Layout 顶层渲染 `<LoadingPage />`，由本 store 控制 visible/message/tip，
  * `useRenameRedirect` 调用 show/hide 即可。
  */
+
 import { reactive } from 'vue'
 
 export interface RenameOverlayState {

package/vitepress/components/Layout/composables/useRenameRedirect.ts

@@ -1,8 +1,11 @@
 /**
+ * vitepress/components/Layout/composables/useRenameRedirect.ts
+ * 
  * 重命名后跳转工具：显示遮罩 → 等 Vite HMR 重建路由 → 整页跳到新 URL。
  *
  * 关于面板保存与文件系统直接重命名两条入口共用此函数，确保行为一致。
  */
+
 import { useRenameOverlay } from './useRenameOverlay'
 
 export interface RedirectAfterRenameOptions {

package/vitepress/components/Layout/composables/useSidebarLayout.ts

@@ -1,3 +1,9 @@
+/**
+ * vitepress/components/Layout/composables/useSidebarLayout.ts
+ *
+ * 侧边栏布局管理的组合式函数
+ */
+
 import { ref } from 'vue'
 
 const SIDEBAR_HIDDEN_KEY = 'vp:sidebar:hidden'

package/vitepress/components/Layout/composables/useVSCodeIntegration.ts

@@ -1,3 +1,9 @@
+/**
+ * vitepress/components/Layout/composables/useVSCodeIntegration.ts
+ *
+ * VSCode 集成和 GitHub 链接拦截
+ */
+
 import { useData } from 'vitepress'
 import { ref } from 'vue'
 

package/vitepress/components/Layout/homeReadme.data.ts

@@ -1,4 +1,6 @@
-// .vitepress/components/Layout/homeReadme.data.ts
+/**
+ * vitepress/components/Layout/homeReadme.data.ts
+ */
 import { execSync } from 'node:child_process'
 import fs from 'node:fs'
 import path from 'node:path'

package/vitepress/components/LoadingPage/LoadingPage.vue

@@ -1,3 +1,7 @@
+<!-- 
+vitepress/components/LoadingPage.vue 
+-->
+
 <template>
   <ClientOnly>
     <Teleport to="body">

package/vitepress/components/MarkMap/MarkMap.vue

@@ -1,3 +1,7 @@
+<!-- 
+vitepress/components/MarkMap/MarkMap.vue 
+-->
+
 <script setup lang="ts">
 import { scaleOrdinal, schemePastel2, schemeSet3, schemeTableau10 } from 'd3'
 import { Transformer } from 'markmap-lib'

package/vitepress/components/Mermaid/Mermaid.vue

@@ -1,3 +1,9 @@
+<!-- 
+vitepress/components/Mermaid/Mermaid.vue
+
+Mermaid 图表组件，用于在页面中渲染 Mermaid 图表
+-->
+
 <template>
   <div
     ref="mermaidRef"

package/vitepress/components/NotesTable/NotesTable.vue

@@ -1,3 +1,7 @@
+<!-- 
+vitepress/components/NotesTable/NotesTable.vue 
+-->
+
 <template>
   <div v-if="errorMessage" class="error">
     {{ errorMessage }}

package/vitepress/components/Settings/Settings.vue

@@ -1,3 +1,9 @@
+<!-- 
+vitepress/components/Settings/Settings.vue
+
+设置组件，用于显示和修改应用设置
+-->
+
 <template>
   <div class="settingsWrapper">
     <section class="settingsSection">

package/vitepress/components/Settings/SettingsDialog.vue

@@ -1,3 +1,9 @@
+<!-- 
+vitepress/components/Settings/SettingsDialog.vue
+
+设置对话框组件，用于显示和修改应用设置
+-->
+
 <template>
   <ClientOnly>
     <Teleport to="body">

package/vitepress/components/Settings/composables/useSettingsDialog.ts

@@ -1,10 +1,13 @@
 /**
+ * vitepress/components/Settings/composables/useSettingsDialog.ts
+ * 
  * 全局「设置 Dialog」状态。
  *
  * Layout 顶层渲染 `<SettingsDialog />`，本 store 控制 visible/fullscreen，
  * 任何位置（导航入口、SidebarCard 提示等）调 `open()` 即可弹出，
  * 关闭后停留在当前路由与滚动位置。
  */
+
 import { reactive } from 'vue'
 
 export interface SettingsDialogState {

package/vitepress/components/SidebarCard/MindMapView.vue

@@ -1,3 +1,7 @@
+<!-- 
+vitepress/components/SidebarCard/MindMapView.vue 
+-->
+
 <script setup>
 import { scaleOrdinal, schemePastel2, schemeSet3, schemeTableau10 } from 'd3'
 import { Transformer } from 'markmap-lib'

package/vitepress/components/SidebarCard/NotesTrendChart.vue

@@ -1,3 +1,7 @@
+<!-- 
+.vitepress/components/SidebarCard/NotesTrendChart.vue
+-->
+
 <script setup>
 import { BarChart, LineChart } from 'echarts/charts'
 import { GridComponent, TooltipComponent } from 'echarts/components'

package/vitepress/components/SidebarCard/SidebarCard.vue

@@ -1,3 +1,7 @@
+<!-- 
+.vitepress/components/SidebarCard/SidebarCard.vue
+-->
+
 <script setup>
 import { useData } from 'vitepress'
 import { ref, computed, watch } from 'vue'

package/vitepress/components/Tooltip/Tooltip.vue

@@ -1,3 +1,9 @@
+<!-- 
+vitepress/components/Tooltip/Tooltip.vue
+
+提供一个简单的 Tooltip 组件，用于在鼠标悬停时显示提示信息
+-->
+
 <template>
   <span
     class="tooltip-wrapper"

package/vitepress/components/constants.ts

@@ -1,7 +1,10 @@
 /**
+ * vitepress/components/constants.ts
+ * 
  * 以下常量由 defineNotesConfig() 通过 vite.define 注入
  * 见 vitepress/config/index.ts 中的 define 配置
  */
+
 declare const __TNOTES_REPO_NAME__: string
 declare const __TNOTES_AUTHOR__: string
 declare const __TNOTES_IGNORE_DIRS__: string[]

package/vitepress/components/notesConfig.data.ts

@@ -1,4 +1,10 @@
-// .vitepress/components/notesConfig.data.ts
+/**
+ * .vitepress/components/notesConfig.data.ts
+ *
+ * 负责加载和监视 notes 目录下的 .tnotes.json 配置文件变化
+ * 供 VitePress 组件使用，确保组件能够实时响应配置变更
+ */
+
 import fs from 'node:fs'
 import path from 'node:path'
 

package/vitepress/components/sidebar.data.ts

@@ -1,5 +1,5 @@
 /**
- * .vitepress/tnotes/vitepress/components/sidebar.data.ts
+ * vitepress/components/sidebar.data.ts
  */
 
 import fs from 'node:fs'

package/vitepress/components/tnotes-config.data.ts

@@ -1,21 +1,26 @@
+/**
+ * vitepress/components/tnotes-config.data.ts
+ *
+ * 负责加载和监视 .tnotes.json 配置文件的变化
+ * 供 VitePress 组件使用，确保组件能够实时响应配置变更
+ */
+
 import fs from 'node:fs'
 import path from 'node:path'
 
-const rootPath = process.cwd()
+import { validateAndCompleteConfig } from '../../config/defaultConfig'
 
-export interface TNotesConfig {
-  sidebarShowNoteId: boolean
-  author?: string
-  repoName?: string
-  [key: string]: any
-}
+import type { TNotesConfig } from '../../types'
+
+const rootPath = process.cwd()
 
 export default {
   watch: [path.resolve(rootPath, '.tnotes.json')],
   load(watchedFiles: string[]): TNotesConfig {
     console.log('[tnotes-config.data.ts] Config loaded')
     const fileContent = fs.readFileSync(watchedFiles[0], 'utf-8')
-    const config = JSON.parse(fileContent) as TNotesConfig
+    const rawConfig = JSON.parse(fileContent)
+    const { config } = validateAndCompleteConfig(rawConfig)
     return config
   },
 }

package/vitepress/components/utils.ts

@@ -1,3 +1,9 @@
+/**
+ * vitepress/components/utils.ts
+ *
+ * VitePress 组件的公共工具函数
+ */
+
 export const formatDate = (timestamp: number): string => {
   const date = new Date(timestamp)
   const year = date.getFullYear()

package/vitepress/config/index.ts

@@ -1,5 +1,5 @@
 /**
- * .vitepress/tnotes/vitepress/config/index.ts
+ * vitepress/config/index.ts
  *
  * VitePress 站点配置工厂函数
  *
@@ -7,10 +7,12 @@
  *   import { defineNotesConfig } from './tnotes/vitepress/config'
  *   export default defineNotesConfig()
  */
+
 import fs from 'fs'
 import path from 'path'
 import { defineConfig, type UserConfig } from 'vitepress'
 
+import { ConfigManager } from '../../config/ConfigManager'
 import {
   getIgnoreList,
   getGithubPageUrl,
@@ -25,17 +27,6 @@ import { renameNotePlugin } from '../plugins/renameNotePlugin'
 import { sidebarStructurePlugin } from '../plugins/sidebarStructurePlugin'
 import { updateConfigPlugin } from '../plugins/updateConfigPlugin'
 
-import type { TNotesConfig } from '../../types'
-
-/**
- * 读取 .tnotes.json 配置文件
- */
-function loadTNotesConfig(rootPath: string): TNotesConfig {
-  const configPath = path.resolve(rootPath, '.tnotes.json')
-  const configContent = fs.readFileSync(configPath, 'utf-8')
-  return JSON.parse(configContent) as TNotesConfig
-}
-
 /**
  * 创建 VitePress 站点配置
  *
@@ -44,7 +35,8 @@ function loadTNotesConfig(rootPath: string): TNotesConfig {
  */
 export function defineNotesConfig(overrides: UserConfig = {}) {
   const rootPath = process.cwd()
-  const config = loadTNotesConfig(rootPath)
+  ConfigManager.init({ rootPath })
+  const config = ConfigManager.getInstance().getAll()
   const { repoName } = config
 
   const IGNORE_LIST = getIgnoreList(config)

package/vitepress/configs/constants.ts

@@ -3,6 +3,7 @@
  *
  * 常量配置 - 从运行时配置派生，不再硬编码相对路径 import
  */
+
 import type { TNotesConfig } from '../../types'
 
 /**

package/vitepress/configs/head.config.ts

@@ -3,6 +3,7 @@
  *
  * HTML head 标签配置
  */
+
 import { HeadConfig } from 'vitepress'
 
 import type { TNotesConfig } from '../../types'

package/vitepress/configs/index.ts

@@ -3,6 +3,7 @@
  *
  * 配置模块统一导出
  */
+
 export { getIgnoreList, getGithubPageUrl } from './constants'
 export { getHeadConfig } from './head.config'
 export { getMarkdownConfig } from './markdown.config'

package/vitepress/configs/markdown.config.ts

@@ -3,6 +3,7 @@
  *
  * Markdown 配置
  */
+
 import fs from 'fs'
 import markdownItContainer from 'markdown-it-container'
 import mila from 'markdown-it-link-attributes'

package/vitepress/configs/theme.config.ts

@@ -6,6 +6,7 @@
  * doc:
  * https://vitepress.dev/reference/default-theme-config
  */
+
 import type { TNotesConfig } from '../../types'
 import type { DefaultTheme } from 'vitepress'
 

package/vitepress/plugins/buildProgressPlugin.ts

@@ -1,5 +1,5 @@
 /**
- * .vitepress/tnotes/vitepress/plugins/buildProgressPlugin.ts
+ * vitepress/plugins/buildProgressPlugin.ts
  *
  * 构建进度插件 - 仅在 build 模式下显示真实进度
  *

package/vitepress/plugins/fileWatcherBridgePlugin.ts

@@ -1,5 +1,5 @@
 /**
- * .vitepress/tnotes/vitepress/plugins/fileWatcherBridgePlugin.ts
+ * vitepress/plugins/fileWatcherBridgePlugin.ts
  *
  * file-watcher 与浏览器之间的 IPC 桥。
  *
@@ -7,6 +7,7 @@
  * 两者无法共享单例。文件夹直接重命名后，file-watcher 会 fetch 本接口，
  * 本接口调 `server.ws.send` 向浏览器广播 `tnotes:note-renamed`。
  */
+
 import type { PluginOption } from 'vite'
 
 const RENAME_EVENT = 'tnotes:note-renamed'

package/vitepress/plugins/getNoteByConfigIdPlugin.ts

@@ -1,8 +1,9 @@
 /**
- * .vitepress/tnotes/vitepress/plugins/getNoteByConfigIdPlugin.ts
+ * vitepress/plugins/getNoteByConfigIdPlugin.ts
  *
  * VitePress 插件 - 根据 configId 查询笔记信息
  */
+
 import { NoteIndexCache } from '../../core'
 import { logger } from '../../utils'
 

package/vitepress/plugins/renameNotePlugin.ts

@@ -1,8 +1,9 @@
 /**
- * .vitepress/tnotes/vitepress/plugins/renameNotePlugin.ts
+ * vitepress/plugins/renameNotePlugin.ts
  *
  * Vite 插件 - 处理笔记重命名请求
  */
+
 import { RenameNoteCommand } from '../../commands/note/RenameNoteCommand'
 
 import type { PluginOption } from 'vite'