@tnotesjs/core 0.1.0

package/vitepress/theme/index.ts

@@ -0,0 +1,95 @@
+/**
+ * .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 type { Theme, EnhanceAppContext } from 'vitepress'
+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 Layout from '../components/Layout/Layout.vue'
+import LoadingPage from '../components/LoadingPage/LoadingPage.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 './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('LoadingPage', LoadingPage)
+  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)
+}
+
+/**
+ * 覆盖选项
+ */
+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)
+      overrides.enhanceApp?.(ctx)
+    },
+  }
+}
+
+/**
+ * 默认导出（向后兼容旧版 re-export 方式）
+ */
+export default {
+  extends: DefaultTheme,
+  Layout,
+  enhanceApp(ctx: EnhanceAppContext) {
+    registerCoreComponents(ctx)
+  },
+} satisfies Theme

package/vitepress/theme/styles/base.scss

@@ -0,0 +1,50 @@
+/**
+ * 基础样式层
+ * - CSS 自定义属性（变量）
+ * - 全局样式重置
+ * - 通用样式规则
+ */
+
+/* ===================================== */
+/* #region CSS 变量定义                  */
+/* ===================================== */
+
+:root {
+  /* 品牌色 */
+  --vp-c-brand-1: #646cff;
+  --vp-c-brand-2: #747bff;
+
+  /* TNotes 自定义变量 */
+  --tn-content-width: 688px;
+}
+
+/* #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: 48px 0 16px;
+  // 缩小上边距
+  // margin: 32px 0 16px;
+}
+
+/* #endregion */

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

@@ -0,0 +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);
+}

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

@@ -0,0 +1,175 @@
+/**
+ * Collapse（折叠/展开）组件全局样式
+ * 这些样式应用于文档内容中动态生成的折叠区域
+ * 
+ * 由 ContentCollapse.vue 组件使用，所有样式必须是全局的
+ */
+
+/* ===================================== */
+/* #region 折叠按钮基础样式              */
+/* ===================================== */
+
+.collapse-toggle {
+  background: none;
+  border: none;
+  cursor: pointer;
+  padding: 4px;
+  margin: 0;
+  transition: all 0.25s ease;
+  line-height: 1;
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  pointer-events: none; /* 按钮本身不响应点击 */
+  transform-origin: center;
+
+  &.collapsed {
+    transform: rotate(0deg);
+  }
+}
+
+.collapse-icon {
+  width: 16px;
+  height: 16px;
+  transition: transform 0.25s ease;
+  transform: rotate(90deg); /* 默认向下（展开状态）*/
+  opacity: 0.3;
+}
+
+/* #endregion */
+
+/* ===================================== */
+/* #region TOC 折叠区域                  */
+/* ===================================== */
+
+.toc-collapse-wrapper {
+  position: relative;
+  margin: 16px 0;
+}
+
+.toc-collapse-header {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  padding: 8px 12px;
+  cursor: pointer;
+  border-radius: 6px;
+  transition: all 0.2s ease;
+  background: transparent;
+
+  &:hover {
+    background: var(--vp-c-bg-soft);
+
+    .collapse-icon {
+      opacity: 1;
+    }
+  }
+
+  &.collapsed {
+    background: var(--vp-c-bg-soft);
+    border: 1px solid var(--vp-c-divider);
+
+    .toc-collapse-toggle img {
+      transform: rotate(0deg) !important; /* 折叠时向右 */
+    }
+
+    &:hover {
+      background: var(--vp-c-bg-mute);
+      border-color: var(--vp-c-brand-1);
+    }
+  }
+}
+
+.collapse-label {
+  font-weight: 600;
+  color: var(--vp-c-text-2);
+  font-size: 14px;
+  display: block;
+}
+
+.toc-collapse-toggle {
+  flex-shrink: 0;
+}
+
+/* #endregion */
+
+/* ===================================== */
+/* #region H2 折叠区域                   */
+/* ===================================== */
+
+h2.collapsible-h2 {
+  position: relative !important;
+  cursor: pointer !important;
+  padding: 8px 40px 8px 12px !important; /* 右侧预留按钮空间 */
+  border-radius: 6px !important;
+  transition: all 0.2s ease !important;
+
+  &:hover {
+    background: var(--vp-c-bg-soft) !important;
+
+    .collapse-icon {
+      opacity: 1 !important;
+    }
+  }
+
+  &.collapsed {
+    background: var(--vp-c-bg-soft) !important;
+    border: 1px solid var(--vp-c-divider) !important;
+    // margin-top: 1rem !important;
+    margin: 12px 0 0 0 !important;
+
+    .collapse-icon {
+      transform: rotate(0deg) !important; /* 折叠时向右 */
+    }
+
+    &:hover {
+      background: var(--vp-c-bg-mute) !important;
+      border-color: var(--vp-c-brand-1) !important;
+    }
+  }
+
+  /* 修复 anchor 位置 */
+  .header-anchor {
+    top: 10px !important;
+  }
+}
+
+.h2-collapse-toggle {
+  position: absolute !important;
+  right: 8px !important;
+  top: 50% !important;
+  transform: translateY(-50%) !important;
+  flex-shrink: 0;
+}
+
+/* #endregion */
+
+/* ===================================== */
+/* #region 折叠内容区域                  */
+/* ===================================== */
+
+.collapse-content {
+  overflow: hidden;
+  max-height: 10000px;
+  opacity: 1;
+  transition: max-height 0.3s ease, opacity 0.3s ease, margin 0.3s ease;
+
+  &.collapsed {
+    max-height: 0 !important;
+    opacity: 0 !important;
+    margin-top: 0 !important;
+    margin-bottom: 0 !important;
+    padding-top: 0 !important;
+    padding-bottom: 0 !important;
+  }
+
+  > :first-child {
+    margin-top: 0;
+  }
+
+  > :last-child {
+    margin-bottom: 0;
+  }
+}
+
+/* #endregion */

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

