@tnotesjs/core 0.1.24 → 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,3 +1,7 @@
+<!-- 
+vitepress/components/Layout/SidebarResizeHandle.vue 
+-->
+
 <template>
   <div
     v-if="isSidebarAvailable"
@@ -31,8 +35,8 @@
 </template>
 
 <script setup lang="ts">
-import { computed, nextTick, onBeforeUnmount, onMounted, ref, watch } 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'

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'

package/vitepress/plugins/sidebarStructurePlugin.ts

@@ -1,12 +1,13 @@
 /**
- * .vitepress/tnotes/vitepress/plugins/sidebarStructurePlugin.ts
+ * vitepress/plugins/sidebarStructurePlugin.ts
  *
  * VitePress dev middleware - 处理语雀风格侧边栏的目录结构操作。
  */
+
 import { FileWatcherService, NoteService, ReadmeService } from '../../services'
 
-import type { IncomingMessage, ServerResponse } from 'http'
 import type { NoteInfo } from '../../types'
+import type { IncomingMessage, ServerResponse } from 'http'
 import type { PluginOption } from 'vite'
 
 interface JsonResponse {

package/vitepress/plugins/updateConfigPlugin.ts

@@ -1,8 +1,9 @@
 /**
- * .vitepress/tnotes/vitepress/plugins/updateConfigPlugin.ts
+ * vitepress/plugins/updateConfigPlugin.ts
  *
  * VitePress 插件 - 处理笔记配置更新请求
  */
+
 import { UpdateNoteConfigCommand } from '../../commands/note/UpdateNoteConfigCommand'
 
 import type { PluginOption } from 'vite'

package/vitepress/theme/index.ts

@@ -1,5 +1,5 @@
 /**
- * .vitepress/tnotes/theme/index.ts
+ * theme/index.ts
  *
  * 自定义主题
  *
@@ -24,7 +24,6 @@ import Layout from '../components/Layout/Layout.vue'
 import MarkMap from '../components/MarkMap/MarkMap.vue'
 import Mermaid from '../components/Mermaid/Mermaid.vue'
 import NotesTable from '../components/NotesTable/NotesTable.vue'
-import Settings from '../components/Settings/Settings.vue'
 import SidebarCard from '../components/SidebarCard/SidebarCard.vue'
 import Tooltip from '../components/Tooltip/Tooltip.vue'
 
@@ -43,8 +42,6 @@ function registerCoreComponents(ctx: EnhanceAppContext) {
   app.component('E', EnWordList)
   app.component('Footprints', Footprints)
   app.component('F', Footprints)
-  app.component('Settings', Settings)
-  app.component('S', Settings)
   app.component('SidebarCard', SidebarCard)
   app.component('MarkMap', MarkMap)
   app.component('Mermaid', Mermaid)