@tnotesjs/core 0.2.1 → 0.3.0

package/utils/tocNodeId.test.ts

@@ -0,0 +1,60 @@
+/**
+ * utils/tocNodeId.test.ts
+ */
+
+import { describe, expect, it } from 'vitest'
+
+import {
+  computeSidebarNodeId,
+  enrichSidebarNodeIds,
+  nodeIdForNote,
+  parseNodeId,
+} from './tocNodeId'
+
+import type { SidebarNodeLike } from './tocNodeId'
+
+describe('tocNodeId', () => {
+  it('computes note nodeId', () => {
+    expect(
+      computeSidebarNodeId({
+        text: '✅ 0019. Author',
+        link: '/notes/0019. Author/README',
+        tocLineIndex: 0,
+      }),
+    ).toBe(nodeIdForNote('0019'))
+  })
+
+  it('computes folder nodeId from tocLineIndex', () => {
+    expect(
+      computeSidebarNodeId({
+        text: 'build',
+        folderPath: ['build'],
+        tocLineIndex: 12,
+      }),
+    ).toBe('line:12')
+  })
+
+  it('enriches tree recursively', () => {
+    const tree = enrichSidebarNodeIds<SidebarNodeLike>([
+      {
+        text: 'Parent',
+        link: '/notes/0019. Author/README',
+        tocLineIndex: 0,
+        items: [{ text: 'Child', link: '/notes/0039. new/README', tocLineIndex: 1 }],
+      },
+    ])
+    expect(tree[0].nodeId).toBe('note:0019')
+    expect(tree[0].items?.[0].nodeId).toBe('note:0039')
+  })
+
+  it('parses nodeId kinds', () => {
+    expect(parseNodeId('note:0019')).toEqual({
+      kind: 'note',
+      noteIndex: '0019',
+    })
+    expect(parseNodeId('line:34')).toEqual({
+      kind: 'line',
+      tocLineIndex: 34,
+    })
+  })
+})

package/utils/tocNodeId.ts

@@ -0,0 +1,97 @@
+/**
+ * utils/tocNodeId.ts
+ *
+ * 语雀式拖拽 nodeId：dev 确定性 id，不写 TOC.md。
+ */
+
+export type TocMoveAction = 'moveAfter' | 'prependChild'
+
+export interface SidebarNodeLike {
+  text: string
+  link?: string
+  folderPath?: string[]
+  tocLineIndex?: number
+  nodeId?: string
+  items?: SidebarNodeLike[]
+}
+
+function extractNoteIndexFromLink(link?: string): string | null {
+  if (!link) return null
+  const match = link.match(/\/notes\/(\d{4})\./)
+  return match ? match[1] : null
+}
+
+export interface SidebarNodeLike {
+  text: string
+  link?: string
+  folderPath?: string[]
+  tocLineIndex?: number
+  nodeId?: string
+  items?: SidebarNodeLike[]
+}
+
+export function nodeIdForNote(noteIndex: string): string {
+  return `note:${noteIndex}`
+}
+
+export function nodeIdForFolder(folderPath: string[]): string {
+  return `folder:${folderPath.join('/')}`
+}
+
+export function nodeIdForLine(tocLineIndex: number): string {
+  return `line:${tocLineIndex}`
+}
+
+export function computeSidebarNodeId(item: SidebarNodeLike): string {
+  if (item.nodeId) return item.nodeId
+
+  const noteIndex = extractNoteIndexFromLink(item.link)
+  if (noteIndex) return nodeIdForNote(noteIndex)
+
+  if (item.tocLineIndex !== undefined && !item.link) {
+    return nodeIdForLine(item.tocLineIndex)
+  }
+
+  if (item.folderPath?.length) {
+    return nodeIdForFolder(item.folderPath)
+  }
+
+  if (item.tocLineIndex !== undefined) {
+    return nodeIdForLine(item.tocLineIndex)
+  }
+
+  return `text:${item.text}`
+}
+
+export function enrichSidebarNodeIds<T extends SidebarNodeLike>(items: T[]): T[] {
+  return items.map((item) => {
+    const nodeId = computeSidebarNodeId(item)
+    const next = { ...item, nodeId } as T
+    if (item.items?.length) {
+      next.items = enrichSidebarNodeIds(item.items) as T['items']
+    }
+    return next
+  })
+}
+
+export function parseNodeId(nodeId: string): {
+  kind: 'note' | 'folder' | 'line' | 'text'
+  noteIndex?: string
+  folderPath?: string[]
+  tocLineIndex?: number
+} {
+  if (nodeId.startsWith('note:')) {
+    return { kind: 'note', noteIndex: nodeId.slice(5) }
+  }
+  if (nodeId.startsWith('folder:')) {
+    const path = nodeId.slice(7)
+    return {
+      kind: 'folder',
+      folderPath: path ? path.split('/') : [],
+    }
+  }
+  if (nodeId.startsWith('line:')) {
+    return { kind: 'line', tocLineIndex: Number(nodeId.slice(5)) }
+  }
+  return { kind: 'text' }
+}