@@ -0,0 +1,101 @@
+/**
+ * MarkMap 组件全局样式
+ * Toolbar 由 markmap-toolbar 库动态生成，需要全局样式
+ */
+
+/* ===================================== */
+/* #region Toolbar 样式                  */
+/* ===================================== */
+
+.mm-toolbar {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  padding: 6px;
+  background: rgba(255, 255, 255, 0.9);
+  border-radius: 6px;
+  box-shadow: 0 2px 12px rgba(0, 0, 0, 0.15);
+  backdrop-filter: blur(8px);
+  opacity: 0;
+  pointer-events: none;
+  transition: opacity 0.3s ease;
+  color: var(--vp-c-tip-1);
+  font-weight: 700;
+}
+
+.mm-toolbar-item {
+  cursor: pointer;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  width: 28px;
+  height: 28px;
+  border-radius: 4px;
+  transition: all 0.2s ease;
+  font-weight: 500;
+}
+
+.mm-toolbar-item:hover {
+  background-color: rgba(0, 0, 0, 0.08);
+  transform: scale(1.1);
+}
+
+.mm-toolbar-item:active {
+  transform: scale(0.95);
+}
+
+.mm-toolbar-item svg {
+  color: var(--vp-c-tip-1);
+}
+
+/* #endregion */
+
+/* ===================================== */
+/* #region SVG 动画                      */
+/* ===================================== */
+
+.markmap g {
+  transition: transform 0.3s ease, opacity 0.3s ease;
+}
+
+/* #endregion */
+
+/* ===================================== */
+/* #region 暗色模式                      */
+/* ===================================== */
+
+.markmap-dark .mm-toolbar {
+  background: rgba(30, 30, 30, 0.9);
+  box-shadow: 0 2px 12px rgba(0, 0, 0, 0.3);
+}
+
+.markmap-dark .mm-toolbar-item:hover {
+  background-color: rgba(255, 255, 255, 0.1);
+}
+
+/* #endregion */
+
+/* ===================================== */
+/* #region 响应式                        */
+/* ===================================== */
+
+@media (max-width: 768px) {
+  .mm-toolbar {
+    scale: 0.9;
+    gap: 6px;
+    padding: 4px;
+  }
+
+  .mm-toolbar-item {
+    width: 24px;
+    height: 24px;
+  }
+}
+
+@media (max-width: 480px) {
+  .mm-toolbar {
+    scale: 0.8;
+  }
+}
+
+/* #endregion */

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

