@tnotesjs/core 0.0.7 → 0.1.14

package/vitepress/components/SidebarCard/SidebarCard.vue

@@ -1,15 +1,6 @@
 <script setup>
 import { useData } from 'vitepress'
-import { formatDate } from '../utils.ts'
 import { ref, computed, watch } from 'vue'
-import { useRouter } from 'vitepress'
-// @ts-expect-error - VitePress Data Loader
-import { data as sidebarConfig } from '../sidebar.data'
-
-import { NOTES_DIR_KEY, REPO_NAME, AUTHOR, ROOT_ITEM } from '../constants.ts'
-
-import MindMapView from './MindMapView.vue'
-import NotesTrendChart from './NotesTrendChart.vue'
 
 import {
   icon__fold,
@@ -21,6 +12,13 @@ import {
   icon__number_gray,
   icon__number_purple,
 } from '../../assets/icons'
+import { NOTES_DIR_KEY, REPO_NAME, AUTHOR, ROOT_ITEM } from '../constants.ts'
+import { useSettingsDialog } from '../Settings/composables/useSettingsDialog'
+import { data as sidebarConfig } from '../sidebar.data'
+import { formatDate } from '../utils.ts'
+// @ts-expect-error - VitePress Data Loader
+import MindMapView from './MindMapView.vue'
+import NotesTrendChart from './NotesTrendChart.vue'
 
 // #region props
 const props = defineProps({
@@ -99,7 +97,7 @@ const folderViewData = computed(() => {
 })
 // #endregion
 
-const router = useRouter()
+const { open: openSettings } = useSettingsDialog()
 const { site } = useData()
 const baseUrl = site.value.base.replace(/\/$/, '')
 
@@ -263,10 +261,10 @@ function openVSCodeRepo() {
 
   if (!notesDir) {
     const shouldRedirect = confirm(
-      '请先配置本地知识库所在位置，点击确定跳转到设置页面',
+      '请先配置本地知识库所在位置，点击确定打开设置面板',
     )
     if (shouldRedirect) {
-      router.go(`${REPO_NAME}/Settings`)
+      openSettings()
     }
     return
   }
@@ -280,10 +278,10 @@ function openVSCodeArticle(article) {
 
   if (!notesDir) {
     const shouldRedirect = confirm(
-      '请先配置本地知识库所在位置，点击确定跳转到设置页面',
+      '请先配置本地知识库所在位置，点击确定打开设置面板',
     )
     if (shouldRedirect) {
-      router.go(`${REPO_NAME}/Settings`)
+      openSettings()
     }
     return
   }

package/vitepress/config/index.ts

@@ -10,7 +10,7 @@
 import fs from 'fs'
 import path from 'path'
 import { defineConfig, type UserConfig } from 'vitepress'
-import type { TNotesConfig } from '../../types'
+
 import {
   getIgnoreList,
   getGithubPageUrl,
@@ -18,10 +18,13 @@ import {
   getMarkdownConfig,
   getThemeConfig,
 } from '../configs'
-import { updateConfigPlugin } from '../plugins/updateConfigPlugin'
-import { renameNotePlugin } from '../plugins/renameNotePlugin'
-import { getNoteByConfigIdPlugin } from '../plugins/getNoteByConfigIdPlugin'
 import { buildProgressPlugin } from '../plugins/buildProgressPlugin'
+import { fileWatcherBridgePlugin } from '../plugins/fileWatcherBridgePlugin'
+import { getNoteByConfigIdPlugin } from '../plugins/getNoteByConfigIdPlugin'
+import { renameNotePlugin } from '../plugins/renameNotePlugin'
+import { updateConfigPlugin } from '../plugins/updateConfigPlugin'
+
+import type { TNotesConfig } from '../../types'
 
 /**
  * 读取 .tnotes.json 配置文件
@@ -75,9 +78,13 @@ export function defineNotesConfig(overrides: UserConfig = {}) {
         updateConfigPlugin() as any,
         renameNotePlugin() as any,
         getNoteByConfigIdPlugin() as any,
+        fileWatcherBridgePlugin() as any,
         ...(overrideVite?.plugins || []),
       ],
       server: {
+        // 显式同时监听 IPv4 / IPv6，避免 Node 18+ 在 Windows 下偶发只绑定 ::1
+        // 导致 Chrome 解析 localhost → 127.0.0.1 时连接被拒、页面一直 pending。
+        // host: true,
         watch: {
           ignored: IGNORE_LIST,
         },

package/vitepress/configs/head.config.ts

@@ -3,7 +3,8 @@
  *
  * HTML head 标签配置
  */
-import { HeadConfig } from 'vitepress'
+import { HeadConfig } from 'vitepress'
+
 import type { TNotesConfig } from '../../types'
 
 export function getHeadConfig(config: TNotesConfig, githubPageUrl: string): HeadConfig[] {

package/vitepress/configs/markdown-it.d.ts

@@ -5,19 +5,22 @@
  */
 
 declare module 'markdown-it-container' {
-  import { PluginWithOptions } from 'markdown-it'
+  import { PluginWithOptions } from 'markdown-it'
+
   const markdownItContainer: PluginWithOptions<any>
   export default markdownItContainer
 }
 
 declare module 'markdown-it-link-attributes' {
-  import { PluginWithOptions } from 'markdown-it'
+  import { PluginWithOptions } from 'markdown-it'
+
   const markdownItLinkAttributes: PluginWithOptions<any>
   export default markdownItLinkAttributes
 }
 
 declare module 'markdown-it-task-lists' {
-  import { PluginWithOptions } from 'markdown-it'
+  import { PluginWithOptions } from 'markdown-it'
+
   const markdownItTaskLists: PluginWithOptions<any>
   export default markdownItTaskLists
 }

package/vitepress/configs/markdown.config.ts

@@ -3,14 +3,15 @@
  *
  * Markdown 配置
  */
+import fs from 'fs'
 import MarkdownIt from 'markdown-it'
 import markdownItContainer from 'markdown-it-container'
 import mila from 'markdown-it-link-attributes'
 import markdownItTaskLists from 'markdown-it-task-lists'
-import { MarkdownOptions } from 'vitepress'
-import { generateAnchor } from '../../utils'
-import fs from 'fs'
 import path from 'path'
+import { MarkdownOptions } from 'vitepress'
+
+import { generateAnchor } from '../../utils'
 
 /**
  * 辅助函数：HTML 转义
@@ -105,7 +106,7 @@ function configureMarkMapContainer(md: MarkdownIt) {
         const endLine = open.map ? open.map[1] - 1 : null
 
         // 1) 从开头 fence 行解析参数（支持 `{a=1 b="x"}`、`a=1 b="x"`，并支持单个数字 shorthand）
-        let params: { [key: string]: any; initialExpandLevel?: number } = {}
+        const params: { [key: string]: any; initialExpandLevel?: number } = {}
 
         if (open.map && typeof open.map[0] === 'number') {
           const openLine = (lines[open.map[0]] || '').trim()
@@ -179,7 +180,7 @@ function configureMarkMapContainer(md: MarkdownIt) {
         const refMatch = firstNonEmptyLine.trim().match(/^<<<\s*(.+)$/)
         if (refMatch) {
           // 提取引用路径，支持引号包裹
-          let refRaw = refMatch[1].trim().replace(/^['"]|['"]$/g, '')
+          const refRaw = refMatch[1].trim().replace(/^['"]|['"]$/g, '')
 
           // 尝试同步读取文件内容（兼容常见 Node 环境）
           try {

package/vitepress/configs/theme.config.ts

@@ -6,8 +6,8 @@
  * doc:
  * https://vitepress.dev/reference/default-theme-config
  */
-import type { DefaultTheme } from 'vitepress'
 import type { TNotesConfig } from '../../types'
+import type { DefaultTheme } from 'vitepress'
 
 export function getThemeConfig(config: TNotesConfig): DefaultTheme.Config {
   const themeConfig: DefaultTheme.Config = {

package/vitepress/plugins/buildProgressPlugin.ts

@@ -7,16 +7,16 @@
  * https://github.com/jeddygong/vite-plugin-progress
  */
 
-import type { Plugin } from 'vite'
 import {
   existsSync,
   readFileSync,
   writeFileSync,
   mkdirSync,
-  readdirSync,
 } from 'fs'
 import { join } from 'path'
 
+import type { Plugin } from 'vite'
+
 /** 缓存目录和文件路径 */
 const CACHE_DIR = join(process.cwd(), 'node_modules', '.tnotes-progress')
 const CACHE_FILE = join(CACHE_DIR, 'build-cache.json')
@@ -64,37 +64,6 @@ function setCacheData(data: CacheData): void {
   }
 }
 
-/**
- * 扫描源目录文件数量
- */
-function countSourceFiles(srcDir: string): number {
-  let count = 0
-  const extensions = /\.(vue|ts|js|jsx|tsx|css|scss|sass|styl|less|md)$/i
-
-  const scan = (dir: string) => {
-    try {
-      const entries = readdirSync(dir, { withFileTypes: true })
-      for (const entry of entries) {
-        const fullPath = join(dir, entry.name)
-        if (
-          entry.isDirectory() &&
-          !entry.name.startsWith('.') &&
-          entry.name !== 'node_modules'
-        ) {
-          scan(fullPath)
-        } else if (entry.isFile() && extensions.test(entry.name)) {
-          count++
-        }
-      }
-    } catch {
-      // 忽略错误
-    }
-  }
-
-  scan(srcDir)
-  return count
-}
-
 // ============ 全局状态 ============
 let globalStartTime = 0
 let globalTransformCount = 0
@@ -103,7 +72,6 @@ let globalHasError = false
 let globalIsBuilding = false
 let globalOutDir = ''
 let globalLastPercent = 0
-let globalFileCount = 0
 let globalLastLoggedPercent = -1 // 非 TTY 环境下上次输出的百分比区间，初始为 -1 以便第一次输出
 let globalLastOutputTime = 0 // 非 TTY 环境下上次输出时间戳，用于时间节流
 let globalTransformEndTime = 0 // transform 阶段结束时间戳
@@ -273,10 +241,6 @@ export function buildProgressPlugin(
           globalLastHookTime = Date.now()
           globalOutDir = config.build?.outDir || 'dist'
 
-          if (!hasCache) {
-            globalFileCount = countSourceFiles(process.cwd())
-          }
-
           interceptOutput()
 
           // 停滞填充计时器：当 Vite hook 超过 2 秒没触发时（如 VitePress 渲染页面阶段），

package/vitepress/plugins/fileWatcherBridgePlugin.ts

@@ -0,0 +1,49 @@
+/**
+ * .vitepress/tnotes/vitepress/plugins/fileWatcherBridgePlugin.ts
+ *
+ * file-watcher 与浏览器之间的 IPC 桥。
+ *
+ * file-watcher 跑在 DevCommand 主进程，VitePress / Vite 跑在子进程，
+ * 两者无法共享单例。文件夹直接重命名后，file-watcher 会 fetch 本接口，
+ * 本接口调 `server.ws.send` 向浏览器广播 `tnotes:note-renamed`。
+ */
+import type { PluginOption } from 'vite'
+
+const RENAME_EVENT = 'tnotes:note-renamed'
+const BROADCAST_PATH = '/__tnotes_broadcast_rename'
+
+export function fileWatcherBridgePlugin(): PluginOption {
+  return {
+    name: 'tnotes-file-watcher-bridge',
+    apply: 'serve',
+    configureServer(server) {
+      server.middlewares.use((req, res, next) => {
+        // Vite 的 baseMiddleware 顺序在不同版本可能不同，
+        // 这里同时接受 `/__tnotes_broadcast_rename` 与带 base 前缀的路径。
+        const url = req.url ?? ''
+        const isBroadcast =
+          url === BROADCAST_PATH || url.endsWith(BROADCAST_PATH)
+        if (!isBroadcast || req.method !== 'POST') {
+          return next()
+        }
+        let body = ''
+        req.on('data', (chunk) => {
+          body += chunk.toString()
+        })
+        req.on('end', () => {
+          try {
+            const data = JSON.parse(body || '{}')
+            server.ws.send({ type: 'custom', event: RENAME_EVENT, data })
+            res.statusCode = 204
+            res.end()
+          } catch (error) {
+            res.statusCode = 400
+            res.end(
+              error instanceof Error ? error.message : 'Bad rename payload',
+            )
+          }
+        })
+      })
+    },
+  }
+}

package/vitepress/plugins/getNoteByConfigIdPlugin.ts

@@ -3,9 +3,10 @@
  *
  * VitePress 插件 - 根据 configId 查询笔记信息
  */
-import type { PluginOption } from 'vite'
 import { NoteIndexCache } from '../../core'
-import { logger } from '../../utils'
+import { logger } from '../../utils'
+
+import type { PluginOption } from 'vite'
 
 export function getNoteByConfigIdPlugin(): PluginOption {
   return {

package/vitepress/plugins/renameNotePlugin.ts

@@ -3,9 +3,10 @@
  *
  * Vite 插件 - 处理笔记重命名请求
  */
-import type { PluginOption } from 'vite'
 import { RenameNoteCommand } from '../../commands/note/RenameNoteCommand'
 
+import type { PluginOption } from 'vite'
+
 export function renameNotePlugin(): PluginOption {
   const renameCommand = new RenameNoteCommand()
 
@@ -36,6 +37,11 @@ export function renameNotePlugin(): PluginOption {
               await renameCommand.renameNote({ noteIndex, newTitle })
               const duration = Date.now() - startTime
 
+              const newFolderName = `${noteIndex}. ${newTitle.trim()}`
+              const newUrl = `/notes/${encodeURIComponent(
+                newFolderName,
+              )}/README`
+
               res.statusCode = 200
               res.setHeader('Content-Type', 'application/json')
               res.end(
@@ -43,6 +49,8 @@ export function renameNotePlugin(): PluginOption {
                   success: true,
                   duration,
                   newTitle,
+                  newFolderName,
+                  newUrl,
                   message: '重命名完成',
                 })
               )

package/vitepress/plugins/updateConfigPlugin.ts

@@ -3,8 +3,9 @@
  *
  * VitePress 插件 - 处理笔记配置更新请求
  */
+import { UpdateNoteConfigCommand } from '../../commands/note/UpdateNoteConfigCommand'
+
 import type { PluginOption } from 'vite'
-import { UpdateNoteConfigCommand } from '../../commands/note/UpdateNoteConfigCommand'
 
 export function updateConfigPlugin(): PluginOption {
   let updateCommand: UpdateNoteConfigCommand

package/vitepress/theme/index.ts

@@ -12,20 +12,23 @@
  * v2 - https://vitepress.dev/zh/guide/custom-theme
  */
 
-import type { Theme, EnhanceAppContext } from 'vitepress'
 import DefaultTheme from 'vitepress/theme'
+
 import BilibiliOutsidePlayer from '../components/BilibiliOutsidePlayer/BilibiliOutsidePlayer.vue'
 import Discussions from '../components/Discussions/Discussions.vue'
 import EnWordList from '../components/EnWordList/EnWordList.vue'
 import Footprints from '../components/Footprints/Footprints.vue'
+import { useRenameOverlay } from '../components/Layout/composables/useRenameOverlay'
+import { redirectAfterRename } from '../components/Layout/composables/useRenameRedirect'
 import Layout from '../components/Layout/Layout.vue'
-import LoadingPage from '../components/LoadingPage/LoadingPage.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'
+
+import type { Theme, EnhanceAppContext } from 'vitepress'
 import './styles/index.scss'
 
 /**
@@ -40,7 +43,6 @@ function registerCoreComponents(ctx: EnhanceAppContext) {
   app.component('E', EnWordList)
   app.component('Footprints', Footprints)
   app.component('F', Footprints)
-  app.component('LoadingPage', LoadingPage)
   app.component('Settings', Settings)
   app.component('S', Settings)
   app.component('SidebarCard', SidebarCard)
@@ -51,6 +53,44 @@ function registerCoreComponents(ctx: EnhanceAppContext) {
   app.component('Tooltip', Tooltip)
 }
 
+/**
+ * 在 dev server 中监听文件夹直接重命名事件，
+ * 当当前页面路径属于被重命名的文件夹时，自动跳转到新 URL。
+ */
+function registerRenameHmrListener() {
+  if (typeof window === 'undefined') return
+  if (typeof import.meta.hot === 'undefined' || !import.meta.hot) return
+
+  const overlay = useRenameOverlay()
+  let handling = false
+
+  import.meta.hot.on(
+    'tnotes:note-renamed',
+    async (payload: {
+      oldFolder?: string
+      newFolder?: string
+      noteIndex?: string
+    }) => {
+      if (handling) return
+      if (!payload?.oldFolder || !payload?.newFolder) return
+
+      const oldSegment = encodeURIComponent(payload.oldFolder)
+      if (!window.location.pathname.includes(oldSegment)) return
+
+      handling = true
+      overlay.show({ message: '检测到文件夹重命名', tip: '正在跳转到新地址...' })
+
+      try {
+        await redirectAfterRename(
+          `notes/${encodeURIComponent(payload.newFolder)}/README`,
+        )
+      } finally {
+        handling = false
+      }
+    },
+  )
+}
+
 /**
  * 覆盖选项
  */
@@ -78,6 +118,7 @@ export function defineNotesTheme(overrides: NotesThemeOverrides = {}): Theme {
     Layout: overrides.Layout ?? Layout,
     enhanceApp(ctx) {
       registerCoreComponents(ctx)
+      registerRenameHmrListener()
       overrides.enhanceApp?.(ctx)
     },
   }
@@ -91,5 +132,6 @@ export default {
   Layout,
   enhanceApp(ctx: EnhanceAppContext) {
     registerCoreComponents(ctx)
+    registerRenameHmrListener()
   },
 } satisfies Theme