@wsxjs/wsx-press 0.0.18

package/src/client/styles/theme.css

@@ -0,0 +1,171 @@
+/**
+ * WSX-Press 主题变量定义
+ * 支持亮/暗模式，与 wsxjs 网站主题集成
+ */
+
+:root {
+  /* ===== 颜色系统 - 亮色模式 ===== */
+  --wsx-press-bg-primary: #ffffff;
+  --wsx-press-bg-secondary: #f6f8fa;
+  --wsx-press-bg-tertiary: #f0f2f5;
+
+  --wsx-press-text-primary: #1f2328;
+  --wsx-press-text-secondary: #636c76;
+  --wsx-press-text-tertiary: #8c959f;
+
+  --wsx-press-border: #d0d7de;
+  --wsx-press-border-hover: #8c959f;
+
+  --wsx-press-link: #0969da;
+  --wsx-press-link-hover: #0550ae;
+
+  --wsx-press-accent: #dc2626;        /* 继承 wsxjs 主色 */
+  --wsx-press-accent-hover: #b91c1c;
+
+  /* 代码高亮 */
+  --wsx-press-code-bg: #f6f8fa;
+  --wsx-press-code-text: #24292f;
+  --wsx-press-code-border: #d0d7de;
+
+  /* ===== 间距系统 ===== */
+  --wsx-press-spacing-xs: 0.25rem;    /* 4px */
+  --wsx-press-spacing-sm: 0.5rem;     /* 8px */
+  --wsx-press-spacing-md: 1rem;       /* 16px */
+  --wsx-press-spacing-lg: 1.5rem;     /* 24px */
+  --wsx-press-spacing-xl: 2rem;       /* 32px */
+  --wsx-press-spacing-2xl: 3rem;      /* 48px */
+  --wsx-press-spacing-3xl: 4rem;      /* 64px */
+
+  /* ===== 字体系统 ===== */
+  --wsx-press-font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
+  --wsx-press-font-mono: "SF Mono", Monaco, "Cascadia Code", "Roboto Mono", Consolas, "Courier New", monospace;
+
+  --wsx-press-font-size-xs: 0.75rem;   /* 12px */
+  --wsx-press-font-size-sm: 0.875rem;  /* 14px */
+  --wsx-press-font-size-base: 1rem;    /* 16px */
+  --wsx-press-font-size-lg: 1.125rem;  /* 18px */
+  --wsx-press-font-size-xl: 1.25rem;   /* 20px */
+  --wsx-press-font-size-2xl: 1.5rem;   /* 24px */
+  --wsx-press-font-size-3xl: 1.875rem; /* 30px */
+  --wsx-press-font-size-4xl: 2.25rem;  /* 36px */
+
+  --wsx-press-line-height-tight: 1.25;
+  --wsx-press-line-height-normal: 1.5;
+  --wsx-press-line-height-relaxed: 1.75;
+
+  /* ===== 圆角 ===== */
+  --wsx-press-radius-sm: 0.25rem;
+  --wsx-press-radius-md: 0.5rem;
+  --wsx-press-radius-lg: 0.75rem;
+  --wsx-press-radius-xl: 1rem;
+
+  /* ===== 阴影 ===== */
+  --wsx-press-shadow-sm: 0 1px 2px 0 rgba(0, 0, 0, 0.05);
+  --wsx-press-shadow-md: 0 4px 6px -1px rgba(0, 0, 0, 0.1);
+  --wsx-press-shadow-lg: 0 10px 15px -3px rgba(0, 0, 0, 0.1);
+  --wsx-press-shadow-xl: 0 20px 25px -5px rgba(0, 0, 0, 0.1);
+
+  /* ===== 布局 ===== */
+  --wsx-press-sidebar-width: 280px;
+  --wsx-press-toc-width: 240px;
+  --wsx-press-content-max-width: 800px;
+  --wsx-press-layout-max-width: 1440px;
+
+  /* ===== 动画 ===== */
+  --wsx-press-transition-fast: 150ms ease;
+  --wsx-press-transition-base: 200ms ease;
+  --wsx-press-transition-slow: 300ms ease;
+
+  /* ===== Z-index ===== */
+  --wsx-press-z-dropdown: 1000;
+  --wsx-press-z-modal: 1050;
+  --wsx-press-z-tooltip: 1100;
+}
+
+/* ===== 暗色模式（系统偏好） ===== */
+@media (prefers-color-scheme: dark) {
+  :root {
+    --wsx-press-bg-primary: #0d1117;
+    --wsx-press-bg-secondary: #161b22;
+    --wsx-press-bg-tertiary: #21262d;
+
+    --wsx-press-text-primary: #e6edf3;
+    --wsx-press-text-secondary: #8b949e;
+    --wsx-press-text-tertiary: #6e7681;
+
+    --wsx-press-border: #30363d;
+    --wsx-press-border-hover: #484f58;
+
+    --wsx-press-link: #58a6ff;
+    --wsx-press-link-hover: #79c0ff;
+
+    --wsx-press-accent: #f87171;
+    --wsx-press-accent-hover: #fca5a5;
+
+    --wsx-press-code-bg: #161b22;
+    --wsx-press-code-text: #e6edf3;
+    --wsx-press-code-border: #30363d;
+
+    --wsx-press-shadow-sm: 0 1px 2px 0 rgba(0, 0, 0, 0.3);
+    --wsx-press-shadow-md: 0 4px 6px -1px rgba(0, 0, 0, 0.4);
+    --wsx-press-shadow-lg: 0 10px 15px -3px rgba(0, 0, 0, 0.5);
+    --wsx-press-shadow-xl: 0 20px 25px -5px rgba(0, 0, 0, 0.6);
+  }
+}
+
+/* ===== 显式主题类（强制覆盖） ===== */
+[data-theme="light"] {
+  --wsx-press-bg-primary: #ffffff;
+  --wsx-press-bg-secondary: #f6f8fa;
+  --wsx-press-bg-tertiary: #f0f2f5;
+
+  --wsx-press-text-primary: #1f2328;
+  --wsx-press-text-secondary: #636c76;
+  --wsx-press-text-tertiary: #8c959f;
+
+  --wsx-press-border: #d0d7de;
+  --wsx-press-border-hover: #8c959f;
+
+  --wsx-press-link: #0969da;
+  --wsx-press-link-hover: #0550ae;
+
+  --wsx-press-accent: #dc2626;
+  --wsx-press-accent-hover: #b91c1c;
+
+  --wsx-press-code-bg: #f6f8fa;
+  --wsx-press-code-text: #24292f;
+  --wsx-press-code-border: #d0d7de;
+
+  --wsx-press-shadow-sm: 0 1px 2px 0 rgba(0, 0, 0, 0.05);
+  --wsx-press-shadow-md: 0 4px 6px -1px rgba(0, 0, 0, 0.1);
+  --wsx-press-shadow-lg: 0 10px 15px -3px rgba(0, 0, 0, 0.1);
+  --wsx-press-shadow-xl: 0 20px 25px -5px rgba(0, 0, 0, 0.1);
+}
+
+[data-theme="dark"] {
+  --wsx-press-bg-primary: #0d1117;
+  --wsx-press-bg-secondary: #161b22;
+  --wsx-press-bg-tertiary: #21262d;
+
+  --wsx-press-text-primary: #e6edf3;
+  --wsx-press-text-secondary: #8b949e;
+  --wsx-press-text-tertiary: #6e7681;
+
+  --wsx-press-border: #30363d;
+  --wsx-press-border-hover: #484f58;
+
+  --wsx-press-link: #58a6ff;
+  --wsx-press-link-hover: #79c0ff;
+
+  --wsx-press-accent: #f87171;
+  --wsx-press-accent-hover: #fca5a5;
+
+  --wsx-press-code-bg: #161b22;
+  --wsx-press-code-text: #e6edf3;
+  --wsx-press-code-border: #30363d;
+
+  --wsx-press-shadow-sm: 0 1px 2px 0 rgba(0, 0, 0, 0.3);
+  --wsx-press-shadow-md: 0 4px 6px -1px rgba(0, 0, 0, 0.4);
+  --wsx-press-shadow-lg: 0 10px 15px -3px rgba(0, 0, 0, 0.5);
+  --wsx-press-shadow-xl: 0 20px 25px -5px rgba(0, 0, 0, 0.6);
+}

