@tnotesjs/core 0.2.2 → 0.4.0

package/vitepress/components/SidebarCard/SidebarCard.vue

@@ -9,13 +9,13 @@ import { ref, computed, watch } from 'vue'
 import {
   icon__fold,
   icon__github,
-  icon__vscode,
   icon__folder,
   icon__search,
   icon__number_gray,
   icon__number_purple,
 } from '../../assets/icons'
 import { NOTES_DIR_KEY, REPO_NAME, AUTHOR, ROOT_ITEM } from '../constants.ts'
+import { useLocalIde } from '../composables/useLocalIde'
 import FolderTreeItems from './FolderTreeItems.vue'
 import NotesTrendChart from './NotesTrendChart.vue'
 import { useSettingsDialog } from '../Settings/composables/useSettingsDialog'
@@ -29,9 +29,7 @@ import {
 import {
   getRepoRootPath,
   resolveNoteReadmePath,
-  toVscodeFileUrl,
 } from '../utils/vscodePaths'
-import { formatDate } from '../utils.ts'
 
 // #region props
 const props = defineProps({
@@ -46,6 +44,14 @@ const props = defineProps({
 })
 // #endregion
 
+const {
+  icon: localIdeIcon,
+  openNoteTitle,
+  openRepoTitle,
+  openReadmeTitle,
+  toFileUrl,
+} = useLocalIde()
+
 // #region data
 const viewMode = ref('folder')
 const expandedTreeKeys = ref(new Set())
@@ -217,7 +223,7 @@ function openGithubRepo() {
   window.open(`https://github.com/${AUTHOR}/${REPO_NAME}`, '_blank')
 }
 
-// 打开 VS Code 知识库
+// 打开本地 IDE 知识库
 function openVSCodeRepo() {
   const notesDir = localStorage.getItem(NOTES_DIR_KEY)
 
@@ -231,10 +237,10 @@ function openVSCodeRepo() {
     return
   }
 
-  window.open('vscode://file/' + notesDir, '_blank')
+  window.open(toFileUrl(notesDir), '_blank')
 }
 
-// 打开 VS Code 中的笔记 README.md
+// 在本地 IDE 中打开笔记 README.md
 function openVSCodeArticle(article) {
   const notesDir = localStorage.getItem(NOTES_DIR_KEY)
 
@@ -251,7 +257,7 @@ function openVSCodeArticle(article) {
   const notePath = resolveNoteReadmePath(notesDir, article.relativePath)
   if (!notePath) return
 
-  window.open(toVscodeFileUrl(notePath), '_blank')
+  window.open(toFileUrl(notePath), '_blank')
 }
 
 function openVSCodeReadme() {
@@ -268,7 +274,7 @@ function openVSCodeReadme() {
   }
 
   const readmePath = `${getRepoRootPath(notesDir)}/README.md`
-  window.open(toVscodeFileUrl(readmePath), '_blank')
+  window.open(toFileUrl(readmePath), '_blank')
 }
 </script>
 
@@ -318,9 +324,9 @@ function openVSCodeReadme() {
           <img :src="icon__github" alt="GitHub仓库" />
         </button>
 
-        <!-- VS Code 按钮 -->
-        <button class="vscode-open" @click="openVSCodeRepo">
-          <img :src="icon__vscode" alt="使用 VS Code 打开本地知识库" />
+        <!-- 本地 IDE 按钮 -->
+        <button class="vscode-open" @click="openVSCodeRepo" :title="openRepoTitle">
+          <img :src="localIdeIcon" :alt="openRepoTitle" />
         </button>
 
         <!-- 关于按钮 -->
@@ -346,18 +352,6 @@ function openVSCodeReadme() {
               {{ AUTHOR }}/{{ REPO_NAME }}
             </a>
           </div>
-          <div class="about-item">
-            <span class="about-label">📅 创建时间</span>
-            <span class="about-value">{{
-              formatDate(ROOT_ITEM.created_at)
-            }}</span>
-          </div>
-          <div class="about-item">
-            <span class="about-label">♻️ 最近更新</span>
-            <span class="about-value">{{
-              formatDate(ROOT_ITEM.updated_at)
-            }}</span>
-          </div>
         </div>
       </div>
     </div>
@@ -395,9 +389,9 @@ function openVSCodeReadme() {
           <button
             class="vscode-article"
             @click.stop="openVSCodeArticle(article)"
-            title="在 VS Code 中打开笔记目录"
+            :title="openNoteTitle"
           >
-            <img :src="icon__vscode" alt="打开笔记目录" />
+            <img :src="localIdeIcon" :alt="openNoteTitle" />
           </button>
         </div>
       </div>
@@ -415,10 +409,10 @@ function openVSCodeReadme() {
           <button
             class="vscode-article"
             type="button"
-            title="在 VS Code 中打开 README.md"
+            :title="openReadmeTitle"
             @click="openVSCodeReadme"
           >
-            <img :src="icon__vscode" alt="打开 README.md" />
+            <img :src="localIdeIcon" :alt="openReadmeTitle" />
           </button>
         </div>
         <FolderTreeItems

package/vitepress/components/composables/useLocalIde.ts

@@ -0,0 +1,83 @@
+/**
+ * vitepress/components/composables/useLocalIde.ts
+ *
+ * 本地 IDE（VS Code / Cursor）选择状态与展示信息
+ */
+
+import { computed, ref } from 'vue'
+
+import { icon__cursor, icon__vscode } from '../../assets/icons'
+import { LOCAL_IDE_KEY } from '../constants'
+import {
+  DEFAULT_LOCAL_IDE,
+  normalizeLocalIde,
+  toIdeFileUrl,
+  type LocalIdeId,
+} from '../utils/vscodePaths'
+
+const ide = ref<LocalIdeId>(DEFAULT_LOCAL_IDE)
+let hydrated = false
+
+function readIdeFromStorage(): LocalIdeId {
+  if (typeof window === 'undefined') return DEFAULT_LOCAL_IDE
+  return normalizeLocalIde(localStorage.getItem(LOCAL_IDE_KEY))
+}
+
+function hydrateFromStorage() {
+  if (typeof window === 'undefined' || hydrated) return
+  ide.value = readIdeFromStorage()
+  hydrated = true
+}
+
+export function useLocalIde() {
+  hydrateFromStorage()
+
+  const icon = computed(() =>
+    ide.value === 'cursor' ? icon__cursor : icon__vscode,
+  )
+
+  const shortLabel = computed(() =>
+    ide.value === 'cursor' ? 'Cursor' : 'VS Code',
+  )
+
+  const openNoteTitle = computed(
+    () => `用 ${shortLabel.value} 打开笔记目录`,
+  )
+  const openRepoTitle = computed(
+    () => `用 ${shortLabel.value} 打开本地知识库`,
+  )
+  const openReadmeTitle = computed(
+    () => `用 ${shortLabel.value} 打开 README.md`,
+  )
+  const openCurrentTitle = computed(
+    () => `用 ${shortLabel.value} 打开当前笔记`,
+  )
+
+  function setLocalIde(next: LocalIdeId) {
+    ide.value = normalizeLocalIde(next)
+    if (typeof window !== 'undefined') {
+      localStorage.setItem(LOCAL_IDE_KEY, ide.value)
+    }
+  }
+
+  function refreshLocalIde() {
+    ide.value = readIdeFromStorage()
+  }
+
+  function toFileUrl(filePath: string) {
+    return toIdeFileUrl(filePath, ide.value)
+  }
+
+  return {
+    ide,
+    icon,
+    shortLabel,
+    openNoteTitle,
+    openRepoTitle,
+    openReadmeTitle,
+    openCurrentTitle,
+    setLocalIde,
+    refreshLocalIde,
+    toFileUrl,
+  }
+}

package/vitepress/components/constants.ts

@@ -37,6 +37,11 @@ export const ROOT_ITEM = __TNOTES_ROOT_ITEM__
  */
 export const NOTES_DIR_KEY: string = 'NOTES_DIR_KEY__' + REPO_NAME
 
+/**
+ * 本地打开所用 IDE（vscode | cursor）
+ */
+export const LOCAL_IDE_KEY: string = 'LOCAL_IDE_KEY__' + REPO_NAME
+
 /**
  * 用户选择的视图
  */
@@ -53,12 +58,6 @@ export const EN_WORD_LIST_COMP_IS_AUTO_SHOW_CARD: string =
  */
 export const MARKMAP_THEME_KEY: string = 'MARKMAP_THEME_KEY__' + REPO_NAME
 
-/**
- * MarkMap 默认展开层级配置
- */
-export const MARKMAP_EXPAND_LEVEL_KEY: string =
-  'MARKMAP_EXPAND_LEVEL_KEY__' + REPO_NAME
-
 /**
  * 侧边栏是否显示笔记编号配置
  */

package/vitepress/components/utils/vscodePaths.test.ts

@@ -2,7 +2,9 @@ import { describe, expect, it } from 'vitest'
 
 import {
   getRepoRootPath,
+  normalizeLocalIde,
   resolveNoteReadmePath,
+  toIdeFileUrl,
   toVscodeFileUrl,
 } from './vscodePaths'
 
@@ -33,6 +35,26 @@ describe('vscodePaths', () => {
     )
   })
 
+  it('normalizeLocalIde falls back to vscode', () => {
+    expect(normalizeLocalIde(null)).toBe('vscode')
+    expect(normalizeLocalIde('')).toBe('vscode')
+    expect(normalizeLocalIde('foo')).toBe('vscode')
+    expect(normalizeLocalIde('cursor')).toBe('cursor')
+    expect(normalizeLocalIde('vscode')).toBe('vscode')
+  })
+
+  it('toIdeFileUrl uses vscode scheme by default', () => {
+    expect(toIdeFileUrl('C:\\notes\\0001\\README.md')).toContain(
+      'vscode://file/',
+    )
+  })
+
+  it('toIdeFileUrl uses cursor scheme when selected', () => {
+    expect(toIdeFileUrl('C:\\notes\\0001\\README.md', 'cursor')).toContain(
+      'cursor://file/',
+    )
+  })
+
   it('toVscodeFileUrl encodes file path', () => {
     expect(toVscodeFileUrl('C:\\notes\\0001\\README.md')).toContain(
       'vscode://file/',

package/vitepress/components/utils/vscodePaths.ts

@@ -1,10 +1,19 @@
 /**
  * vitepress/components/utils/vscodePaths.ts
  *
- * 将站点内路径解析为本地 VS Code 可打开的文件路径。
+ * 将站点内路径解析为本地 IDE 可打开的文件路径与 URL。
  * NOTES_DIR 通常配置为仓库下的 notes 目录（如 .../TNotes.introduction/notes）。
  */
 
+export type LocalIdeId = 'vscode' | 'cursor'
+
+export const DEFAULT_LOCAL_IDE: LocalIdeId = 'vscode'
+
+const IDE_SCHEMES: Record<LocalIdeId, string> = {
+  vscode: 'vscode',
+  cursor: 'cursor',
+}
+
 export function getRepoRootPath(notesDir: string): string {
   const normalized = notesDir.replace(/[/\\]+$/, '')
   if (/[/\\]notes$/i.test(normalized)) {
@@ -47,6 +56,19 @@ export function resolveNoteReadmePath(
   return `${base}${sep}${folderPath}${sep}README.md`
 }
 
+export function normalizeLocalIde(value: string | null | undefined): LocalIdeId {
+  return value === 'cursor' ? 'cursor' : DEFAULT_LOCAL_IDE
+}
+
+export function toIdeFileUrl(
+  filePath: string,
+  ide: LocalIdeId = DEFAULT_LOCAL_IDE,
+): string {
+  const scheme = IDE_SCHEMES[normalizeLocalIde(ide)]
+  return `${scheme}://file/${encodeURI(filePath)}`
+}
+
+/** @deprecated 使用 toIdeFileUrl(filePath, 'vscode') */
 export function toVscodeFileUrl(filePath: string): string {
-  return `vscode://file/${encodeURI(filePath)}`
+  return toIdeFileUrl(filePath, 'vscode')
 }

package/vitepress/configs/markdown.config.ts

@@ -11,6 +11,11 @@ import markdownItTaskLists from 'markdown-it-task-lists'
 import path from 'path'
 
 import { generateAnchor } from '../../utils'
+import {
+  normalizeMindmapMarkdown,
+  parseMarkmapFence,
+  parseMindmapReference,
+} from '../components/MindmapPreview/compat'
 
 import type MarkdownIt from 'markdown-it'
 import type { MarkdownOptions } from 'vitepress'
@@ -66,17 +71,13 @@ const simpleMermaidMarkdown = (md: MarkdownIt) => {
 }
 
 /**
- * MarkMap 容器配置
+ * Mindmap 容器配置（兼容旧的 markmap 围栏名）
  */
-function configureMarkMapContainer(md: MarkdownIt) {
-  // 先保留 container 的解析（负责把 ```markmap ``` 识别成 container tokens）
-  // 但让它本身不输出任何 HTML（render 返回空）
+function configureMindmapContainer(md: MarkdownIt) {
   md.use(markdownItContainer, 'markmap', {
     marker: '`',
     validate(params: string) {
-      // 接受 "markmap", "markmap{...}" 或 "markmap key=val ..." 等写法
-      const p = (params || '').trim()
-      return p.startsWith('markmap')
+      return (params || '').trim().startsWith('markmap')
     },
     render() {
       return ''
@@ -93,11 +94,13 @@ function configureMarkMapContainer(md: MarkdownIt) {
     for (let i = 0; i < tokens.length; i++) {
       const t = tokens[i]
       if (t.type === 'container_markmap_open') {
+        const containerName = 'markmap'
+        const closeType = 'container_markmap_close'
         // 找到对应的 close token
         let j = i + 1
         while (
           j < tokens.length &&
-          tokens[j].type !== 'container_markmap_close'
+          tokens[j].type !== closeType
         )
           j++
         if (j >= tokens.length) continue // safety
@@ -109,9 +112,12 @@ function configureMarkMapContainer(md: MarkdownIt) {
 
         // 1) 从开头 fence 行解析参数（支持 `{a=1 b="x"}`、`a=1 b="x"`，并支持单个数字 shorthand）
         const params: { [key: string]: any; initialExpandLevel?: number } = {}
+        let explicitTitle: string | undefined
 
         if (open.map && typeof open.map[0] === 'number') {
           const openLine = (lines[open.map[0]] || '').trim()
+          const fenceOptions = parseMarkmapFence(openLine)
+          explicitTitle = fenceOptions.title
           let paramPart = ''
 
           // 优先匹配大括号形式 ```markmap{...}
@@ -121,10 +127,13 @@ function configureMarkMapContainer(md: MarkdownIt) {
           } else {
             // 否则尝试去掉前缀 ``` 和 markmap，剩下的作为参数部分
             const after = openLine.replace(/^`+\s*/, '')
-            if (after.startsWith('markmap')) {
-              paramPart = after.slice('markmap'.length).trim()
+            if (after.startsWith(containerName)) {
+              paramPart = after.slice(containerName.length).trim()
             }
           }
+          if (fenceOptions.initialExpandLevel !== undefined) {
+            params.initialExpandLevel = fenceOptions.initialExpandLevel
+          }
 
           if (paramPart) {
             // 使用正则按 token 切分：保持用引号包裹的片段为单个 token（支持包含空格）
@@ -179,10 +188,11 @@ function configureMarkMapContainer(md: MarkdownIt) {
         // --- 检查第一非空行是否为引用语法 ---
         const firstNonEmptyLine =
           (content || '').split('\n').find((ln) => ln.trim() !== '') || ''
-        const refMatch = firstNonEmptyLine.trim().match(/^<<<\s*(.+)$/)
-        if (refMatch) {
-          // 提取引用路径，支持引号包裹
-          const refRaw = refMatch[1].trim().replace(/^['"]|['"]$/g, '')
+        const reference = parseMindmapReference(firstNonEmptyLine)
+        let referencedTitle: string | undefined
+        if (reference) {
+          const refRaw = reference.path
+          referencedTitle = reference.title
 
           // 尝试同步读取文件内容（兼容常见 Node 环境）
           try {
@@ -213,12 +223,14 @@ function configureMarkMapContainer(md: MarkdownIt) {
           } catch (err) {
             // 读取失败：将错误写入 content 以便排查（不会让流程直接崩溃）
             const errorMsg = err instanceof Error ? err.message : String(err)
-            content = `Failed to load referenced file: ${esc(
-              String(refRaw)
-            )}\n\nError: ${esc(errorMsg)}`
+            content = `- Failed to load referenced file: ${esc(String(refRaw))}\n  - Error: ${esc(errorMsg)}`
           }
         }
 
+        content = normalizeMindmapMarkdown(content, {
+          title: explicitTitle || referencedTitle,
+        })
+
         // 3) 构造组件标签并把参数注入为 props
         const encodedContent = encodeURIComponent(content.trim())
         let propsStr = `content="${encodedContent}"`
@@ -232,7 +244,7 @@ function configureMarkMapContainer(md: MarkdownIt) {
           }
         }
 
-        const html = `<MarkMap ${propsStr}></MarkMap>\n`
+        const html = `<MindmapPreview ${propsStr}></MindmapPreview>\n`
 
         // 创建 html_block token
         const htmlToken = new state.Token('html_block', '', 0)
@@ -247,6 +259,50 @@ function configureMarkMapContainer(md: MarkdownIt) {
   })
 }
 
+/** Canonical `mindmap` fence. Legacy `markmap` stays on its historical container path. */
+function configureMindmapFence(md: MarkdownIt) {
+  const fence = md.renderer.rules.fence
+    ? md.renderer.rules.fence.bind(md.renderer.rules)
+    : () => ''
+
+  md.renderer.rules.fence = (tokens, index, options, env, slf) => {
+    const token = tokens[index]
+    const info = token.info.trim()
+    if (!/^mindmap(?=\s|\{|\[|$)/.test(info)) {
+      return fence(tokens, index, options, env, slf)
+    }
+
+    const fenceOptions = parseMarkmapFence(info)
+    let content = token.content
+    const firstNonEmptyLine = content.split('\n').find((line) => line.trim()) ?? ''
+    const reference = parseMindmapReference(firstNonEmptyLine)
+
+    if (reference) {
+      const possibleRel = env?.relativePath || env?.path || env?.filePath || env?.file || ''
+      const refFullPath = path.isAbsolute(reference.path)
+        ? reference.path
+        : path.resolve(process.cwd(), possibleRel ? path.dirname(possibleRel) : '', reference.path)
+      try {
+        content = fs.readFileSync(refFullPath, 'utf8')
+      } catch (error) {
+        const message = error instanceof Error ? error.message : String(error)
+        content = `- Failed to load referenced file: ${reference.path}\n  - Error: ${message}`
+      }
+    }
+
+    content = normalizeMindmapMarkdown(content, {
+      title: fenceOptions.title || reference?.title,
+    })
+    const props = [
+      `content="${encodeURIComponent(content.trim())}"`,
+      fenceOptions.initialExpandLevel === undefined
+        ? ''
+        : `:initialExpandLevel="${fenceOptions.initialExpandLevel}"`,
+    ].filter(Boolean).join(' ')
+    return `<MindmapPreview ${props}></MindmapPreview>\n`
+  }
+}
+
 /**
  * Swiper 容器配置
  */
@@ -340,8 +396,9 @@ export function getMarkdownConfig(): MarkdownOptions {
       // 添加 Mermaid 支持
       simpleMermaidMarkdown(md)
 
-      // 添加 MarkMap 支持
-      configureMarkMapContainer(md)
+      // 添加 Mindmap 支持，并继续兼容旧 MarkMap 围栏
+      configureMindmapContainer(md)
+      configureMindmapFence(md)
 
       // 添加任务列表支持
       md.use(markdownItTaskLists)

package/vitepress/theme/index.ts

@@ -22,8 +22,8 @@ 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 MarkMap from '../components/MarkMap/MarkMap.vue'
 import Mermaid from '../components/Mermaid/Mermaid.vue'
+import MindmapPreview from '../components/MindmapPreview/MindmapPreview.vue'
 import NotesTable from '../components/NotesTable/NotesTable.vue'
 import SidebarCard from '../components/SidebarCard/SidebarCard.vue'
 import Tooltip from '../components/Tooltip/Tooltip.vue'
@@ -45,7 +45,9 @@ function registerCoreComponents(ctx: EnhanceAppContext) {
   app.component('Footprints', Footprints)
   app.component('F', Footprints)
   app.component('SidebarCard', SidebarCard)
-  app.component('MarkMap', MarkMap)
+  // Keep the historical component name so existing note fences need no migration.
+  app.component('MarkMap', MindmapPreview)
+  app.component('MindmapPreview', MindmapPreview)
   app.component('Mermaid', Mermaid)
   app.component('NotesTable', NotesTable)
   app.component('N', NotesTable)

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

@@ -100,8 +100,8 @@
     width: 100% !important;
   }
 
-  /* aside 已 fixed，container 不再为右栏预留 flex 列 */
-  .VPDoc.has-aside .container {
+  /* aside 已 fixed，仅改 VPDoc 直接子级 container，避免误伤 DocFooter 等内部 .container */
+  .VPDoc.has-aside > .container {
     display: block !important;
     max-width: none !important;
   }
@@ -188,8 +188,8 @@ html.content-fullscreen {
     padding-right: 0 !important;
   }
 
-  .VPDoc.has-aside .container,
-  .VPDoc .container {
+  .VPDoc.has-aside > .container,
+  .VPDoc > .container {
     max-width: none !important;
     width: 100% !important;
   }

package/vitepress/theme/styles/index.scss

@@ -17,7 +17,6 @@
 
 /* 4. 组件全局层：跨组件共享的样式 */
 @use './components/swiper';
-@use './components/markmap';
 @use './components/collapse';
 /**
  * !404 不是一个有效的 Sass 标识符（不能以数字开头），需要为它添加一个别名

package/services/timestamp/index.ts

@@ -1,7 +0,0 @@
-/**
- * services/timestamp/index.ts
- *
- * Timestamp 服务入口
- */
-
-export { TimestampService } from './service'