@tnotesjs/core 0.1.19 → 0.1.20

package/vitepress/theme/index.ts

@@ -1,137 +1,137 @@
-/**
- * .vitepress/tnotes/theme/index.ts
- *
- * 自定义主题
- *
- * 提供两种使用方式：
- * 1. defineNotesTheme() 工厂函数（推荐）
- * 2. export default（向后兼容）
- *
- * doc:
- * v1 - https://vuejs.github.io/vitepress/v1/zh/guide/custom-theme
- * v2 - https://vitepress.dev/zh/guide/custom-theme
- */
-
-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 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'
-
-/**
- * 注册 TNotes 核心全局组件
- */
-function registerCoreComponents(ctx: EnhanceAppContext) {
-  const { app } = ctx
-  app.component('BilibiliOutsidePlayer', BilibiliOutsidePlayer)
-  app.component('B', BilibiliOutsidePlayer)
-  app.component('Discussions', Discussions)
-  app.component('EnWordList', EnWordList)
-  app.component('E', EnWordList)
-  app.component('Footprints', Footprints)
-  app.component('F', Footprints)
-  app.component('Settings', Settings)
-  app.component('S', Settings)
-  app.component('SidebarCard', SidebarCard)
-  app.component('MarkMap', MarkMap)
-  app.component('Mermaid', Mermaid)
-  app.component('NotesTable', NotesTable)
-  app.component('N', NotesTable)
-  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
-      }
-    },
-  )
-}
-
-/**
- * 覆盖选项
- */
-interface NotesThemeOverrides {
-  /** 覆盖 Layout 组件 */
-  Layout?: Theme['Layout']
-  /** 追加的 enhanceApp 逻辑（在核心组件注册之后调用） */
-  enhanceApp?: Theme['enhanceApp']
-}
-
-/**
- * 创建 TNotes 主题配置
- *
- * @param overrides - 可选的覆盖选项
- * @returns VitePress 主题对象
- *
- * @example
- * // .vitepress/theme/index.ts
- * import { defineNotesTheme } from '../tnotes/vitepress/theme'
- * export default defineNotesTheme()
- */
-export function defineNotesTheme(overrides: NotesThemeOverrides = {}): Theme {
-  return {
-    extends: DefaultTheme,
-    Layout: overrides.Layout ?? Layout,
-    enhanceApp(ctx) {
-      registerCoreComponents(ctx)
-      registerRenameHmrListener()
-      overrides.enhanceApp?.(ctx)
-    },
-  }
-}
-
-/**
- * 默认导出（向后兼容旧版 re-export 方式）
- */
-export default {
-  extends: DefaultTheme,
-  Layout,
-  enhanceApp(ctx: EnhanceAppContext) {
-    registerCoreComponents(ctx)
-    registerRenameHmrListener()
-  },
-} satisfies Theme
+/**
+ * .vitepress/tnotes/theme/index.ts
+ *
+ * 自定义主题
+ *
+ * 提供两种使用方式：
+ * 1. defineNotesTheme() 工厂函数（推荐）
+ * 2. export default（向后兼容）
+ *
+ * doc:
+ * v1 - https://vuejs.github.io/vitepress/v1/zh/guide/custom-theme
+ * v2 - https://vitepress.dev/zh/guide/custom-theme
+ */
+
+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 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'
+
+/**
+ * 注册 TNotes 核心全局组件
+ */
+function registerCoreComponents(ctx: EnhanceAppContext) {
+  const { app } = ctx
+  app.component('BilibiliOutsidePlayer', BilibiliOutsidePlayer)
+  app.component('B', BilibiliOutsidePlayer)
+  app.component('Discussions', Discussions)
+  app.component('EnWordList', EnWordList)
+  app.component('E', EnWordList)
+  app.component('Footprints', Footprints)
+  app.component('F', Footprints)
+  app.component('Settings', Settings)
+  app.component('S', Settings)
+  app.component('SidebarCard', SidebarCard)
+  app.component('MarkMap', MarkMap)
+  app.component('Mermaid', Mermaid)
+  app.component('NotesTable', NotesTable)
+  app.component('N', NotesTable)
+  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
+      }
+    },
+  )
+}
+
+/**
+ * 覆盖选项
+ */
+interface NotesThemeOverrides {
+  /** 覆盖 Layout 组件 */
+  Layout?: Theme['Layout']
+  /** 追加的 enhanceApp 逻辑（在核心组件注册之后调用） */
+  enhanceApp?: Theme['enhanceApp']
+}
+
+/**
+ * 创建 TNotes 主题配置
+ *
+ * @param overrides - 可选的覆盖选项
+ * @returns VitePress 主题对象
+ *
+ * @example
+ * // .vitepress/theme/index.ts
+ * import { defineNotesTheme } from '../tnotes/vitepress/theme'
+ * export default defineNotesTheme()
+ */
+export function defineNotesTheme(overrides: NotesThemeOverrides = {}): Theme {
+  return {
+    extends: DefaultTheme,
+    Layout: overrides.Layout ?? Layout,
+    enhanceApp(ctx) {
+      registerCoreComponents(ctx)
+      registerRenameHmrListener()
+      overrides.enhanceApp?.(ctx)
+    },
+  }
+}
+
+/**
+ * 默认导出（向后兼容旧版 re-export 方式）
+ */
+export default {
+  extends: DefaultTheme,
+  Layout,
+  enhanceApp(ctx: EnhanceAppContext) {
+    registerCoreComponents(ctx)
+    registerRenameHmrListener()
+  },
+} satisfies Theme