package/src/client/styles/typography.css

@@ -0,0 +1,239 @@
+/**
+ * WSX-Press 排版系统
+ * Markdown 内容样式
+ */
+
+.wsx-press-typography {
+  font-family: var(--wsx-press-font-family);
+  font-size: var(--wsx-press-font-size-base);
+  line-height: var(--wsx-press-line-height-normal);
+  color: var(--wsx-press-text-primary);
+  word-wrap: break-word;
+}
+
+/* ===== 标题 ===== */
+.wsx-press-typography h1,
+.wsx-press-typography h2,
+.wsx-press-typography h3,
+.wsx-press-typography h4,
+.wsx-press-typography h5,
+.wsx-press-typography h6 {
+  margin-top: var(--wsx-press-spacing-xl);
+  margin-bottom: var(--wsx-press-spacing-md);
+  font-weight: 600;
+  line-height: var(--wsx-press-line-height-tight);
+  color: var(--wsx-press-text-primary);
+}
+
+.wsx-press-typography h1:first-child,
+.wsx-press-typography h2:first-child,
+.wsx-press-typography h3:first-child {
+  margin-top: 0;
+}
+
+.wsx-press-typography h1 {
+  font-size: var(--wsx-press-font-size-3xl);
+  font-weight: 700;
+  padding-bottom: var(--wsx-press-spacing-md);
+  border-bottom: 2px solid var(--wsx-press-border);
+}
+
+.wsx-press-typography h2 {
+  font-size: var(--wsx-press-font-size-2xl);
+  padding-bottom: var(--wsx-press-spacing-sm);
+  border-bottom: 1px solid var(--wsx-press-border);
+}
+
+.wsx-press-typography h3 {
+  font-size: var(--wsx-press-font-size-xl);
+}
+
+.wsx-press-typography h4 {
+  font-size: var(--wsx-press-font-size-lg);
+}
+
+.wsx-press-typography h5,
+.wsx-press-typography h6 {
+  font-size: var(--wsx-press-font-size-base);
+}
+
+/* ===== 段落 ===== */
+.wsx-press-typography p {
+  margin-top: 0;
+  margin-bottom: var(--wsx-press-spacing-md);
+  line-height: var(--wsx-press-line-height-relaxed);
+}
+
+/* ===== 链接 ===== */
+.wsx-press-typography a {
+  color: var(--wsx-press-link);
+  text-decoration: none;
+  transition: color var(--wsx-press-transition-fast);
+}
+
+.wsx-press-typography a:hover {
+  color: var(--wsx-press-link-hover);
+  text-decoration: underline;
+}
+
+/* ===== 列表 ===== */
+.wsx-press-typography ul,
+.wsx-press-typography ol {
+  margin-top: 0;
+  margin-bottom: var(--wsx-press-spacing-md);
+  padding-left: var(--wsx-press-spacing-xl);
+}
+
+.wsx-press-typography li {
+  margin-bottom: var(--wsx-press-spacing-sm);
+  line-height: var(--wsx-press-line-height-relaxed);
+}
+
+.wsx-press-typography li > p {
+  margin-bottom: var(--wsx-press-spacing-sm);
+}
+
+.wsx-press-typography ul ul,
+.wsx-press-typography ol ul,
+.wsx-press-typography ul ol,
+.wsx-press-typography ol ol {
+  margin-top: var(--wsx-press-spacing-sm);
+  margin-bottom: 0;
+}
+
+/* ===== 引用 ===== */
+.wsx-press-typography blockquote {
+  margin: var(--wsx-press-spacing-lg) 0;
+  padding: var(--wsx-press-spacing-sm) var(--wsx-press-spacing-md);
+  padding-left: var(--wsx-press-spacing-lg);
+  border-left: 4px solid var(--wsx-press-accent);
+  background: var(--wsx-press-bg-secondary);
+  border-radius: var(--wsx-press-radius-sm);
+  color: var(--wsx-press-text-secondary);
+}
+
+.wsx-press-typography blockquote > :first-child {
+  margin-top: 0;
+}
+
+.wsx-press-typography blockquote > :last-child {
+  margin-bottom: 0;
+}
+
+/* ===== 行内代码 ===== */
+.wsx-press-typography code {
+  font-family: var(--wsx-press-font-mono);
+  font-size: 0.9em;
+  padding: 0.2em 0.4em;
+  background: var(--wsx-press-code-bg);
+  border: 1px solid var(--wsx-press-code-border);
+  border-radius: var(--wsx-press-radius-sm);
+  color: var(--wsx-press-code-text);
+}
+
+.wsx-press-typography a code {
+  color: var(--wsx-press-link);
+}
+
+/* ===== 代码块 ===== */
+.wsx-press-typography pre {
+  margin: var(--wsx-press-spacing-lg) 0;
+  padding: var(--wsx-press-spacing-md);
+  background: var(--wsx-press-code-bg);
+  border: 1px solid var(--wsx-press-code-border);
+  border-radius: var(--wsx-press-radius-md);
+  overflow-x: auto;
+  line-height: var(--wsx-press-line-height-normal);
+}
+
+.wsx-press-typography pre code {
+  padding: 0;
+  background: none;
+  border: none;
+  font-size: var(--wsx-press-font-size-sm);
+  color: var(--wsx-press-code-text);
+}
+
+/* ===== 表格 ===== */
+.wsx-press-typography table {
+  width: 100%;
+  border-collapse: collapse;
+  margin: var(--wsx-press-spacing-lg) 0;
+  display: block;
+  overflow-x: auto;
+}
+
+.wsx-press-typography th,
+.wsx-press-typography td {
+  padding: var(--wsx-press-spacing-sm) var(--wsx-press-spacing-md);
+  border: 1px solid var(--wsx-press-border);
+  text-align: left;
+}
+
+.wsx-press-typography thead th {
+  background: var(--wsx-press-bg-secondary);
+  font-weight: 600;
+  color: var(--wsx-press-text-primary);
+}
+
+.wsx-press-typography tbody tr:hover {
+  background: var(--wsx-press-bg-tertiary);
+}
+
+/* ===== 分隔线 ===== */
+.wsx-press-typography hr {
+  height: 1px;
+  border: none;
+  background: var(--wsx-press-border);
+  margin: var(--wsx-press-spacing-2xl) 0;
+}
+
+/* ===== 图片 ===== */
+.wsx-press-typography img {
+  max-width: 100%;
+  height: auto;
+  display: block;
+  margin: var(--wsx-press-spacing-lg) auto;
+  border-radius: var(--wsx-press-radius-md);
+}
+
+/* ===== 任务列表 ===== */
+.wsx-press-typography input[type="checkbox"] {
+  margin-right: var(--wsx-press-spacing-sm);
+}
+
+.wsx-press-typography .task-list-item {
+  list-style-type: none;
+}
+
+.wsx-press-typography .task-list-item input[type="checkbox"] {
+  margin-left: calc(var(--wsx-press-spacing-xl) * -1);
+}
+
+/* ===== 强调 ===== */
+.wsx-press-typography strong {
+  font-weight: 600;
+  color: var(--wsx-press-text-primary);
+}
+
+.wsx-press-typography em {
+  font-style: italic;
+}
+
+/* ===== 删除线 ===== */
+.wsx-press-typography del {
+  text-decoration: line-through;
+  color: var(--wsx-press-text-tertiary);
+}
+
+/* ===== 键盘按键 ===== */
+.wsx-press-typography kbd {
+  display: inline-block;
+  padding: 0.1em 0.4em;
+  font-family: var(--wsx-press-font-mono);
+  font-size: 0.85em;
+  background: var(--wsx-press-bg-tertiary);
+  border: 1px solid var(--wsx-press-border);
+  border-radius: var(--wsx-press-radius-sm);
+  box-shadow: inset 0 -1px 0 var(--wsx-press-border);
+}

