@tnotesjs/core 0.1.21 → 0.1.23

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (122) hide show
  1. package/README.md +87 -87
  2. package/dist/{chunk-4MO7F7Q4.js → chunk-BSTQOJVE.js} +1 -1
  3. package/dist/{chunk-SQVHJR2Z.js → chunk-O4DCXHOV.js} +0 -3
  4. package/dist/cli/index.js +2 -2
  5. package/dist/index.js +1 -1
  6. package/dist/vitepress/config/index.js +2 -2
  7. package/package.json +3 -4
  8. package/types/config.ts +60 -61
  9. package/types/index.ts +11 -11
  10. package/types/note.ts +33 -33
  11. package/vitepress/assets/icons/icon__check.svg +3 -3
  12. package/vitepress/assets/icons/icon__clipboard.svg +7 -7
  13. package/vitepress/assets/icons/icon__close.svg +1 -1
  14. package/vitepress/assets/icons/icon__collapse.svg +1 -1
  15. package/vitepress/assets/icons/icon__confirm.svg +1 -1
  16. package/vitepress/assets/icons/icon__copy.svg +4 -4
  17. package/vitepress/assets/icons/icon__focus.svg +1 -1
  18. package/vitepress/assets/icons/icon__fold.svg +3 -3
  19. package/vitepress/assets/icons/icon__folder.svg +1 -1
  20. package/vitepress/assets/icons/icon__fullscreen.svg +1 -1
  21. package/vitepress/assets/icons/icon__fullscreen_exit.svg +1 -1
  22. package/vitepress/assets/icons/icon__github.svg +3 -3
  23. package/vitepress/assets/icons/icon__mindmap.svg +1 -1
  24. package/vitepress/assets/icons/icon__next.svg +1 -1
  25. package/vitepress/assets/icons/icon__number_gray.svg +1 -1
  26. package/vitepress/assets/icons/icon__number_purple.svg +1 -1
  27. package/vitepress/assets/icons/icon__prev.svg +1 -1
  28. package/vitepress/assets/icons/icon__restore.svg +1 -1
  29. package/vitepress/assets/icons/icon__rotate.svg +4 -4
  30. package/vitepress/assets/icons/icon__search.svg +1 -1
  31. package/vitepress/assets/icons/icon__sidebar_collapsed.svg +1 -1
  32. package/vitepress/assets/icons/icon__sidebar_opened.svg +1 -1
  33. package/vitepress/assets/icons/icon__totop.svg +5 -5
  34. package/vitepress/assets/icons/icon__vscode.svg +5 -5
  35. package/vitepress/assets/icons/icon__zoom_fit.svg +1 -1
  36. package/vitepress/assets/icons/icon__zoom_in.svg +1 -1
  37. package/vitepress/assets/icons/icon__zoom_out.svg +1 -1
  38. package/vitepress/assets/icons/icon__zoom_reset.svg +1 -1
  39. package/vitepress/assets/icons/index.ts +39 -39
  40. package/vitepress/components/BilibiliOutsidePlayer/BilibiliOutsidePlayer.vue +20 -20
  41. package/vitepress/components/CodeBlockFullscreen/CodeBlockFullscreen.vue +369 -369
  42. package/vitepress/components/CodeBlockFullscreen/index.ts +209 -213
  43. package/vitepress/components/CodeBlockFullscreen/styles.css +126 -126
  44. package/vitepress/components/Discussions/Discussions.vue +244 -211
  45. package/vitepress/components/EnWordList/EnWordList.vue +663 -543
  46. package/vitepress/components/EnWordList/RightClickMenu.vue +89 -66
  47. package/vitepress/components/Footprints/Footprints.vue +472 -377
  48. package/vitepress/components/Layout/AboutModal.vue +331 -105
  49. package/vitepress/components/Layout/AboutPanel.vue +484 -270
  50. package/vitepress/components/Layout/ContentCollapse.vue +590 -603
  51. package/vitepress/components/Layout/CustomSidebar.vue +817 -817
  52. package/vitepress/components/Layout/DocBeforeControls.vue +351 -149
  53. package/vitepress/components/Layout/DocFooter.vue +233 -233
  54. package/vitepress/components/Layout/ImagePreview.vue +484 -281
  55. package/vitepress/components/Layout/Layout.vue +744 -621
  56. package/vitepress/components/Layout/NavBarSettingsTrigger.vue +0 -2
  57. package/vitepress/components/Layout/NoteStatus.vue +140 -140
  58. package/vitepress/components/Layout/SidebarItems.vue +1083 -1083
  59. package/vitepress/components/Layout/SidebarNavBefore.vue +170 -171
  60. package/vitepress/components/Layout/SidebarResizeHandle.vue +311 -319
  61. package/vitepress/components/Layout/Swiper.vue +167 -167
  62. package/vitepress/components/Layout/ToggleFullContent.vue +47 -35
  63. package/vitepress/components/Layout/ToggleSidebar.vue +37 -26
  64. package/vitepress/components/Layout/composables/useCollapseControl.ts +88 -88
  65. package/vitepress/components/Layout/composables/useNoteConfig.ts +119 -119
  66. package/vitepress/components/Layout/composables/useNoteSave.ts +178 -178
  67. package/vitepress/components/Layout/composables/useNoteValidation.ts +85 -85
  68. package/vitepress/components/Layout/composables/useRedirect.ts +113 -113
  69. package/vitepress/components/Layout/composables/useSidebarLayout.ts +122 -122
  70. package/vitepress/components/Layout/composables/useVSCodeIntegration.ts +85 -85
  71. package/vitepress/components/Layout/homeReadme.data.ts +124 -124
  72. package/vitepress/components/LoadingPage/LoadingPage.vue +1 -6
  73. package/vitepress/components/MarkMap/MarkMap.vue +564 -405
  74. package/vitepress/components/Mermaid/Mermaid.vue +643 -365
  75. package/vitepress/components/NotesTable/NotesTable.vue +174 -98
  76. package/vitepress/components/NotesTable/README.md +67 -67
  77. package/vitepress/components/Settings/Settings.vue +711 -334
  78. package/vitepress/components/Settings/SettingsDialog.vue +1 -11
  79. package/vitepress/components/SidebarCard/MindMapView.vue +484 -484
  80. package/vitepress/components/SidebarCard/NotesTrendChart.vue +108 -108
  81. package/vitepress/components/SidebarCard/SidebarCard.vue +945 -946
  82. package/vitepress/components/Tooltip/Tooltip.vue +70 -70
  83. package/vitepress/components/constants.ts +109 -109
  84. package/vitepress/components/notesConfig.data.ts +73 -73
  85. package/vitepress/components/sidebar.data.ts +59 -59
  86. package/vitepress/components/tnotes-config.data.ts +21 -21
  87. package/vitepress/components/utils.ts +26 -26
  88. package/vitepress/config/index.ts +169 -169
  89. package/vitepress/configs/constants.ts +26 -26
  90. package/vitepress/configs/head.config.ts +25 -25
  91. package/vitepress/configs/index.ts +9 -9
  92. package/vitepress/configs/markdown-it.d.ts +23 -23
  93. package/vitepress/configs/markdown.config.ts +368 -367
  94. package/vitepress/configs/theme.config.ts +108 -108
  95. package/vitepress/plugins/buildProgressPlugin.ts +434 -434
  96. package/vitepress/plugins/getNoteByConfigIdPlugin.ts +107 -107
  97. package/vitepress/plugins/renameNotePlugin.ts +68 -68
  98. package/vitepress/plugins/sidebarStructurePlugin.ts +260 -260
  99. package/vitepress/plugins/updateConfigPlugin.ts +63 -63
  100. package/vitepress/theme/index.ts +137 -137
  101. package/vitepress/theme/styles/base.scss +66 -64
  102. package/vitepress/theme/styles/components/404.scss +31 -31
  103. package/vitepress/theme/styles/components/collapse.scss +172 -172
  104. package/vitepress/theme/styles/components/markmap.scss +101 -101
  105. package/vitepress/theme/styles/components/swiper.scss +255 -255
  106. package/vitepress/theme/styles/index.scss +25 -25
  107. package/vitepress/theme/styles/layout.scss +78 -78
  108. package/vitepress/theme/styles/utilities.scss +39 -39
  109. package/vitepress/theme/styles/vitepress-override.scss +25 -25
  110. package/vitepress/components/Discussions/Discussions.module.scss +0 -32
  111. package/vitepress/components/EnWordList/EnWordList.module.scss +0 -124
  112. package/vitepress/components/EnWordList/RightClickMenu.module.scss +0 -22
  113. package/vitepress/components/Footprints/Footprints.module.scss +0 -93
  114. package/vitepress/components/Layout/AboutModal.module.scss +0 -233
  115. package/vitepress/components/Layout/ImagePreview.module.scss +0 -201
  116. package/vitepress/components/Layout/Layout.module.scss +0 -661
  117. package/vitepress/components/Layout/ToggleFullContent.module.scss +0 -11
  118. package/vitepress/components/Layout/ToggleSidebar.module.scss +0 -11
  119. package/vitepress/components/MarkMap/MarkMap.module.scss +0 -159
  120. package/vitepress/components/Mermaid/Mermaid.module.scss +0 -275
  121. package/vitepress/components/NotesTable/NotesTable.module.scss +0 -77
  122. package/vitepress/components/Settings/Settings.module.scss +0 -375
