@tnotesjs/core 0.1.27 → 0.2.0

package/vitepress/plugins/sidebarStructurePlugin.ts

@@ -4,7 +4,9 @@
  * VitePress dev middleware - 处理语雀风格侧边栏的目录结构操作。
  */
 
-import { FileWatcherService, NoteService, ReadmeService } from '../../services'
+import { scheduleNoteSearchReindex } from './localSearchReindexPlugin'
+import { FileWatcherService, NoteService, TocService } from '../../services'
+
 
 import type { NoteInfo } from '../../types'
 import type { IncomingMessage, ServerResponse } from 'http'
@@ -15,6 +17,7 @@ interface JsonResponse {
   message?: string
   sidebarChanged?: boolean
   redirectUrl?: string
+  redirectNoteIndex?: string | null
   createdNotes?: Array<{ index: string; dirName: string; link: string }>
   deletedNoteIndexes?: string[]
 }
@@ -47,14 +50,6 @@ function normalizePathname(url?: string): string {
   return (url || '').split('?')[0]
 }
 
-function normalizeGroupPath(value: unknown): string[] {
-  if (!Array.isArray(value) || value.length === 0) {
-    throw new Error('Missing groupPath')
-  }
-
-  return value.map((item) => String(item))
-}
-
 function normalizeCount(value: unknown): number {
   const count = Number(value ?? 1)
   if (!Number.isInteger(count) || count < 1 || count > 100) {
@@ -71,6 +66,22 @@ function getCreatedNotePayload(notes: NoteInfo[]) {
   }))
 }
 