@@ -0,0 +1,255 @@
+/**
+ * Swiper 组件全局样式
+ * 由于 Swiper 组件动态生成 DOM，所有样式都需要是全局的
+ */
+
+/* ===================================== */
+/* #region Swiper Tabs                   */
+/* ===================================== */
+
+.tn-swiper-tabs {
+  position: relative;
+  z-index: 20;
+  display: flex;
+  overflow-x: auto;
+  overflow-y: hidden;
+  gap: 0.5rem;
+  background: var(--vp-c-bg);
+  border-bottom: 1px solid var(--vp-c-divider);
+  border-radius: 8px 8px 0 0;
+  background-color: var(--vp-code-tab-bg);
+  box-shadow: inset 0 -1px var(--vp-code-tab-divider);
+}
+
+.tn-swiper-tabs::-webkit-scrollbar {
+  height: 4px;
+}
+
+.tn-swiper-tabs::-webkit-scrollbar-track {
+  background: transparent;
+}
+
+.tn-swiper-tabs::-webkit-scrollbar-thumb {
+  background: var(--vp-c-divider);
+  border-radius: 2px;
+}
+
+.tn-swiper-tabs::-webkit-scrollbar-thumb:hover {
+  background: var(--vp-c-text-3);
+}
+
+/* #endregion */
+
+/* ===================================== */
+/* #region Tab 按钮                      */
+/* ===================================== */
+
+.tn-tab {
+  position: relative;
+  padding: 0.25rem 0.75rem;
+  line-height: 2rem;
+  border-bottom: 1px solid transparent;
+  background: transparent;
+  cursor: pointer;
+  font-size: 0.875rem;
+  white-space: nowrap;
+  color: var(--vp-code-tab-text-color);
+  transition: color 0.25s ease, transform 0.2s ease;
+  border: none;
+}
+
+.tn-tab::after {
+  position: absolute;
+  right: 8px;
+  bottom: -1px;
+  left: 8px;
+  z-index: 1;
+  height: 2px;
+  border-radius: 2px;
+  content: '';
+  background-color: transparent;
+  transition: background-color 0.25s ease;
+}
+
+.tn-tab:hover {
+  color: var(--vp-code-tab-active-text-color);
+  transform: translateY(-1px);
+}
+
+.tn-tab.active {
+  color: var(--vp-code-tab-active-text-color);
+  font-weight: 500;
+}
+
+.tn-tab.active::after {
+  background-color: var(--vp-code-tab-active-bar-color);
+}
+
+/* #endregion */
+
+/* ===================================== */
+/* #region Tab 导航按钮                  */
+/* ===================================== */
+
+.tn-tab-nav {
+  position: absolute;
+  top: 50%;
+  transform: translateY(-50%);
+  background: transparent;
+  border: none;
+  font-size: 0.8rem;
+  cursor: pointer;
+  color: var(--vp-code-tab-text-color);
+  padding: 0 0.3rem;
+  transition: all 0.3s cubic-bezier(0.4, 0, 0.2, 1);
+  user-select: none;
+  border-radius: 4px;
+  line-height: 1;
+}
+
+/* 只对翻页按钮（非分隔符）生效的 hover 样式 */
+.tn-tab-prev:hover,
+.tn-tab-next:hover {
+  color: var(--vp-code-tab-active-bar-color);
+  font-size: 1rem;
+  transform: translateY(-50%) scale(1.5);
+}
+
+.tn-tab-nav:active {
+  transform: translateY(-50%) scale(0.95);
+}
+
+.tn-tab-prev {
+  left: 0.5rem;
+}
+
+.tab-tab-line {
+  position: absolute;
+  left: 1.1rem;
+  top: 50%;
+  transform: translateY(-50%);
+  color: var(--vp-code-tab-active-bar-color);
+  user-select: none;
+  opacity: 0.5;
+  /* 移除 cursor，表示不可交互 */
+  cursor: default;
+}
+
+.tn-tab-next {
+  left: 1.5rem;
+}
+
+/* #endregion */
+
+/* ===================================== */
+/* #region Swiper 容器                   */
+/* ===================================== */
+
+.swiper-container {
+  width: 100%;
+  position: relative;
+  overflow: hidden;
+  margin: 1rem 0;
+  transition: height 0.3s ease;
+  border-radius: 0 0 8px 8px;
+  background: var(--vp-c-bg-soft);
+}
+
+.swiper-container img {
+  display: block;
+  max-width: 100%;
+  margin: 0 auto;
+  height: auto;
+  object-fit: contain;
+  transition: opacity 0.3s ease;
+}
+
+.tn-swiper {
+  margin: 1.5rem 0;
+  border-radius: 8px;
+  overflow: hidden;
+  box-shadow: 0 2px 8px rgba(0, 0, 0, 0.1);
+  transition: box-shadow 0.3s ease;
+}
+
+.tn-swiper:hover {
+  box-shadow: 0 4px 16px rgba(0, 0, 0, 0.15);
+}
+
+.swiper-slide {
+  animation: swiperFadeIn 0.3s ease-out;
+}
+
+/* #endregion */
+
+/* ===================================== */
+/* #region 暗色模式                      */
+/* ===================================== */
+
+html.dark .tn-swiper {
+  box-shadow: 0 2px 8px rgba(0, 0, 0, 0.3);
+}
+
+html.dark .tn-swiper:hover {
+  box-shadow: 0 4px 16px rgba(0, 0, 0, 0.4);
+}
+
+html.dark .swiper-container {
+  background: var(--vp-c-bg);
+}
+
+/* #endregion */
+
+/* ===================================== */
+/* #region 响应式                        */
+/* ===================================== */
+
+@media (max-width: 640px) {
+  .tn-swiper-tabs {
+    gap: 0.25rem;
+  }
+
+  .tn-tab {
+    padding: 0.2rem 0.5rem;
+    font-size: 0.8rem;
+    line-height: 1.8rem;
+  }
+
+  .tn-tab-nav {
+    font-size: 0.7rem;
+    padding: 0 0.2rem;
+  }
+
+  .tn-tab-nav:hover {
+    font-size: 0.85rem;
+  }
+
+  .tn-tab-prev {
+    left: 0.3rem;
+  }
+
+  .tab-tab-line {
+    left: 0.8rem;
+  }
+
+  .tn-tab-next {
+    left: 1.2rem;
+  }
+}
+
+/* #endregion */
+
+/* ===================================== */
+/* #region 动画                          */
+/* ===================================== */
+
+@keyframes swiperFadeIn {
+  from {
+    opacity: 0;
+  }
+  to {
+    opacity: 1;
+  }
+}
+
+/* #endregion */