package/src/index.ts

@@ -0,0 +1,26 @@
+/**
+ * @wsxjs/wsx-press
+ * Main entry point
+ */
+
+// Export types
+export type {
+    DocMetadata,
+    DocsMetaCollection,
+    SearchDocument,
+    SearchResult,
+    SearchIndex,
+    SearchIndexOptions,
+    RouteParams,
+    ApiRouteParams,
+    LoadingState,
+    DocumentLoadErrorCode,
+} from "./types";
+
+export { DocumentLoadError } from "./types";
+
+// Export client components (will be implemented later)
+// export * from "./client/index";
+
+// Export node utilities (will be implemented later)
+// export * from "./node/index";

package/src/node/index.ts

@@ -0,0 +1,16 @@
+/**
+ * @wsxjs/wsx-press/node
+ * Node.js build tools entry point
+ */
+
+// Export metadata utilities
+export { scanDocsMetadata, extractFrontmatter, addPrevNextLinks } from "./metadata";
+
+// Export search utilities
+export { generateSearchIndex } from "./search";
+
+// Export TypeDoc utilities
+export { generateApiDocs, type TypeDocConfig } from "./typedoc";
+
+// Export Vite plugin
+export { wsxPress, type WSXPressOptions } from "./plugin";

package/src/node/metadata.ts