package/utils/validators.ts

@@ -0,0 +1,102 @@
+/**
+ * utils/validators.ts
+ *
+ * 验证工具函数
+ */
+
+/**
+ * Windows 和 macOS 都不允许的文件名字符
+ * Windows: < > : " / \ | ? *
+ * macOS: : (冒号会被转换为斜杠)
+ *
+ * 为了兼容性,我们禁止以下字符:
+ * - < > : " / \ | ? *
+ * - 控制字符 (0x00-0x1F)
+ */
+const INVALID_FILENAME_CHARS = /[<>:"/\\|?*\x00-\x1F]/
+
+/**
+ * Windows 保留文件名
+ */
+const WINDOWS_RESERVED_NAMES = new Set([
+  'CON',
+  'PRN',
+  'AUX',
+  'NUL',
+  'COM1',
+  'COM2',
+  'COM3',
+  'COM4',
+  'COM5',
+  'COM6',
+  'COM7',
+  'COM8',
+  'COM9',
+  'LPT1',
+  'LPT2',
+  'LPT3',
+  'LPT4',
+  'LPT5',
+  'LPT6',
+  'LPT7',
+  'LPT8',
+  'LPT9',
+])
+
+/**
+ * 验证标题是否为合法的文件夹名称
+ * @param title - 笔记标题
+ * @returns 验证结果 { valid: boolean, error?: string }
+ */
+export function validateNoteTitle(title: string): {
+  valid: boolean
+  error?: string
+} {
+  // 检查是否为空
+  if (!title || title.trim().length === 0) {
+    return { valid: false, error: '标题不能为空' }
+  }
+
+  const trimmedTitle = title.trim()
+
+  // 检查长度 (Windows 路径限制 260 字符,留足够空间)
+  if (trimmedTitle.length > 200) {
+    return { valid: false, error: '标题过长(最多200个字符)' }
+  }
+
+  // 检查是否包含非法字符
+  if (INVALID_FILENAME_CHARS.test(trimmedTitle)) {
+    return {
+      valid: false,
+      error: '标题包含非法字符(不允许: < > : " / \\ | ? *)',
+    }
+  }
+
+  // 检查是否以点或空格开头/结尾 (Windows 限制)
+  if (/^[.\s]|[.\s]$/.test(trimmedTitle)) {
+    return {
+      valid: false,
+      error: '标题不能以点或空格开头/结尾',
+    }
+  }
+
+  // 检查 Windows 保留名称
+  const upperTitle = trimmedTitle.toUpperCase()
+  if (WINDOWS_RESERVED_NAMES.has(upperTitle)) {
+    return {
+      valid: false,
+      error: `"${trimmedTitle}" 是 Windows 系统保留名称`,
+    }
+  }
+
+  // 检查是否为 Windows 保留名称加扩展名 (例如 CON.txt)
+  const baseName = trimmedTitle.split('.')[0].toUpperCase()
+  if (WINDOWS_RESERVED_NAMES.has(baseName)) {
+    return {
+      valid: false,
+      error: `"${trimmedTitle}" 包含 Windows 系统保留名称`,
+    }
+  }
+
+  return { valid: true }
+}

package/vitepress/assets/icons/icon__cursor.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1em" height="1em" viewBox="0 0 128 128">
+	<path d="M0 0h128v128H0z" fill="none" />
+	<path fill="#656cff" fill-rule="evenodd" d="M117.9 30.289L66.664.713a5.32 5.32 0 0 0-5.323 0L10.09 30.29a4.48 4.48 0 0 0-2.234 3.872v59.663c0 1.6.853 3.077 2.24 3.878l51.24 29.586a5.33 5.33 0 0 0 5.324 0l51.246-29.586a4.48 4.48 0 0 0 2.24-3.878V34.166a4.48 4.48 0 0 0-2.24-3.872zm-3.216 6.272l-49.47 85.681c-.337.576-1.217.341-1.217-.325V65.81a3.15 3.15 0 0 0-1.573-2.72l-48.59-28.055c-.571-.331-.336-1.216.33-1.216h98.94c1.409 0 2.284 1.525 1.58 2.741" />
+</svg>

package/vitepress/assets/icons/index.ts

@@ -14,6 +14,7 @@ export { default as icon__close } from './icon__close.svg'
 export { default as icon__collapse } from './icon__collapse.svg'
 export { default as icon__confirm } from './icon__confirm.svg'
 export { default as icon__copy } from './icon__copy.svg'
+export { default as icon__cursor } from './icon__cursor.svg'
 export { default as icon__focus } from './icon__focus.svg'
 export { default as icon__fold } from './icon__fold.svg'
 export { default as icon__folder } from './icon__folder.svg'

package/vitepress/components/Layout/AboutPanel.vue

@@ -107,22 +107,6 @@ vitepress/components/Layout/AboutPanel.vue
       </div>
     </div>
 
-    <!-- 首次提交时间 -->
-    <div class="timeLine" title="首次提交时间">
-      <div class="timeLabel"><strong>⌛️ 首次提交</strong></div>
-      <div class="timeValue">
-        {{ formatOptionalDate(modalCreatedAt) }}
-      </div>
-    </div>
-
-    <!-- 最近提交时间 -->
-    <div class="timeLine" title="最近提交时间">
-      <div class="timeLabel"><strong>⌛️ 最近提交</strong></div>
-      <div class="timeValue">
-        {{ formatOptionalDate(modalUpdatedAt) }}
-      </div>
-    </div>
-
     <!-- GitHub -->
     <div
       class="timeLine"
@@ -196,8 +180,6 @@ vitepress/components/Layout/AboutPanel.vue
 <script setup lang="ts">
 import { computed } from 'vue'
 
-import { formatDate } from '../utils'
-
 const props = defineProps<{
   isHomeReadme: boolean
   currentNoteId: string | null
@@ -207,8 +189,6 @@ const props = defineProps<{
   editableNoteStatus: boolean
   editableDiscussionsEnabled: boolean
   titleError: string
-  modalCreatedAt: number | undefined
-  modalUpdatedAt: number | undefined
   modalGithubUrl: string
   modalGithubPageUrl: string
   completionPercentage: number | null
@@ -263,10 +243,6 @@ function onDescriptionInput() {
 function onConfigChange() {
   emit('configChange')
 }
-
-function formatOptionalDate(timestamp: number | undefined) {
-  return timestamp === undefined ? '-' : formatDate(timestamp)
-}
 </script>
 
 <style scoped lang="scss">

package/vitepress/components/Layout/DocBeforeControls.vue

@@ -14,10 +14,10 @@ vitepress/components/Layout/DocBeforeControls.vue
       <div class="vscodeBox pcOnly" v-show="vscodeNotesDir">
         <a
           :href="vscodeNotesDir"
-          title="open in vscode"
+          :title="openCurrentTitle"
           target="_blank"
         >
-          <img :src="icon__vscode" alt="open in vscode" />
+          <img :src="localIdeIcon" :alt="openCurrentTitle" />
         </a>
       </div>
       <div class="contentToggleBox pcOnly">
@@ -65,13 +65,7 @@ vitepress/components/Layout/DocBeforeControls.vue
         </button>
       </div>
       <!-- 单个图标，点击打开 modal，只在有笔记数据的页面显示 -->
-      <div
-        class="aboutBtn"
-        v-show="
-          (currentNoteId && created_at && updated_at) ||
-          (isHomeReadme && homeReadmeCreatedAt && homeReadmeUpdatedAt)
-        "
-      >
+      <div class="aboutBtn" v-show="currentNoteId || isHomeReadme">
         <button
           class="aboutIconButton"
           @click="$emit('open-time-modal')"
@@ -93,24 +87,22 @@ import ToggleFullContent from './ToggleFullContent.vue'
 import ToggleSidebar from './ToggleSidebar.vue'
 import {
   icon__github,
-  icon__vscode,
   icon__fold,
   icon__clipboard,
 } from '../../assets/icons'
+import { useLocalIde } from '../composables/useLocalIde'
 
 const props = defineProps<{
   isFullContentMode: boolean
   vscodeNotesDir: string
   isHomeReadme: boolean
   currentNoteId: string | null
-  created_at: string | undefined
-  updated_at: string | undefined
-  homeReadmeCreatedAt: string | undefined
-  homeReadmeUpdatedAt: string | undefined
   timeModalOpen: boolean
   allCollapsed: boolean
 }>()
 
+const { icon: localIdeIcon, openCurrentTitle } = useLocalIde()
+
 const showCopyToast = ref(false)
 let copyToastTimer: ReturnType<typeof setTimeout> | null = null
 

package/vitepress/components/Layout/DocFooter.vue

@@ -4,7 +4,7 @@ vitepress/components/Layout/DocFooter.vue
 
 <template>
   <nav class="custom-doc-footer" v-if="prev || next">
-    <div class="container">
+    <div class="pager-container">
       <div class="prev">
         <a v-if="prev" :href="prev.link" class="pager-link prev-link">
           <span class="desc">上一篇</span>
@@ -147,7 +147,7 @@ const next = computed(() => {
   padding-top: 32px;
 }
 
-.container {
+.pager-container {
   display: flex;
   gap: 16px;
 }
@@ -219,7 +219,7 @@ const next = computed(() => {
 
 /* 响应式调整 */
 @media (max-width: 768px) {
-  .container {
+  .pager-container {
     flex-direction: column;
     gap: 12px;
   }

package/vitepress/components/Layout/Layout.vue

@@ -32,10 +32,6 @@ vitepress/components/Layout/Layout.vue
         :vscode-notes-dir="vscodeNotesDir"
         :is-home-readme="isHomeReadme"
         :current-note-id="currentNoteId"
-        :created_at="created_at"
-        :updated_at="updated_at"
-        :home-readme-created-at="homeReadmeCreatedAt"
-        :home-readme-updated-at="homeReadmeUpdatedAt"
         :time-modal-open="timeModalOpen"
         :all-collapsed="allCollapsed"
         @open-time-modal="openTimeModal"
@@ -65,8 +61,6 @@ vitepress/components/Layout/Layout.vue
           v-model:editable-note-status="editableNoteStatus"
           v-model:editable-discussions-enabled="editableDiscussionsEnabled"
           v-model:title-error="titleError"
-          :modal-created-at="modalCreatedAt"
-          :modal-updated-at="modalUpdatedAt"
           :modal-github-url="modalGithubUrl"
           :modal-github-page-url="modalGithubPageUrl"
           :completion-percentage="completionPercentage"
@@ -116,10 +110,6 @@ vitepress/components/Layout/Layout.vue
       </AboutModal>
     </template>
     <template #doc-footer-before>
-      <!-- <div class="footer-time-info">
-        <p title="首次提交时间">首次提交时间：{{ formatDate(created_at) }}</p>
-        <p title="最近提交时间">最近提交时间：{{ formatDate(updated_at) }}</p>
-      </div> -->
     </template>
     <template #doc-after>
       <!-- 自定义 DocFooter -->
@@ -335,8 +325,6 @@ function getEmptyNoteConfig() {
 const isDiscussionsVisible = computed(
   () => currentNoteConfig.value.enableDiscussions,
 );
-const updated_at = computed(() => currentNoteConfig.value.updated_at);
-const created_at = computed(() => currentNoteConfig.value.created_at);
 
 // 判断是否为首页 README.md
 const isHomeReadme = computed(() => vpData.page.value.filePath === "README.md");
@@ -349,10 +337,6 @@ const completionPercentage = computed(() => {
   return Math.round((doneNotesLen.value / totalNotesLen.value) * 100);
 });
 
-// 首页 README.md 的时间戳
-const homeReadmeCreatedAt = computed(() => readmeData?.created_at);
-const homeReadmeUpdatedAt = computed(() => readmeData?.updated_at);
-
 // #region - Composables
 // 404 重定向
 const { showNotFound, decodedCurrentPath, initRedirectCheck } =
@@ -509,20 +493,6 @@ const modalGithubPageUrl = computed(() => {
   return "";
 });
 
-// modal 中显示的创建时间
-const modalCreatedAt = computed(() => {
-  return modalIsHomeReadme.value
-    ? homeReadmeCreatedAt.value
-    : modalNoteConfig.value.created_at;
-});
-
-// modal 中显示的更新时间
-const modalUpdatedAt = computed(() => {
-  return modalIsHomeReadme.value
-    ? homeReadmeUpdatedAt.value
-    : modalNoteConfig.value.updated_at;
-});
-
 function openTimeModal() {
   sidebarAboutNoteId.value = null;
   timeModalOpen.value = true;

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

@@ -1,40 +1,49 @@
 /**
  * vitepress/components/Layout/composables/useVSCodeIntegration.ts
  *
- * VSCode 集成和 GitHub 链接拦截
+ * 本地 IDE 集成和 GitHub 链接拦截
  */
 
 import { useData } from 'vitepress'
-import { ref } from 'vue'
+import { computed, ref, watch } from 'vue'
 
+import { useLocalIde } from '../../composables/useLocalIde'
 import { NOTES_DIR_KEY } from '../../constants'
-import {
-  resolveNoteReadmePath,
-  toVscodeFileUrl,
-} from '../../utils/vscodePaths'
+import { resolveNoteReadmePath, toIdeFileUrl } from '../../utils/vscodePaths'
 
 import type { Router } from 'vitepress'
 import type { Ref, ComputedRef } from 'vue'
 
-
 /**
- * VSCode 集成和 GitHub 链接拦截
+ * 本地 IDE 集成和 GitHub 链接拦截
  */
 export function useVSCodeIntegration() {
   const vpData = useData()
-  const vscodeNotesDir = ref('')
+  const { ide } = useLocalIde()
+  const noteLocalPath = ref('')
+
+  const vscodeNotesDir = computed(() => {
+    if (!noteLocalPath.value) return ''
+    // 显式依赖 ide，确保切换 IDE 后 href 更新
+    return toIdeFileUrl(noteLocalPath.value, ide.value)
+  })
 
-  // 更新 VSCode 笔记目录
+  // 更新当前页面对应的本地笔记路径
   const updateVscodeNoteDir = () => {
     if (typeof window !== 'undefined') {
       const notesDir = localStorage.getItem(NOTES_DIR_KEY)
       const notePath = notesDir
         ? resolveNoteReadmePath(notesDir, vpData.page.value.relativePath)
         : null
-      vscodeNotesDir.value = notePath ? toVscodeFileUrl(notePath) : ''
+      noteLocalPath.value = notePath || ''
     }
   }
 
+  watch(ide, () => {
+    // IDE 切换后重新解析路径（无需刷新页面）
+    updateVscodeNoteDir()
+  })
+
   // 拦截 home README 中的笔记链接，将 GitHub 链接转换为站点内跳转
   const interceptHomeReadmeLinks = (
     isHomeReadme: Ref<boolean> | ComputedRef<boolean>,

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

@@ -1,7 +1,6 @@
 /**
  * vitepress/components/Layout/homeReadme.data.ts
  */
-import { execSync } from 'node:child_process'
 import fs from 'node:fs'
 import path from 'node:path'
 
@@ -12,8 +11,6 @@ interface ReadmeData {
   doneNotesID: string[]
   doneNotesLen: number
   totalNotesLen: number
-  created_at?: number
-  updated_at?: number
 }
 
 export default {
@@ -28,15 +25,10 @@ export default {
 
     watchedFiles.forEach((file) => {
       if (file.endsWith('README.md')) {
-        // console.log('file:', file) // => file: README.md
-
         const fileContent = fs.readFileSync(file, 'utf-8')
         const doneNotesID = getDoneNotesID(fileContent)
         const doneNotesLen = doneNotesID.length
 
-        // 获取 git 仓库的时间戳
-        const timestamps = getGitTimestamps()
-
         // 计算总笔记数
         const notesDir = path.join(path.dirname(file), 'notes')
         const totalNotesLen = getTotalNotesCount(notesDir)
@@ -46,7 +38,6 @@ export default {
           doneNotesID,
           doneNotesLen,
           totalNotesLen,
-          ...timestamps,
         }
       }
     })
@@ -74,45 +65,6 @@ function getTotalNotesCount(notesDir: string): number {
   }
 }
 
-/**
- * 获取 git 仓库的时间戳
- * @returns 包含 created_at 和 updated_at 的对象
- */
-function getGitTimestamps(): {
-  created_at?: number
-  updated_at?: number
-} {
-  const now = Date.now()
-  let created_at = now
-  let updated_at = now
-
-  try {
-    // 仓库的首次提交时间（最早的提交）
-    // 先获取所有提交，然后取第一行
-    const createdStdout = execSync(`git log --reverse --format=%ct`, {
-      encoding: 'utf-8',
-    })
-    const createdTs = createdStdout.toString().trim().split('\n')[0]
-    if (createdTs) {
-      created_at = parseInt(createdTs, 10) * 1000
-    }
-
-    // 仓库的最近一次提交时间
-    const updatedStdout = execSync(`git log -1 --format=%ct`, {
-      encoding: 'utf-8',
-    })
-    const updatedTs = updatedStdout.toString().trim()
-    if (updatedTs) {
-      updated_at = parseInt(updatedTs, 10) * 1000
-    }
-
-    return { created_at, updated_at }
-  } catch (error) {
-    console.error(`获取 git 仓库时间戳失败:`, error)
-    return { created_at, updated_at }
-  }
-}
-
 /**
  * 返回已完成的笔记的 ID 列表
  * @param fileContent 文件内容

package/vitepress/components/MarkMap/MarkMap.vue

@@ -12,17 +12,19 @@ import { onContentUpdated } from 'vitepress'
 import { nextTick, onBeforeUnmount, onMounted, ref, watch } from 'vue'
 
 import { icon__fullscreen, icon__fullscreen_exit, icon__confirm } from '../../assets/icons'
-import { MARKMAP_THEME_KEY, MARKMAP_EXPAND_LEVEL_KEY } from '../constants'
+import { MARKMAP_THEME_KEY } from '../constants'
 
 // doc: https://github.com/markmap/markmap/blob/205367a24603dc187f67da1658940c6cade20dce/packages/markmap-view/src/constants.ts#L15
 
+const DEFAULT_EXPAND_LEVEL = 3
+
 const props = defineProps({
   content: { type: String, default: '' },
   duration: { type: Number, default: 100 },
   spacingVertical: { type: Number, default: 10 },
   spacingHorizontal: { type: Number, default: 20 },
   nodeMinHeight: { type: Number, default: 24 },
-  initialExpandLevel: { type: Number, default: 5 },
+  initialExpandLevel: { type: Number, default: DEFAULT_EXPAND_LEVEL },
 })
 
 const svgRef = ref<SVGSVGElement | null>(null)
@@ -36,15 +38,6 @@ let darkClassObserver: MutationObserver | null = null
 
 const isMarkmapDark = ref(false)
 
-// 从 localStorage 读取配置，如果没有则使用 props 或默认值
-const getInitialExpandLevel = () => {
-  if (typeof window !== 'undefined') {
-    const saved = localStorage.getItem(MARKMAP_EXPAND_LEVEL_KEY)
-    if (saved) return parseInt(saved)
-  }
-  return props.initialExpandLevel
-}
-
 const getThemeColorFn = () => {
   if (typeof window !== 'undefined') {
     if (document.documentElement.classList.contains('markmap-dark')) {
@@ -63,8 +56,8 @@ const getThemeColorFn = () => {
   return scaleOrdinal(schemePastel2)
 }
 
-// 可由配置/props 初始化，也可以通过工具栏改动
-const expandLevel = ref(getInitialExpandLevel())
+// 可由 props 初始化，也可以通过工具栏改动
+const expandLevel = ref(props.initialExpandLevel)
 const transformer = new Transformer()
 const isFullscreen = ref(false)