package/vitepress/theme/styles/base.scss

@@ -1,59 +1,64 @@
-/**
- * 基础样式层
- * - CSS 自定义属性（变量）
- * - 全局样式重置
- * - 通用样式规则
- */
-
-/* ===================================== */
-/* #region CSS 变量定义                  */
-/* ===================================== */
-
-:root {
-  /* 品牌色 */
-  --vp-c-brand-1: #646cff;
-  --vp-c-brand-2: #747bff;
-}
-
-/* #endregion */
-
-/* ===================================== */
-/* #region 全局样式重置                  */
-/* ===================================== */
-
-/* 移除所有链接的下划线 */
-a {
-  text-decoration: none !important;
-}
-
-/* 任务列表样式优化 */
-ul > li.task-list-item {
-  list-style-type: none;
-  padding-left: 0;
-  margin-left: 0;
-}
-
-ul > li.task-list-item > ul {
-  padding-left: 3rem;
-}
-
-.vp-doc h2 {
-  // margin 默认值：
-  // margin: 48px 0 16px;
-  // 缩小上边距
-  margin: 1rem 0 1rem;
-  // border-top 默认值：
-  // border-top: 1px solid var(--vp-c-divider);
-  // 移除上横线：
-  border-top: none;
-}
-
-// 代码块外层 div
-.vp-doc div[class*=language-] {
-  // 默认值：
-  // margin: 16px 24px;
-  // 移除外层 margin：
-  margin: 0px !important;
-}
-
-/* #endregion */
+/**
+ * 基础样式层
+ * - CSS 自定义属性（变量）
+ * - 全局样式重置
+ * - 通用样式规则
+ */
+
+/* ===================================== */
+/* #region CSS 变量定义                  */
+/* ===================================== */
+
+:root {
+  /* 品牌色 */
+  --vp-c-brand-1: #646cff;
+  --vp-c-brand-2: #747bff;
+}
+
+/* #endregion */
+
+/* ===================================== */
+/* #region 全局样式重置                  */
+/* ===================================== */
+
+/* 移除所有链接的下划线 */
+a {
+  text-decoration: none !important;
+}
+
+/* 任务列表样式优化 */
+ul > li.task-list-item {
+  list-style-type: none;
+  padding-left: 0;
+  margin-left: 0;
+}
+
+ul > li.task-list-item > ul {
+  padding-left: 3rem;
+}
+
+.vp-doc h2 {
+  // margin 默认值：
+  // margin: 48px 0 16px;
+  // 缩小上边距
+  margin: 1rem 0 1rem;
+  // border-top 默认值：
+  // border-top: 1px solid var(--vp-c-divider);
+  // 移除上横线：
+  border-top: none;
+}
+
+/* 修复锚点定位：为标题添加滚动偏移，避免被顶部固定导航栏遮挡 */
+.vp-doc :is(h1, h2, h3, h4, h5, h6) {
+  scroll-margin-top: calc(var(--vp-nav-height) + 1rem);
+}
+
+// 代码块外层 div
+.vp-doc div[class*=language-] {
+  // 默认值：
+  // margin: 16px 24px;
+  // 移除外层 margin：
+  margin: 0px !important;
+}
+
+/* #endregion */

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

@@ -1,31 +1,31 @@
-/**
- * ./vitepress/tnotes/vitepress/theme/styles/components/404.scss
- * 
- * 404 页面样式
- */
-
-.not-found-container {
-  text-align: center;
-  padding: 2rem;
-  min-height: calc(100vh - var(--vp-nav-height));
-  display: flex;
-  flex-direction: column;
-  justify-content: center;
-  align-items: center;
-  animation: fadeIn 0.4s ease-out;
-}
-
-.not-found-container h1 {
-  font-size: 4rem;
-  line-height: 4rem;
-  margin-bottom: 1rem;
-  background: linear-gradient(135deg, var(--vp-c-brand-1), var(--vp-c-brand-2));
-  -webkit-background-clip: text;
-  -webkit-text-fill-color: transparent;
-  background-clip: text;
-}
-
-.not-found-container p {
-  font-size: 1.5rem;
-  color: var(--vp-c-text-2);
-}
+/**
+ * ./vitepress/tnotes/vitepress/theme/styles/components/404.scss
+ * 
+ * 404 页面样式
+ */
+
+.not-found-container {
+  text-align: center;
+  padding: 2rem;
+  min-height: calc(100vh - var(--vp-nav-height));
+  display: flex;
+  flex-direction: column;
+  justify-content: center;
+  align-items: center;
+  animation: fadeIn 0.4s ease-out;
+}
+
+.not-found-container h1 {
+  font-size: 4rem;
+  line-height: 4rem;
+  margin-bottom: 1rem;
+  background: linear-gradient(135deg, var(--vp-c-brand-1), var(--vp-c-brand-2));
+  -webkit-background-clip: text;
+  -webkit-text-fill-color: transparent;
+  background-clip: text;
+}
+
+.not-found-container p {
+  font-size: 1.5rem;
+  color: var(--vp-c-text-2);
+}