@@ -0,0 +1,113 @@
+/**
+ * @wsxjs/wsx-press/node/metadata
+ * Document metadata scanning and processing
+ */
+
+import { glob } from "glob";
+import path from "path";
+import fs from "fs-extra";
+import type { DocsMetaCollection, DocMetadata } from "../types";
+
+/**
+ * 扫描文档目录，生成元数据集合
+ *
+ * @param docsRoot - 文档根目录路径
+ * @returns 文档元数据集合
+ */
+export async function scanDocsMetadata(docsRoot: string): Promise<DocsMetaCollection> {
+    const files = await glob("**/*.md", { cwd: docsRoot, absolute: true });
+    const metadata: DocsMetaCollection = {};
+
+    for (const file of files) {
+        const relativePath = path.relative(docsRoot, file);
+        const content = await fs.readFile(file, "utf-8");
+        const frontmatter = extractFrontmatter(content);
+        const key = relativePath.replace(/\.md$/, "");
+
+        const dirname = path.dirname(relativePath);
+        metadata[key] = {
+            title: frontmatter.title || path.basename(file, ".md"),
+            category: dirname === "." ? "." : dirname,
+            route: `/docs/${key}`,
+            ...frontmatter,
+        };
+    }
+
+    return addPrevNextLinks(metadata);
+}
+
+/**
+ * 从 Markdown 中提取 frontmatter
+ * 返回部分 DocMetadata，因为不是所有字段都在 frontmatter 中
+ *
+ * @param markdown - Markdown 内容
+ * @returns 提取的 frontmatter 数据
+ */
+export function extractFrontmatter(markdown: string): Partial<DocMetadata> {
+    const match = markdown.match(/^---\n([\s\S]*?)\n---/);
+    if (!match) {
+        return {};
+    }
+
+    const yaml = match[1];
+    const meta: Partial<DocMetadata> = {};
+
+    yaml.split("\n").forEach((line) => {
+        const colonIndex = line.indexOf(":");
+        if (colonIndex === -1) {
+            return;
+        }
+
+        const key = line.substring(0, colonIndex).trim();
+        const value = line.substring(colonIndex + 1).trim();
+
+        if (key && value) {
+            // 类型安全的属性赋值
+            if (key === "title" || key === "description" || key === "category") {
+                (meta as Record<string, string>)[key] = value;
+            } else if (key === "tags") {
+                // 简单的数组解析（实际应使用 YAML 解析器）
+                meta.tags = value
+                    .replace(/[[\]]/g, "")
+                    .split(",")
+                    .map((t) => t.trim());
+            } else {
+                // 其他扩展字段
+                (meta as Record<string, unknown>)[key] = value;
+            }
+        }
+    });
+
+    return meta;
+}
+
+/**
+ * 为元数据集合添加上一页/下一页链接
+ *
+ * @param metadata - 元数据集合
+ * @returns 添加了导航链接的元数据集合
+ */
+export function addPrevNextLinks(metadata: DocsMetaCollection): DocsMetaCollection {
+    const categories = new Map<string, string[]>();
+
+    // 按类别分组
+    for (const [key, meta] of Object.entries(metadata)) {
+        const category = meta.category;
+        if (!categories.has(category)) {
+            categories.set(category, []);
+        }
+        categories.get(category)!.push(key);
+    }
+
+    // 为每个类别添加 prev/next
+    for (const [_category, keys] of categories) {
+        keys.sort();
+        for (let i = 0; i < keys.length; i++) {
+            const key = keys[i];
+            metadata[key].prev = i > 0 ? `/docs/${keys[i - 1]}` : null;
+            metadata[key].next = i < keys.length - 1 ? `/docs/${keys[i + 1]}` : null;
+        }
+    }
+
+    return metadata;
+}