+function buildNoteReadmeLink(note: NoteInfo): string {
+  return `/notes/${encodeURIComponent(note.dirName)}/README`
+}
+
+function resolveDeleteRedirectUrl(
+  noteService: NoteService,
+  previousNoteIndex: string | null,
+): string {
+  if (!previousNoteIndex) return '/'
+
+  const previousNote = noteService.getNoteByIndex(previousNoteIndex)
+  if (!previousNote) return '/'
+
+  return buildNoteReadmeLink(previousNote)
+}
+
 async function withSuspendedWatcher<T>(task: () => Promise<T>): Promise<T> {
   const watcher = FileWatcherService.getInstance()
 
@@ -84,7 +95,7 @@ async function withSuspendedWatcher<T>(task: () => Promise<T>): Promise<T> {
 
 export function sidebarStructurePlugin(): PluginOption {
   const noteService = NoteService.getInstance()
-  const readmeService = ReadmeService.getInstance()
+  const tocService = TocService.getInstance()
 
   async function createNotes(count: number) {
     const notes = []
@@ -112,17 +123,22 @@ export function sidebarStructurePlugin(): PluginOption {
     return notes
   }
 
+  async function refreshTocAndSidebar() {
+    await tocService.regenerateSidebar()
+  }
+
   return {
     name: 'tnotes-sidebar-structure',
     configureServer(server) {
       server.middlewares.use(async (req, res, next) => {
         const pathname = normalizePathname(req.url)
         const handledPaths = new Set([
-          '/__tnotes_sidebar_rename_group',
-          '/__tnotes_sidebar_delete_group',
           '/__tnotes_sidebar_create_note',
           '/__tnotes_sidebar_create_notes',
+          '/__tnotes_sidebar_create_folder',
           '/__tnotes_sidebar_delete_note',
+          '/__tnotes_sidebar_delete_entry',
+          '/__tnotes_sidebar_rename_folder',
           '/__tnotes_sidebar_reorder',
         ])
 
@@ -140,81 +156,165 @@ export function sidebarStructurePlugin(): PluginOption {
           const data = await readJsonBody(req)
 
           const result = await withSuspendedWatcher(async () => {
-            if (pathname === '/__tnotes_sidebar_rename_group') {
-              const groupPath = normalizeGroupPath(data.groupPath)
-              const newTitle = String(data.newTitle || '')
-              await readmeService.renameGroupInReadme(groupPath, newTitle)
-              await readmeService.refreshHomeReadmeAndSidebar()
+            if (pathname === '/__tnotes_sidebar_delete_note') {
+              const noteIndex = String(data.noteIndex || '')
+              if (!noteIndex) throw new Error('Missing noteIndex')
+
+              const previousNoteIndex =
+                await tocService.getPreviousNoteIndexBeforeDelete(noteIndex)
+
+              await tocService.deleteNoteFromToc(noteIndex)
+              await noteService.deleteNote(noteIndex)
+              await refreshTocAndSidebar()
+              scheduleNoteSearchReindex('api:delete-note')
+
               return {
                 success: true,
                 sidebarChanged: true,
-                message: '目录已重命名',
+                redirectUrl: resolveDeleteRedirectUrl(
+                  noteService,
+                  previousNoteIndex,
+                ),
+                redirectNoteIndex: previousNoteIndex,
+                deletedNoteIndexes: [noteIndex],
+                message: '笔记已删除',
               }
             }
 
-            if (pathname === '/__tnotes_sidebar_delete_group') {
-              const groupPath = normalizeGroupPath(data.groupPath)
-              const noteIndexes = await readmeService.deleteGroupFromReadme(
-                groupPath,
-              )
-
-              for (const noteIndex of noteIndexes) {
-                await noteService.deleteNote(noteIndex)
+            if (pathname === '/__tnotes_sidebar_delete_entry') {
+              const tocLineIndex = Number(data.tocLineIndex)
+              if (!Number.isInteger(tocLineIndex) || tocLineIndex < 0) {
+                throw new Error('Missing tocLineIndex')
               }
 
-              await readmeService.refreshHomeReadmeAndSidebar()
+              const currentNoteIndex = String(data.currentNoteIndex || '')
+              const previousNoteIndex =
+                await tocService.getPreviousNoteIndexBeforeEntryDelete(
+                  tocLineIndex,
+                )
+              const inSubtree =
+                currentNoteIndex &&
+                (await tocService.isNoteInTocEntrySubtree(
+                  tocLineIndex,
+                  currentNoteIndex,
+                ))
+
+              const deletedNoteIndexes =
+                await tocService.deleteTocEntryCascade(tocLineIndex)
+              await refreshTocAndSidebar()
+              scheduleNoteSearchReindex('api:delete-entry')
+
               return {
                 success: true,
                 sidebarChanged: true,
-                redirectUrl: '/',
-                deletedNoteIndexes: noteIndexes,
-                message: '目录已删除',
+                redirectUrl: inSubtree
+                  ? resolveDeleteRedirectUrl(noteService, previousNoteIndex)
+                  : undefined,
+                redirectNoteIndex: inSubtree ? previousNoteIndex : null,
+                deletedNoteIndexes,
+                message: '已删除',
               }
             }
 
-            if (pathname === '/__tnotes_sidebar_delete_note') {
-              const noteIndex = String(data.noteIndex || '')
-              if (!noteIndex) throw new Error('Missing noteIndex')
+            if (pathname === '/__tnotes_sidebar_rename_folder') {
+              const tocLineIndex = Number(data.tocLineIndex)
+              const newTitle = String(data.newTitle || '')
+              if (!Number.isInteger(tocLineIndex) || tocLineIndex < 0) {
+                throw new Error('Missing tocLineIndex')
+              }
 
-              await readmeService.deleteNoteFromReadme(noteIndex)
-              await noteService.deleteNote(noteIndex)
-              await readmeService.refreshHomeReadmeAndSidebar()
+              await tocService.renameFolderInToc(tocLineIndex, newTitle)
+              await refreshTocAndSidebar()
 
               return {
                 success: true,
                 sidebarChanged: true,
-                redirectUrl: '/',
-                deletedNoteIndexes: [noteIndex],
-                message: '笔记已删除',
+                message: '目录已重命名',
               }
             }
 
             if (pathname === '/__tnotes_sidebar_reorder') {
-              if (data.dragType === 'note') {
-                const noteIndex = String(data.noteIndex || '')
-                if (!noteIndex) throw new Error('Missing noteIndex')
-
-                if (data.targetType === 'group') {
-                  await readmeService.moveNoteInReadme(noteIndex, {
-                    targetGroupPath: normalizeGroupPath(data.targetGroupPath),
-                  })
+              if (
+                data.node_uuid &&
+                data.action === 'prependChild' &&
+                !data.target_uuid
+              ) {
+                await tocService.prependToRootByNodeId(String(data.node_uuid))
+                await refreshTocAndSidebar()
+                return {
+                  success: true,
+                  sidebarChanged: true,
+                  message: '排序已更新',
+                }
+              }
+
+              if (
+                data.node_uuid &&
+                data.target_uuid &&
+                (data.action === 'moveAfter' || data.action === 'prependChild')
+              ) {
+                if (data.action === 'moveAfter') {
+                  await tocService.moveAfterByNodeId(
+                    String(data.node_uuid),
+                    String(data.target_uuid),
+                  )
                 } else {
-                  await readmeService.moveNoteInReadme(noteIndex, {
-                    targetNoteIndex: String(data.targetNoteIndex || ''),
-                    placement: data.placement === 'after' ? 'after' : 'before',
-                  })
+                  await tocService.prependChildByNodeId(
+                    String(data.node_uuid),
+                    String(data.target_uuid),
+                  )
                 }
-              } else if (data.dragType === 'group') {
-                await readmeService.moveGroupInReadme(
-                  normalizeGroupPath(data.groupPath),
-                  normalizeGroupPath(data.targetGroupPath),
-                  data.placement === 'after' ? 'after' : 'before',
-                )
+                await refreshTocAndSidebar()
+                return {
+                  success: true,
+                  sidebarChanged: true,
+                  message: '排序已更新',
+                }
+              }
+
+              const dragTocLineIndex = Number(data.dragTocLineIndex)
+              if (!Number.isInteger(dragTocLineIndex) || dragTocLineIndex < 0) {
+                throw new Error('Missing dragTocLineIndex')
+              }
+
+              const placement =
+                data.targetType === 'group' || data.placement === 'inside'
+                  ? 'inside'
+                  : data.placement === 'after'
+                    ? 'after'
+                    : 'before'
+
+              if (
+                data.targetTocLineIndex !== undefined &&
+                data.targetTocLineIndex !== null
+              ) {
+                await tocService.moveTocEntryByLineIndex(dragTocLineIndex, {
+                  targetTocLineIndex: Number(data.targetTocLineIndex),
+                  placement,
+                })
+              } else if (
+                Array.isArray(data.targetFolderPath) &&
+                data.targetFolderPath.length > 0
+              ) {
+                await tocService.moveTocEntryByLineIndex(dragTocLineIndex, {
+                  targetType: 'folder',
+                  targetFolderPath: data.targetFolderPath.map(String),
+                  placement,
+                })
               } else {
-                throw new Error('Missing dragType')
+                const targetNoteIndex = String(
+                  data.targetNoteIndex || data.targetGroupNoteIndex || '',
+                )
+                if (!targetNoteIndex) throw new Error('Missing targetNoteIndex')
+
+                await tocService.moveTocEntryByLineIndex(dragTocLineIndex, {
+                  targetType: 'note',
+                  targetNoteIndex,
+                  placement,
+                })
               }
 
-              await readmeService.refreshHomeReadmeAndSidebar()
+              await refreshTocAndSidebar()
               return {
                 success: true,
                 sidebarChanged: true,
@@ -222,22 +322,68 @@ export function sidebarStructurePlugin(): PluginOption {
               }
             }
 
+            if (pathname === '/__tnotes_sidebar_create_folder') {
+              const parentTocLineIndex = Number(data.parentTocLineIndex)
+              const title = String(data.title || '')
+              if (
+                !Number.isInteger(parentTocLineIndex) ||
+                parentTocLineIndex < 0
+              ) {
+                throw new Error('Missing parentTocLineIndex')
+              }
+
+              await tocService.insertFolderUnderParent(
+                parentTocLineIndex,
+                title,
+              )
+              await refreshTocAndSidebar()
+
+              return {
+                success: true,
+                sidebarChanged: true,
+                message: '目录已创建',
+              }
+            }
+
             const count = normalizeCount(data.count)
             const notes = await createNotes(count)
 
             if (data.targetNoteIndex) {
               const placement = data.placement === 'after' ? 'after' : 'before'
-              await readmeService.insertNotesAroundNote(
+              await tocService.insertNotesAroundNote(
                 String(data.targetNoteIndex),
                 notes,
                 placement,
               )
+            } else if (
+              data.parentTocLineIndex !== undefined &&
+              data.parentTocLineIndex !== null
+            ) {
+              await tocService.insertNotesUnderTocLine(
+                Number(data.parentTocLineIndex),
+                notes,
+              )
+            } else if (
+              Array.isArray(data.parentFolderPath) &&
+              data.parentFolderPath.length > 0
+            ) {
+              await tocService.insertNotesUnderFolder(
+                data.parentFolderPath.map(String),
+                notes,
+              )
+            } else if (data.parentNoteIndex) {
+              await tocService.insertNotesUnderParent(
+                String(data.parentNoteIndex),
+                notes,
+              )
             } else {
-              const groupPath = normalizeGroupPath(data.groupPath)
-              await readmeService.insertNotesAtGroupStart(groupPath, notes)
+              for (const note of notes) {
+                await tocService.appendNoteToToc(note.index)
+              }
             }
 
-            await readmeService.refreshHomeReadmeAndSidebar()
+            await refreshTocAndSidebar()
+            scheduleNoteSearchReindex('api:create-notes')
 
             return {
               success: true,

package/vitepress/theme/index.ts

@@ -14,6 +14,7 @@
 
 import DefaultTheme from 'vitepress/theme'
 
+import { initTnotesSearchIndexHmr } from '../client/localSearchIndexBridge'
 import BilibiliOutsidePlayer from '../components/BilibiliOutsidePlayer/BilibiliOutsidePlayer.vue'
 import Discussions from '../components/Discussions/Discussions.vue'
 import EnWordList from '../components/EnWordList/EnWordList.vue'
@@ -27,6 +28,7 @@ import NotesTable from '../components/NotesTable/NotesTable.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'
 
@@ -88,6 +90,10 @@ function registerRenameHmrListener() {
   )
 }
 
+function registerSearchIndexHmrListener() {
+  initTnotesSearchIndexHmr()
+}
+
 /**
  * 覆盖选项
  */
@@ -116,6 +122,7 @@ export function defineNotesTheme(overrides: NotesThemeOverrides = {}): Theme {
     enhanceApp(ctx) {
       registerCoreComponents(ctx)
       registerRenameHmrListener()
+      registerSearchIndexHmrListener()
       overrides.enhanceApp?.(ctx)
     },
   }
@@ -130,5 +137,6 @@ export default {
   enhanceApp(ctx: EnhanceAppContext) {
     registerCoreComponents(ctx)
     registerRenameHmrListener()
+    registerSearchIndexHmrListener()
   },
 } satisfies Theme

package/vitepress/theme/styles/base.scss

@@ -55,12 +55,4 @@ ul > li.task-list-item > ul {
   margin: 1rem 0 1rem;
 }
 
-// 代码块外层 div
-.vp-doc div[class*=language-] {
-  // 默认值：
-  // margin: 16px 24px;
-  // 移除 margin：
-  margin: 0px !important;
-}
-
 /* #endregion */

package/vitepress/theme/styles/components/markmap.scss

@@ -16,8 +16,9 @@
   border-radius: 6px;
   box-shadow: 0 2px 12px rgba(0, 0, 0, 0.15);
   backdrop-filter: blur(8px);
-  opacity: 0;
-  pointer-events: none;
+  opacity: 1;
+  pointer-events: auto;
+  z-index: 10;
   transition: opacity 0.3s ease;
   color: var(--vp-c-tip-1);
   font-weight: 700;
@@ -73,6 +74,26 @@
   background-color: rgba(255, 255, 255, 0.1);
 }
 
+html.markmap-dark .markmapContainer,
+.markmapContainer.is-markmap-dark {
+  background-color: #1d1d1d;
+  box-shadow: 0 2px 12px rgba(0, 0, 0, 0.3);
+}
+
+html.markmap-dark .markmapContainer:hover,
+.markmapContainer.is-markmap-dark:hover {
+  box-shadow: 0 4px 20px rgba(0, 0, 0, 0.4);
+}
+
+html.markmap-dark .markmapContainer:fullscreen,
+html.markmap-dark .markmapContainer:-ms-fullscreen,
+html.markmap-dark .markmapContainer:-webkit-full-screen,
+.markmapContainer.is-markmap-dark:fullscreen,
+.markmapContainer.is-markmap-dark:-ms-fullscreen,
+.markmapContainer.is-markmap-dark:-webkit-full-screen {
+  background: #1d1d1d;
+}
+
 /* #endregion */
 
 /* ===================================== */

package/vitepress/theme/styles/components/swiper.scss

@@ -149,7 +149,7 @@
   width: 100%;
   position: relative;
   overflow: hidden;
-  margin: 1rem 0;
+  margin: 0;
   transition: height 0.3s ease;
   border-radius: 0 0 8px 8px;
   background: var(--vp-c-bg-soft);

package/vitepress/theme/styles/doc-layout.scss

@@ -0,0 +1,212 @@
+/**
+ * 文档三栏布局（语雀式）
+ * - 左目录 / 右正文目录贴齐视口左右两侧
+ * - 中间正文：超宽 / 标准 750px
+ * - 视口不足时 aside-auto-hidden / sidebar-auto-hidden
+ */
+
+:root {
+  --tn-aside-width: 300px;
+  --tn-content-standard-width: 750px;
+  --tn-content-min-width: 640px;
+  --tn-doc-layout-padding: 16px;
+}
+
+/* 取消 VitePress 1440px 居中壳：顶栏与正文区贴齐左目录、右目录 */
+@media (min-width: 960px) {
+  .VPNavBar.has-sidebar .container {
+    max-width: 100% !important;
+    margin: 0 !important;
+  }
+
+  /* 站点标题固定在视口左上方，宽度与左目录一致 */
+  .VPNavBar.has-sidebar .title {
+    left: 0 !important;
+    padding-left: var(--tn-sidebar-inset-x, 8px) !important;
+    padding-right: var(--tn-sidebar-inset-x, 8px) !important;
+    width: var(--vp-sidebar-width) !important;
+    box-sizing: border-box;
+  }
+
+  .VPNavBar.has-sidebar .divider {
+    padding-left: var(--vp-sidebar-width) !important;
+  }
+
+  .VPNavBar.has-sidebar .content {
+    padding-left: var(--vp-sidebar-width) !important;
+    padding-right: var(--tn-sidebar-inset-x, 8px) !important;
+  }
+
+  .VPContent.has-sidebar {
+    padding-left: var(--vp-sidebar-width) !important;
+    padding-right: 0 !important;
+  }
+}
+
+@media (min-width: 1440px) {
+  .VPNavBar.has-sidebar .title {
+    padding-left: var(--tn-sidebar-inset-x, 8px) !important;
+    width: var(--vp-sidebar-width) !important;
+  }
+
+  .VPNavBar.has-sidebar .divider {
+    padding-left: var(--vp-sidebar-width) !important;
+  }
+
+  .VPNavBar.has-sidebar .content {
+    padding-left: var(--vp-sidebar-width) !important;
+    padding-right: var(--tn-sidebar-inset-x, 8px) !important;
+  }
+
+  .VPContent.has-sidebar {
+    padding-left: var(--vp-sidebar-width) !important;
+    padding-right: 0 !important;
+  }
+}
+
+/* 有右栏时为正文区预留 300px，右栏 fixed 贴视口右侧 */
+@media (min-width: 1280px) {
+  html:not(.aside-auto-hidden):not(.content-fullscreen)
+    .VPContent.has-sidebar:has(.VPDoc.has-aside) {
+    padding-right: var(--tn-aside-width) !important;
+  }
+
+  .VPDoc.has-aside .aside {
+    position: fixed !important;
+    top: var(--vp-nav-height) !important;
+    right: 0 !important;
+    left: auto !important;
+    bottom: 0 !important;
+    z-index: 10;
+    order: 0 !important;
+    flex: none !important;
+    width: var(--tn-aside-width) !important;
+    max-width: var(--tn-aside-width) !important;
+    padding: 0 var(--tn-sidebar-inset-x, 8px) !important;
+    box-sizing: border-box;
+  }
+
+  .VPDoc .aside-container {
+    position: relative !important;
+    top: auto !important;
+    width: 100% !important;
+    height: 100% !important;
+    padding-top: 48px !important;
+    overflow-x: hidden;
+    overflow-y: auto;
+  }
+
+  .VPDoc .aside-curtain {
+    width: 100% !important;
+  }
+
+  /* aside 已 fixed，container 不再为右栏预留 flex 列 */
+  .VPDoc.has-aside .container {
+    display: block !important;
+    max-width: none !important;
+  }
+
+  .VPDoc.has-aside .content {
+    width: 100% !important;
+    max-width: none !important;
+    min-width: 0 !important;
+    margin: 0 !important;
+    padding: 48px var(--tn-sidebar-inset-x, 8px) 128px !important;
+    box-sizing: border-box;
+  }
+}
+
+/* 正文页宽模式 */
+html.content-width-wide .VPDoc.has-aside .content-container {
+  max-width: none !important;
+}
+
+html.content-width-standard .VPDoc.has-aside .content-container {
+  max-width: var(--tn-content-standard-width) !important;
+  margin-inline: auto !important;
+}
+
+html.content-width-standard .VPDoc:not(.has-aside) .content-container {
+  max-width: var(--tn-content-standard-width) !important;
+  margin-inline: auto !important;
+}
+
+/* 视口不足：先隐藏右侧正文目录 */
+html.aside-auto-hidden .VPDoc .aside {
+  display: none !important;
+}
+
+html.aside-auto-hidden .VPDoc.has-aside .content {
+  max-width: none !important;
+}
+
+html.aside-auto-hidden .VPContent.has-sidebar {
+  padding-right: 0 !important;
+}
+
+/* 视口仍不足：自动折叠左目录（仅桌面；移动端由 VitePress 抽屉侧栏负责） */
+@media (min-width: 960px) {
+  html.sidebar-auto-hidden .VPSidebar {
+    padding-left: 0 !important;
+    padding-right: 0 !important;
+    overflow: hidden;
+    transform: translateX(-100%);
+    pointer-events: none;
+    transition: transform 0.25s ease, opacity 0.25s ease;
+  }
+
+  html.sidebar-auto-hidden .VPNavBar.has-sidebar .VPNavBarTitle {
+    display: none !important;
+  }
+
+  html.sidebar-auto-hidden .VPNavBar.has-sidebar {
+    background-color: var(--vp-nav-bg-color) !important;
+  }
+
+  html.sidebar-auto-hidden .VPNavBar.has-sidebar .divider {
+    padding-left: 0 !important;
+  }
+
+  html.sidebar-auto-hidden .VPNavBar.has-sidebar .content {
+    padding-left: 0 !important;
+  }
+
+  html.sidebar-auto-hidden .VPContent.has-sidebar {
+    margin-left: 0 !important;
+    padding-left: 0 !important;
+  }
+}
+
+/* 全屏内容模式：隐藏右栏，正文横向铺满视口（覆盖标准/超宽页宽） */
+html.content-fullscreen {
+  .VPDoc .aside {
+    display: none !important;
+  }
+
+  .VPContent.has-sidebar {
+    padding-left: 0 !important;
+    padding-right: 0 !important;
+  }
+
+  .VPDoc.has-aside .container,
+  .VPDoc .container {
+    max-width: none !important;
+    width: 100% !important;
+  }
+
+  .VPDoc.has-aside .content,
+  .VPDoc .content {
+    max-width: none !important;
+    width: 100% !important;
+    margin: 0 !important;
+    padding: 48px var(--tn-sidebar-inset-x, 8px) 128px !important;
+    box-sizing: border-box;
+  }
+
+  &.content-width-standard .VPDoc .content-container,
+  &.content-width-wide .VPDoc .content-container {
+    max-width: none !important;
+    width: 100% !important;
+    margin-inline: 0 !important;
+  }
+}