@@ -1,85 +1,85 @@
1
- import type { Ref } from 'vue'
2
-
3
- /**
4
- * 笔记标题验证
5
- */
6
- export function useNoteValidation() {
7
- // 标题验证函数
8
- function validateTitle(title: string): string | null {
9
- // 非法字符正则
10
- const invalidChars = /[<>:"/\\|?*\x00-\x1F]/
11
- const windowsReservedNames = new Set([
12
- 'CON',
13
- 'PRN',
14
- 'AUX',
15
- 'NUL',
16
- 'COM1',
17
- 'COM2',
18
- 'COM3',
19
- 'COM4',
20
- 'COM5',
21
- 'COM6',
22
- 'COM7',
23
- 'COM8',
24
- 'COM9',
25
- 'LPT1',
26
- 'LPT2',
27
- 'LPT3',
28
- 'LPT4',
29
- 'LPT5',
30
- 'LPT6',
31
- 'LPT7',
32
- 'LPT8',
33
- 'LPT9',
34
- ])
35
-
36
- if (!title || title.trim().length === 0) {
37
- return '标题不能为空'
38
- }
39
-
40
- const trimmedTitle = title.trim()
41
-
42
- if (trimmedTitle.length > 200) {
43
- return '标题过长(最多200个字符)'
44
- }
45
-
46
- if (invalidChars.test(trimmedTitle)) {
47
- return '标题包含非法字符(不允许: < > : " / \\ | ? *)'
48
- }
49
-
50
- if (/^[.\s]|[.\s]$/.test(trimmedTitle)) {
51
- return '标题不能以点或空格开头/结尾'
52
- }
53
-
54
- const upperTitle = trimmedTitle.toUpperCase()
55
- if (windowsReservedNames.has(upperTitle)) {
56
- return `"${trimmedTitle}" 是 Windows 系统保留名称`
57
- }
58
-
59
- const baseName = trimmedTitle.split('.')[0].toUpperCase()
60
- if (windowsReservedNames.has(baseName)) {
61
- return `"${trimmedTitle}" 包含 Windows 系统保留名称`
62
- }
63
-
64
- return null
65
- }
66
-
67
- // 标题输入事件处理器
68
- function onTitleInput(editableNoteTitle: Ref<string>, titleError: Ref<string>) {
69
- const error = validateTitle(editableNoteTitle.value)
70
- titleError.value = error || ''
71
- }
72
-
73
- // 标题失焦事件处理器
74
- function onTitleBlur(editableNoteTitle: Ref<string>, titleError: Ref<string>) {
75
- // 去除首尾空格
76
- editableNoteTitle.value = editableNoteTitle.value.trim()
77
- onTitleInput(editableNoteTitle, titleError)
78
- }
79
-
80
- return {
81
- validateTitle,
82
- onTitleInput,
83
- onTitleBlur,
84
- }
85
- }
1
+ import type { Ref } from 'vue'
2
+
3
+ /**
4
+ * 笔记标题验证
5
+ */
6
+ export function useNoteValidation() {
7
+ // 标题验证函数
8
+ function validateTitle(title: string): string | null {
9
+ // 非法字符正则
10
+ const invalidChars = /[<>:"/\\|?*\x00-\x1F]/
11
+ const windowsReservedNames = new Set([
12
+ 'CON',
13
+ 'PRN',
14
+ 'AUX',
15
+ 'NUL',
16
+ 'COM1',
17
+ 'COM2',
18
+ 'COM3',
19
+ 'COM4',
20
+ 'COM5',
21
+ 'COM6',
22
+ 'COM7',
23
+ 'COM8',
24
+ 'COM9',
25
+ 'LPT1',
26
+ 'LPT2',
27
+ 'LPT3',
28
+ 'LPT4',
29
+ 'LPT5',
30
+ 'LPT6',
31
+ 'LPT7',
32
+ 'LPT8',
33
+ 'LPT9',
34
+ ])
35
+
36
+ if (!title || title.trim().length === 0) {
37
+ return '标题不能为空'
38
+ }
39
+
40
+ const trimmedTitle = title.trim()
41
+
42
+ if (trimmedTitle.length > 200) {
43
+ return '标题过长(最多200个字符)'
44
+ }
45
+
46
+ if (invalidChars.test(trimmedTitle)) {
47
+ return '标题包含非法字符(不允许: < > : " / \\ | ? *)'
48
+ }
49
+
50
+ if (/^[.\s]|[.\s]$/.test(trimmedTitle)) {
51
+ return '标题不能以点或空格开头/结尾'
52
+ }
53
+
54
+ const upperTitle = trimmedTitle.toUpperCase()
55
+ if (windowsReservedNames.has(upperTitle)) {
56
+ return `"${trimmedTitle}" 是 Windows 系统保留名称`
57
+ }
58
+
59
+ const baseName = trimmedTitle.split('.')[0].toUpperCase()
60
+ if (windowsReservedNames.has(baseName)) {
61
+ return `"${trimmedTitle}" 包含 Windows 系统保留名称`
62
+ }
63
+
64
+ return null
65
+ }
66
+
67
+ // 标题输入事件处理器
68
+ function onTitleInput(editableNoteTitle: Ref<string>, titleError: Ref<string>) {
69
+ const error = validateTitle(editableNoteTitle.value)
70
+ titleError.value = error || ''
71
+ }
72
+
73
+ // 标题失焦事件处理器
74
+ function onTitleBlur(editableNoteTitle: Ref<string>, titleError: Ref<string>) {
75
+ // 去除首尾空格
76
+ editableNoteTitle.value = editableNoteTitle.value.trim()
77
+ onTitleInput(editableNoteTitle, titleError)
78
+ }
79
+
80
+ return {
81
+ validateTitle,
82
+ onTitleInput,
83
+ onTitleBlur,
84
+ }
85
+ }
@@ -1,113 +1,113 @@
1
- import { useRoute, useData } from 'vitepress'
2
- import { ref, watch } from 'vue'
3
-
4
- import type { NoteConfig } from '../../../../types'
5
-
6
- /**
7
- * 处理 404 重定向逻辑
8
- * 当用户访问旧的笔记 URL 时,自动重定向到新的 URL
9
- */
10
- export function useRedirect(allNotesConfig: Record<string, NoteConfig & { redirect?: string }>) {
11
- const route = useRoute()
12
- const vpData = useData()
13
-
14
- // 控制是否显示 404 内容
15
- const showNotFound = ref(false)
16
- const currentPath = ref('')
17
- const matchedId = ref('')
18
- const redirectPath = ref('')
19
-
20
- // 解码后的当前路径(用于调试)
21
- const decodedCurrentPath = ref('')
22
-
23
- // 重定向检查函数
24
- function checkRedirect() {
25
- if (typeof window === 'undefined') return false
26
-
27
- currentPath.value = window.location.pathname
28
-
29
- // 匹配路径格式:/TNotes.*/notes/四个数字{任意内容}/README
30
- const match = currentPath.value.match(
31
- /\/TNotes[^/]+\/notes\/(\d{4})[^/]*(?:\/.*)?$/
32
- )
33
-
34
- if (match) {
35
- const matchedNoteId = match[1]
36
- if (!matchedNoteId) return false
37
-
38
- matchedId.value = matchedNoteId
39
- const targetNote = allNotesConfig[matchedNoteId]
40
- redirectPath.value = targetNote?.redirect ?? ''
41
-
42
- if (targetNote?.redirect) {
43
- const base = vpData.site.value.base
44
- // 构建目标路径(包含基础路径)
45
- const targetPath = `${base}${targetNote.redirect}`
46
-
47
- // 避免重定向死循环
48
- if (currentPath.value !== targetPath) {
49
- console.log(`Redirecting from ${currentPath.value} to ${targetPath}`)
50
-
51
- // 使用完整的页面跳转(强制刷新)
52
- window.location.href = targetPath
53
- return true
54
- }
55
- }
56
- }
57
- return false
58
- }
59
-
60
- // 更新解码后的路径
61
- function updateDecodedPath() {
62
- try {
63
- decodedCurrentPath.value = decodeURIComponent(currentPath.value)
64
- } catch (e) {
65
- console.error('Failed to decode URI:', e)
66
- decodedCurrentPath.value = currentPath.value
67
- }
68
- }
69
-
70
- // 初始化检查(在组件挂载后调用)
71
- function initRedirectCheck() {
72
- // 延迟执行以确保路由状态稳定
73
- setTimeout(() => {
74
- // 如果是 404 页面,尝试重定向
75
- if (vpData.page.value.isNotFound) {
76
- const redirected = checkRedirect()
77
-
78
- // 如果重定向失败,显示原始 404 内容
79
- if (!redirected) {
80
- showNotFound.value = true
81
- }
82
- }
83
- }, 1000)
84
- }
85
-
86
- // 监听路由变化
87
- watch(
88
- () => route.path,
89
- () => {
90
- // 延迟检查以确保路由更新完成
91
- setTimeout(() => {
92
- if (vpData.page.value.isNotFound) {
93
- const redirected = checkRedirect()
94
- if (!redirected) {
95
- showNotFound.value = true
96
- }
97
- }
98
- }, 1000)
99
- }
100
- )
101
-
102
- // 监听 currentPath 变化,更新解码后的路径
103
- watch(currentPath, updateDecodedPath, { immediate: true })
104
-
105
- return {
106
- showNotFound,
107
- currentPath,
108
- matchedId,
109
- redirectPath,
110
- decodedCurrentPath,
111
- initRedirectCheck,
112
- }
113
- }
1
+ import { useRoute, useData } from 'vitepress'
2
+ import { ref, watch } from 'vue'
3
+
4
+ import type { NoteConfig } from '../../../../types'
5
+
6
+ /**
7
+ * 处理 404 重定向逻辑
8
+ * 当用户访问旧的笔记 URL 时,自动重定向到新的 URL
9
+ */
10
+ export function useRedirect(allNotesConfig: Record<string, NoteConfig & { redirect?: string }>) {
11
+ const route = useRoute()
12
+ const vpData = useData()
13
+
14
+ // 控制是否显示 404 内容
15
+ const showNotFound = ref(false)
16
+ const currentPath = ref('')
17
+ const matchedId = ref('')
18
+ const redirectPath = ref('')
19
+
20
+ // 解码后的当前路径(用于调试)
21
+ const decodedCurrentPath = ref('')
22
+
23
+ // 重定向检查函数
24
+ function checkRedirect() {
25
+ if (typeof window === 'undefined') return false
26
+
27
+ currentPath.value = window.location.pathname
28
+
29
+ // 匹配路径格式:/TNotes.*/notes/四个数字{任意内容}/README
30
+ const match = currentPath.value.match(
31
+ /\/TNotes[^/]+\/notes\/(\d{4})[^/]*(?:\/.*)?$/
32
+ )
33
+
34
+ if (match) {
35
+ const matchedNoteId = match[1]
36
+ if (!matchedNoteId) return false
37
+
38
+ matchedId.value = matchedNoteId
39
+ const targetNote = allNotesConfig[matchedNoteId]
40
+ redirectPath.value = targetNote?.redirect ?? ''
41
+
42
+ if (targetNote?.redirect) {
43
+ const base = vpData.site.value.base
44
+ // 构建目标路径(包含基础路径)
45
+ const targetPath = `${base}${targetNote.redirect}`
46
+
47
+ // 避免重定向死循环
48
+ if (currentPath.value !== targetPath) {
49
+ console.log(`Redirecting from ${currentPath.value} to ${targetPath}`)
50
+
51
+ // 使用完整的页面跳转(强制刷新)
52
+ window.location.href = targetPath
53
+ return true
54
+ }
55
+ }
56
+ }
57
+ return false
58
+ }
59
+
60
+ // 更新解码后的路径
61
+ function updateDecodedPath() {
62
+ try {
63
+ decodedCurrentPath.value = decodeURIComponent(currentPath.value)
64
+ } catch (e) {
65
+ console.error('Failed to decode URI:', e)
66
+ decodedCurrentPath.value = currentPath.value
67
+ }
68
+ }
69
+
70
+ // 初始化检查(在组件挂载后调用)
71
+ function initRedirectCheck() {
72
+ // 延迟执行以确保路由状态稳定
73
+ setTimeout(() => {
74
+ // 如果是 404 页面,尝试重定向
75
+ if (vpData.page.value.isNotFound) {
76
+ const redirected = checkRedirect()
77
+
78
+ // 如果重定向失败,显示原始 404 内容
79
+ if (!redirected) {
80
+ showNotFound.value = true
81
+ }
82
+ }
83
+ }, 1000)
84
+ }
85
+
86
+ // 监听路由变化
87
+ watch(
88
+ () => route.path,
89
+ () => {
90
+ // 延迟检查以确保路由更新完成
91
+ setTimeout(() => {
92
+ if (vpData.page.value.isNotFound) {
93
+ const redirected = checkRedirect()
94
+ if (!redirected) {
95
+ showNotFound.value = true
96
+ }
97
+ }
98
+ }, 1000)
99
+ }
100
+ )
101
+
102
+ // 监听 currentPath 变化,更新解码后的路径
103
+ watch(currentPath, updateDecodedPath, { immediate: true })
104
+
105
+ return {
106
+ showNotFound,
107
+ currentPath,
108
+ matchedId,
109
+ redirectPath,
110
+ decodedCurrentPath,
111
+ initRedirectCheck,
112
+ }
113
+ }
@@ -1,122 +1,122 @@
1
- import { ref } from 'vue'
2
-
3
- const SIDEBAR_HIDDEN_KEY = 'vp:sidebar:hidden'
4
- const SIDEBAR_WIDTH_KEY = 'vp:sidebar:width'
5
- const SIDEBAR_MIN_WIDTH = 260
6
- const SIDEBAR_MAX_WIDTH = 480
7
- const SIDEBAR_DEFAULT_WIDTH = 260
8
-
9
- const hidden = ref(false)
10
- const width = ref(SIDEBAR_DEFAULT_WIDTH)
11
- let initialized = false
12
-
13
- function canUseDOM(): boolean {
14
- return typeof window !== 'undefined' && typeof document !== 'undefined'
15
- }
16
-
17
- function clampSidebarWidth(nextWidth: number): number {
18
- if (!Number.isFinite(nextWidth)) return SIDEBAR_DEFAULT_WIDTH
19
-
20
- return Math.min(
21
- SIDEBAR_MAX_WIDTH,
22
- Math.max(SIDEBAR_MIN_WIDTH, Math.round(nextWidth)),
23
- )
24
- }
25
-
26
- function readStoredWidth(): number {
27
- if (!canUseDOM()) return SIDEBAR_DEFAULT_WIDTH
28
-
29
- const savedWidth = window.localStorage.getItem(SIDEBAR_WIDTH_KEY)
30
- if (!savedWidth) return SIDEBAR_DEFAULT_WIDTH
31
-
32
- return clampSidebarWidth(Number(savedWidth))
33
- }
34
-
35
- function applyHiddenState(nextHidden: boolean) {
36
- if (!canUseDOM()) return
37
-
38
- document.documentElement.classList.toggle('hide-sidebar', nextHidden)
39
- }
40
-
41
- function applySidebarWidth(nextWidth: number, nextHidden = hidden.value) {
42
- if (!canUseDOM()) return
43
-
44
- const widthValue = `${clampSidebarWidth(nextWidth)}px`
45
- const layoutWidthValue = nextHidden ? '0px' : widthValue
46
- document.documentElement.style.setProperty('--tn-sidebar-width', widthValue)
47
- document.documentElement.style.setProperty(
48
- '--tn-sidebar-layout-width',
49
- layoutWidthValue,
50
- )
51
- document.documentElement.style.setProperty(
52
- '--vp-sidebar-width',
53
- layoutWidthValue,
54
- )
55
- }
56
-
57
- function persistHiddenState(nextHidden: boolean) {
58
- if (!canUseDOM()) return
59
-
60
- try {
61
- window.localStorage.setItem(SIDEBAR_HIDDEN_KEY, nextHidden ? '1' : '0')
62
- } catch {}
63
- }
64
-
65
- function persistSidebarWidth(nextWidth: number) {
66
- if (!canUseDOM()) return
67
-
68
- try {
69
- window.localStorage.setItem(
70
- SIDEBAR_WIDTH_KEY,
71
- String(clampSidebarWidth(nextWidth)),
72
- )
73
- } catch {}
74
- }
75
-
76
- function initSidebarLayout() {
77
- if (!canUseDOM()) return
78
-
79
- if (!initialized) {
80
- hidden.value = window.localStorage.getItem(SIDEBAR_HIDDEN_KEY) === '1'
81
- width.value = readStoredWidth()
82
- initialized = true
83
- }
84
-
85
- applyHiddenState(hidden.value)
86
- applySidebarWidth(width.value, hidden.value)
87
- }
88
-
89
- function setSidebarHidden(nextHidden: boolean) {
90
- hidden.value = nextHidden
91
- applyHiddenState(hidden.value)
92
- applySidebarWidth(width.value, hidden.value)
93
- persistHiddenState(hidden.value)
94
- }
95
-
96
- function toggleSidebar() {
97
- setSidebarHidden(!hidden.value)
98
- }
99
-
100
- function setSidebarWidth(nextWidth: number) {
101
- width.value = clampSidebarWidth(nextWidth)
102
- applySidebarWidth(width.value)
103
- }
104
-
105
- function saveSidebarWidth() {
106
- persistSidebarWidth(width.value)
107
- }
108
-
109
- export function useSidebarLayout() {
110
- return {
111
- hidden,
112
- width,
113
- minWidth: SIDEBAR_MIN_WIDTH,
114
- maxWidth: SIDEBAR_MAX_WIDTH,
115
- defaultWidth: SIDEBAR_DEFAULT_WIDTH,
116
- initSidebarLayout,
117
- setSidebarHidden,
118
- toggleSidebar,
119
- setSidebarWidth,
120
- saveSidebarWidth,
121
- }
122
- }
1
+ import { ref } from 'vue'
2
+
3
+ const SIDEBAR_HIDDEN_KEY = 'vp:sidebar:hidden'
4
+ const SIDEBAR_WIDTH_KEY = 'vp:sidebar:width'
5
+ const SIDEBAR_MIN_WIDTH = 260
6
+ const SIDEBAR_MAX_WIDTH = 480
7
+ const SIDEBAR_DEFAULT_WIDTH = 260
8
+
9
+ const hidden = ref(false)
10
+ const width = ref(SIDEBAR_DEFAULT_WIDTH)
11
+ let initialized = false
12
+
13
+ function canUseDOM(): boolean {
14
+ return typeof window !== 'undefined' && typeof document !== 'undefined'
15
+ }
16
+
17
+ function clampSidebarWidth(nextWidth: number): number {
18
+ if (!Number.isFinite(nextWidth)) return SIDEBAR_DEFAULT_WIDTH
19
+
20
+ return Math.min(
21
+ SIDEBAR_MAX_WIDTH,
22
+ Math.max(SIDEBAR_MIN_WIDTH, Math.round(nextWidth)),
23
+ )
24
+ }
25
+
26
+ function readStoredWidth(): number {
27
+ if (!canUseDOM()) return SIDEBAR_DEFAULT_WIDTH
28
+
29
+ const savedWidth = window.localStorage.getItem(SIDEBAR_WIDTH_KEY)
30
+ if (!savedWidth) return SIDEBAR_DEFAULT_WIDTH
31
+
32
+ return clampSidebarWidth(Number(savedWidth))
33
+ }
34
+
35
+ function applyHiddenState(nextHidden: boolean) {
36
+ if (!canUseDOM()) return
37
+
38
+ document.documentElement.classList.toggle('hide-sidebar', nextHidden)
39
+ }
40
+
41
+ function applySidebarWidth(nextWidth: number, nextHidden = hidden.value) {
42
+ if (!canUseDOM()) return
43
+
44
+ const widthValue = `${clampSidebarWidth(nextWidth)}px`
45
+ const layoutWidthValue = nextHidden ? '0px' : widthValue
46
+ document.documentElement.style.setProperty('--tn-sidebar-width', widthValue)
47
+ document.documentElement.style.setProperty(
48
+ '--tn-sidebar-layout-width',
49
+ layoutWidthValue,
50
+ )
51
+ document.documentElement.style.setProperty(
52
+ '--vp-sidebar-width',
53
+ layoutWidthValue,
54
+ )
55
+ }
56
+
57
+ function persistHiddenState(nextHidden: boolean) {
58
+ if (!canUseDOM()) return
59
+
60
+ try {
61
+ window.localStorage.setItem(SIDEBAR_HIDDEN_KEY, nextHidden ? '1' : '0')
62
+ } catch {}
63
+ }
64
+
65
+ function persistSidebarWidth(nextWidth: number) {
66
+ if (!canUseDOM()) return
67
+
68
+ try {
69
+ window.localStorage.setItem(
70
+ SIDEBAR_WIDTH_KEY,
71
+ String(clampSidebarWidth(nextWidth)),
72
+ )
73
+ } catch {}
74
+ }
75
+
76
+ function initSidebarLayout() {
77
+ if (!canUseDOM()) return
78
+
79
+ if (!initialized) {
80
+ hidden.value = window.localStorage.getItem(SIDEBAR_HIDDEN_KEY) === '1'
81
+ width.value = readStoredWidth()
82
+ initialized = true
83
+ }
84
+
85
+ applyHiddenState(hidden.value)
86
+ applySidebarWidth(width.value, hidden.value)
87
+ }
88
+
89
+ function setSidebarHidden(nextHidden: boolean) {
90
+ hidden.value = nextHidden
91
+ applyHiddenState(hidden.value)
92
+ applySidebarWidth(width.value, hidden.value)
93
+ persistHiddenState(hidden.value)
94
+ }
95
+
96
+ function toggleSidebar() {
97
+ setSidebarHidden(!hidden.value)
98
+ }
99
+
100
+ function setSidebarWidth(nextWidth: number) {
101
+ width.value = clampSidebarWidth(nextWidth)
102
+ applySidebarWidth(width.value)
103
+ }
104
+
105
+ function saveSidebarWidth() {
106
+ persistSidebarWidth(width.value)
107
+ }
108
+
109
+ export function useSidebarLayout() {
110
+ return {
111
+ hidden,
112
+ width,
113
+ minWidth: SIDEBAR_MIN_WIDTH,
114
+ maxWidth: SIDEBAR_MAX_WIDTH,
115
+ defaultWidth: SIDEBAR_DEFAULT_WIDTH,
116
+ initSidebarLayout,
117
+ setSidebarHidden,
118
+ toggleSidebar,
119
+ setSidebarWidth,
120
+ saveSidebarWidth,
121
+ }
122
+ }