react-docs-ui 0.5.4 → 0.6.0

package/dist/types/lib/ai/providers/openai.d.ts

@@ -0,0 +1,37 @@
+import { BaseAIProvider } from './base';
+import { ChatMessage, StreamEvent, TestConnectionResult } from '../types';
+interface OpenAIMessage {
+    role: 'system' | 'user' | 'assistant';
+    content: string;
+}
+interface OpenAIRequest {
+    model: string;
+    messages: OpenAIMessage[];
+    max_tokens?: number;
+    temperature?: number;
+    stream: boolean;
+}
+export declare class OpenAIProvider extends BaseAIProvider {
+    /**
+     * 发送聊天消息（流式输出）
+     */
+    chat(messages: ChatMessage[], onEvent: (event: StreamEvent) => void, signal?: AbortSignal): Promise<void>;
+    /**
+     * 测试连接
+     */
+    testConnection(): Promise<TestConnectionResult>;
+    /**
+     * 构建请求头
+     */
+    protected buildHeaders(): Record<string, string>;
+    /**
+     * 构建请求体
+     */
+    protected buildRequestBody(messages: ChatMessage[]): OpenAIRequest;
+    /**
+     * 解析流式响应
+     */
+    protected parseStreamChunk(chunk: string, onEvent: (event: StreamEvent) => void): void;
+}
+export {};
+//# sourceMappingURL=openai.d.ts.map

package/dist/types/lib/ai/providers/openai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../../../../src/lib/ai/providers/openai.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAA;AACvC,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAA;AAE9E,UAAU,aAAa;IACrB,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAA;IACrC,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,UAAU,aAAa;IACrB,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,aAAa,EAAE,CAAA;IACzB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,EAAE,OAAO,CAAA;CAChB;AAeD,qBAAa,cAAe,SAAQ,cAAc;IAChD;;OAEG;IACG,IAAI,CACR,QAAQ,EAAE,WAAW,EAAE,EACvB,OAAO,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,EACrC,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC;IAyBhB;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,oBAAoB,CAAC;IA8CrD;;OAEG;IACH,SAAS,CAAC,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAOhD;;OAEG;IACH,SAAS,CAAC,gBAAgB,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,aAAa;IA6BlE;;OAEG;IACH,SAAS,CAAC,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,GAAG,IAAI;CAmCvF"}

package/dist/types/lib/ai/types.d.ts

@@ -0,0 +1,162 @@
+/**
+ * AI模块类型定义
+ */
+/** 单个模型配置 */
+export interface AIModelConfig {
+    /** 模型ID */
+    modelId: string;
+    /** API密钥（加密存储） */
+    apiKey: string;
+    /** API基础URL */
+    baseUrl: string;
+    /** 最大输出token数 */
+    maxTokens: number;
+    /** 温度参数 */
+    temperature: number;
+    /** 是否启用 */
+    enabled?: boolean;
+}
+/** AI功能配置 */
+export interface AIFeaturesConfig {
+    /** 聊天助手 */
+    chatAssistant: boolean;
+    /** 文档摘要 */
+    documentSummary: boolean;
+    /** 代码解释 */
+    codeExplanation: boolean;
+    /** 搜索增强 */
+    searchEnhancement: boolean;
+}
+/** AI UI配置 */
+export interface AIUIConfig {
+    /** 位置 */
+    position: 'bottom-left' | 'bottom-center' | 'bottom-right';
+    /** 主题 */
+    theme: 'light' | 'dark' | 'auto';
+    /** 尺寸 */
+    size: 'small' | 'medium' | 'large';
+}
+/** 完整的AI配置 */
+export interface AIConfig {
+    /** 是否启用AI功能 */
+    enabled: boolean;
+    /** 当前选中的提供商（可以是预定义的，也可以是自定义的名称，如 "deepseek"） */
+    provider: string;
+    /** 系统提示词 */
+    systemPrompt: string;
+    /** 各提供商的模型配置（支持动态添加自定义 Provider） */
+    models: Record<string, AIModelConfig>;
+    /** 功能开关 */
+    features: AIFeaturesConfig;
+    /** UI配置 */
+    ui: AIUIConfig;
+}
+/** 聊天消息角色 */
+export type ChatMessageRole = 'user' | 'assistant' | 'system';
+/** 聊天消息 */
+export interface ChatMessage {
+    /** 消息ID */
+    id: string;
+    /** 角色 */
+    role: ChatMessageRole;
+    /** 内容 */
+    content: string;
+    /** 时间戳 */
+    timestamp: number;
+    /** 是否正在生成（流式输出时使用） */
+    isStreaming?: boolean;
+    /** 错误信息 */
+    error?: string;
+}
+/** 对话上下文 */
+export interface ChatContext {
+    /** 选中的文本 */
+    selectedText?: string;
+    /** 当前页面标题 */
+    pageTitle?: string;
+    /** 当前页面URL */
+    pageUrl?: string;
+    /** 额外上下文 */
+    extraContext?: string;
+}
+/** 对话会话 */
+export interface ChatSession {
+    /** 会话ID */
+    id: string;
+    /** 会话标题 */
+    title: string;
+    /** 消息列表 */
+    messages: ChatMessage[];
+    /** 创建时间 */
+    createdAt: number;
+    /** 更新时间 */
+    updatedAt: number;
+    /** 关联的上下文 */
+    context?: ChatContext;
+}
+/** 聊天选项 */
+export interface ChatOptions {
+    /** 使用的模型配置 */
+    modelConfig?: AIModelConfig;
+    /** 温度覆盖 */
+    temperature?: number;
+    /** 最大token覆盖 */
+    maxTokens?: number;
+    /** 是否流式输出 */
+    stream?: boolean;
+    /** 超时时间(ms)，默认60000 */
+    timeout?: number;
+    /** 重试次数，默认3 */
+    retryCount?: number;
+    /** 重试延迟(ms)，默认1000 */
+    retryDelay?: number;
+}
+/** AI Provider配置（内部使用） */
+export interface AIProviderConfig {
+    /** Provider类型 */
+    type: string;
+    /** API密钥 */
+    apiKey: string;
+    /** 基础URL */
+    baseUrl: string;
+    /** 模型ID */
+    modelId: string;
+    /** 系统提示词 */
+    systemPrompt?: string;
+    /** 最大token */
+    maxTokens?: number;
+    /** 温度 */
+    temperature?: number;
+}
+/** 流式响应事件 */
+export interface StreamEvent {
+    /** 事件类型 */
+    type: 'start' | 'delta' | 'done' | 'error';
+    /** 内容增量 */
+    content?: string;
+    /** 错误信息 */
+    error?: string;
+}
+/** 测试连接结果 */
+export interface TestConnectionResult {
+    success: boolean;
+    message: string;
+    modelInfo?: {
+        id: string;
+        name?: string;
+    };
+}
+/** AI状态 */
+export interface AIState {
+    /** 是否已配置 */
+    isConfigured: boolean;
+    /** 当前配置 */
+    config: AIConfig | null;
+    /** 当前会话 */
+    currentSession: ChatSession | null;
+    /** 是否正在加载 */
+    isLoading: boolean;
+    /** 错误信息 */
+    error: string | null;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types/lib/ai/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/lib/ai/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,aAAa;AACb,MAAM,WAAW,aAAa;IAC5B,WAAW;IACX,OAAO,EAAE,MAAM,CAAA;IACf,kBAAkB;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,eAAe;IACf,OAAO,EAAE,MAAM,CAAA;IACf,iBAAiB;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW;IACX,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW;IACX,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,aAAa;AACb,MAAM,WAAW,gBAAgB;IAC/B,WAAW;IACX,aAAa,EAAE,OAAO,CAAA;IACtB,WAAW;IACX,eAAe,EAAE,OAAO,CAAA;IACxB,WAAW;IACX,eAAe,EAAE,OAAO,CAAA;IACxB,WAAW;IACX,iBAAiB,EAAE,OAAO,CAAA;CAC3B;AAED,cAAc;AACd,MAAM,WAAW,UAAU;IACzB,SAAS;IACT,QAAQ,EAAE,aAAa,GAAG,eAAe,GAAG,cAAc,CAAA;IAC1D,SAAS;IACT,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAA;IAChC,SAAS;IACT,IAAI,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAA;CACnC;AAED,cAAc;AACd,MAAM,WAAW,QAAQ;IACvB,eAAe;IACf,OAAO,EAAE,OAAO,CAAA;IAChB,gDAAgD;IAChD,QAAQ,EAAE,MAAM,CAAA;IAChB,YAAY;IACZ,YAAY,EAAE,MAAM,CAAA;IACpB,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;IACrC,WAAW;IACX,QAAQ,EAAE,gBAAgB,CAAA;IAC1B,WAAW;IACX,EAAE,EAAE,UAAU,CAAA;CACf;AAED,aAAa;AACb,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAA;AAE7D,WAAW;AACX,MAAM,WAAW,WAAW;IAC1B,WAAW;IACX,EAAE,EAAE,MAAM,CAAA;IACV,SAAS;IACT,IAAI,EAAE,eAAe,CAAA;IACrB,SAAS;IACT,OAAO,EAAE,MAAM,CAAA;IACf,UAAU;IACV,SAAS,EAAE,MAAM,CAAA;IACjB,sBAAsB;IACtB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,WAAW;IACX,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,YAAY;AACZ,MAAM,WAAW,WAAW;IAC1B,YAAY;IACZ,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,aAAa;IACb,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,cAAc;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,YAAY;IACZ,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,WAAW;AACX,MAAM,WAAW,WAAW;IAC1B,WAAW;IACX,EAAE,EAAE,MAAM,CAAA;IACV,WAAW;IACX,KAAK,EAAE,MAAM,CAAA;IACb,WAAW;IACX,QAAQ,EAAE,WAAW,EAAE,CAAA;IACvB,WAAW;IACX,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW;IACX,SAAS,EAAE,MAAM,CAAA;IACjB,aAAa;IACb,OAAO,CAAC,EAAE,WAAW,CAAA;CACtB;AAED,WAAW;AACX,MAAM,WAAW,WAAW;IAC1B,cAAc;IACd,WAAW,CAAC,EAAE,aAAa,CAAA;IAC3B,WAAW;IACX,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,gBAAgB;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,aAAa;IACb,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,uBAAuB;IACvB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,eAAe;IACf,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,sBAAsB;IACtB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,0BAA0B;AAC1B,MAAM,WAAW,gBAAgB;IAC/B,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,YAAY;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,YAAY;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,WAAW;IACX,OAAO,EAAE,MAAM,CAAA;IACf,YAAY;IACZ,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,cAAc;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS;IACT,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,aAAa;AACb,MAAM,WAAW,WAAW;IAC1B,WAAW;IACX,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,CAAA;IAC1C,WAAW;IACX,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW;IACX,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,aAAa;AACb,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE;QACV,EAAE,EAAE,MAAM,CAAA;QACV,IAAI,CAAC,EAAE,MAAM,CAAA;KACd,CAAA;CACF;AAED,WAAW;AACX,MAAM,WAAW,OAAO;IACtB,YAAY;IACZ,YAAY,EAAE,OAAO,CAAA;IACrB,WAAW;IACX,MAAM,EAAE,QAAQ,GAAG,IAAI,CAAA;IACvB,WAAW;IACX,cAAc,EAAE,WAAW,GAAG,IAAI,CAAA;IAClC,aAAa;IACb,SAAS,EAAE,OAAO,CAAA;IAClB,WAAW;IACX,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CACrB"}

package/dist/types/lib/component-scanner.d.ts

@@ -0,0 +1,53 @@
+import { default as React } from 'react';
+/**
+ * 组件注册表类型
+ */
+export interface ComponentRegistry {
+    [componentName: string]: React.ComponentType<any>;
+}
+/**
+ * 组件配置类型
+ */
+export interface ComponentConfig {
+    name: string;
+    path: string;
+}
+/**
+ * 扫描 src/components 目录并返回组件列表
+ * 注意：这个函数在库中被禁用，只在 template 运行时可能通过 Vite 插件工作
+ *
+ * @param componentsPath 组件目录路径（相对于项目根目录）
+ * @returns 组件配置列表
+ */
+export declare function scanComponents(_componentsPath?: string): Promise<ComponentConfig[]>;
+/**
+ * 从配置创建组件列表
+ * @param componentsConfig 配置中的组件映射
+ * @returns 组件配置列表
+ */
+export declare function createComponentsFromConfig(componentsConfig?: Record<string, string>): ComponentConfig[];
+/**
+ * 动态导入组件
+ * @param componentPath 组件文件路径
+ * @returns 组件模块
+ */
+export declare function importComponent(componentPath: string): Promise<React.ComponentType<any> | null>;
+/**
+ * 批量加载组件并创建注册表
+ * @param components 组件配置列表
+ * @param componentsConfig 配置中的组件映射（可选）
+ * @returns 组件注册表
+ */
+export declare function loadComponents(_components: ComponentConfig[], componentsConfig?: Record<string, string>): Promise<ComponentRegistry>;
+/**
+ * 获取内置组件
+ * @returns 内置组件注册表
+ */
+export declare function getBuiltinComponents(): ComponentRegistry;
+/**
+ * 合并默认组件和自定义组件
+ * @param customComponents 自定义组件注册表
+ * @returns 合并后的组件注册表
+ */
+export declare function mergeComponents(customComponents?: ComponentRegistry): Record<string, React.ComponentType<any>>;
+//# sourceMappingURL=component-scanner.d.ts.map

package/dist/types/lib/component-scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-scanner.d.ts","sourceRoot":"","sources":["../../../src/lib/component-scanner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,CAAC,aAAa,EAAE,MAAM,GAAG,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,CAAA;CAClD;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;CACb;AA8BD;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,eAAe,GAAE,MAA0B,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAI5G;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,eAAe,EAAE,CASvG;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAcrG;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,WAAW,EAAE,eAAe,EAAE,EAC9B,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACxC,OAAO,CAAC,iBAAiB,CAAC,CA2B5B;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,iBAAiB,CAExD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,gBAAgB,GAAE,iBAAsB,GACvC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAK1C"}

package/dist/types/lib/config.d.ts

@@ -0,0 +1,133 @@
+export interface SiteConfig {
+    site: {
+        logo: string | {
+            light: string;
+            dark: string;
+        };
+        title: string;
+        description: string;
+    };
+    navbar: {
+        showLogo?: boolean;
+        showTitle?: boolean;
+        showLanguageSwitcher?: boolean;
+        items: {
+            title: string;
+            link: string;
+            external?: boolean;
+            visible?: boolean;
+        }[];
+        actions?: {
+            type?: "github" | "custom";
+            title?: string;
+            link: string;
+            icon?: string;
+            enabled?: boolean;
+        }[];
+    };
+    sidebar: {
+        enabled?: boolean;
+        sections?: {
+            title: string;
+            path?: string;
+            children?: {
+                title: string;
+                path: string;
+            }[];
+        }[];
+        collections?: Record<string, {
+            sections: {
+                title: string;
+                path: string;
+                children?: {
+                    title: string;
+                    path: string;
+                }[];
+            }[];
+        }>;
+    };
+    theme?: {
+        allowToggle?: boolean;
+    };
+    footer?: {
+        enabled?: boolean;
+        copyright?: string;
+        repository?: {
+            url?: string;
+            branch?: string;
+        };
+        lastUpdated?: string;
+        version?: string;
+        groups?: {
+            title: string;
+            items: {
+                title: string;
+                link: string;
+                external?: boolean;
+            }[];
+        }[];
+        links?: {
+            title: string;
+            link: string;
+            external?: boolean;
+        }[];
+        social?: {
+            name: string;
+            url?: string;
+            link?: string;
+            icon?: string;
+        }[];
+        builtWith?: {
+            name: string;
+            url?: string;
+        }[];
+    };
+    pwa?: {
+        enabled?: boolean;
+        name?: string;
+        shortName?: string;
+        description?: string;
+        themeColor?: string;
+        backgroundColor?: string;
+    };
+    contextMenu?: {
+        enabled?: boolean;
+        page?: {
+            copyUrl?: boolean;
+            copyTitle?: boolean;
+            copyMarkdownLink?: boolean;
+            copySelectedText?: boolean;
+            openInNewTab?: boolean;
+            reload?: boolean;
+            printPage?: boolean;
+            scrollToTop?: boolean;
+            scrollToBottom?: boolean;
+        };
+        site?: {
+            goHome?: boolean;
+            quickNav?: boolean;
+            language?: boolean;
+        };
+        appearance?: {
+            theme?: boolean;
+            resetThemePref?: boolean;
+        };
+    };
+    mdx?: {
+        componentsPath?: string;
+        enabled?: boolean;
+        components?: {
+            [componentName: string]: string;
+        };
+    };
+    toc?: {
+        enabled?: boolean;
+        maxLevel?: number;
+        title?: string;
+    };
+    ai?: {
+        enabled?: boolean;
+    };
+}
+export declare function getConfig(lang?: string): Promise<SiteConfig | null>;
+//# sourceMappingURL=config.d.ts.map

package/dist/types/lib/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/lib/config.ts"],"names":[],"mappings":"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"}

package/dist/types/lib/doc-index.d.ts

@@ -0,0 +1,31 @@
+interface DocItem {
+    title: string;
+    path: string;
+    lang: string;
+    order?: number;
+    description?: string;
+    tags?: string[];
+}
+declare class DocIndexCache {
+    private cache;
+    private ttl;
+    /**
+     * 获取文档索引（带缓存）
+     */
+    getDocuments(lang: string): Promise<DocItem[]>;
+    /**
+     * 搜索文档（带缓存）
+     */
+    searchDocuments(lang: string, query: string): Promise<DocItem[]>;
+    /**
+     * 使缓存失效
+     */
+    invalidate(lang?: string): void;
+    /**
+     * 清空所有缓存
+     */
+    clear(): void;
+}
+export declare const docIndexCache: DocIndexCache;
+export {};
+//# sourceMappingURL=doc-index.d.ts.map

package/dist/types/lib/doc-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc-index.d.ts","sourceRoot":"","sources":["../../../src/lib/doc-index.ts"],"names":[],"mappings":"AAGA,UAAU,OAAO;IACf,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;CAChB;AAED,cAAM,aAAa;IACjB,OAAO,CAAC,KAAK,CAAiE;IAC9E,OAAO,CAAC,GAAG,CAAwB;IAEnC;;OAEG;IACG,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAgBpD;;OAEG;IACG,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAKtE;;OAEG;IACH,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM;IAQxB;;OAEG;IACH,KAAK;CAGN;AAGD,eAAO,MAAM,aAAa,eAAsB,CAAA"}

package/dist/types/lib/doc-scanner.d.ts

@@ -0,0 +1,17 @@
+export interface DocItem {
+    title: string;
+    path: string;
+    lang: string;
+    order?: number;
+    description?: string;
+    tags?: string[];
+}
+/**
+ * 从配置文件中扫描所有文档
+ */
+export declare function scanDocuments(lang?: string): Promise<DocItem[]>;
+/**
+ * 搜索文档（支持模糊搜索）
+ */
+export declare function searchDocuments(docs: DocItem[], query: string): DocItem[];
+//# sourceMappingURL=doc-scanner.d.ts.map

package/dist/types/lib/doc-scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc-scanner.d.ts","sourceRoot":"","sources":["../../../src/lib/doc-scanner.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;CAChB;AAiDD;;GAEG;AACH,wBAAsB,aAAa,CAAC,IAAI,GAAE,MAAgB,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAsD9E;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,EAAE,CAazE"}

package/dist/types/lib/navigation.d.ts

@@ -0,0 +1,8 @@
+import { SiteConfig } from './config';
+import { NavigationItem } from '../components/PageNavigation';
+export interface NavigationResult {
+    prev: NavigationItem | null;
+    next: NavigationItem | null;
+}
+export declare function getPrevNextPage(sidebar: SiteConfig["sidebar"] | undefined, currentPath: string, firstSegment: string): NavigationResult;
+//# sourceMappingURL=navigation.d.ts.map

package/dist/types/lib/navigation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation.d.ts","sourceRoot":"","sources":["../../../src/lib/navigation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAC1C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAA;AAElE,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,cAAc,GAAG,IAAI,CAAA;IAC3B,IAAI,EAAE,cAAc,GAAG,IAAI,CAAA;CAC5B;AAED,wBAAgB,eAAe,CAC7B,OAAO,EAAE,UAAU,CAAC,SAAS,CAAC,GAAG,SAAS,EAC1C,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GACnB,gBAAgB,CAgDlB"}

package/dist/types/lib/rehype-component.d.ts

@@ -0,0 +1,8 @@
+import { Plugin } from 'unified';
+import { Root } from 'hast';
+/**
+ * 创建一个 rehype 插件，将特定的 HTML 标签转换为 React 组件
+ * @param components React 组件映射
+ */
+export declare function rehypeComponent(components: Record<string, React.ComponentType<any>>): Plugin<[], Root>;
+//# sourceMappingURL=rehype-component.d.ts.map

package/dist/types/lib/rehype-component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rehype-component.d.ts","sourceRoot":"","sources":["../../../src/lib/rehype-component.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAErC,OAAO,KAAK,EAAE,IAAI,EAAW,MAAM,MAAM,CAAA;AAEzC;;;GAGG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,CA2BtG"}

package/dist/types/lib/rehype-toc.d.ts

@@ -0,0 +1,10 @@
+import { Root } from 'mdast';
+export interface TocItem {
+    title: string;
+    url: string;
+    depth: number;
+}
+export declare function rehypeToc(options?: {
+    maxLevel?: number;
+}): (tree: Root) => void;
+//# sourceMappingURL=rehype-toc.d.ts.map

package/dist/types/lib/rehype-toc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rehype-toc.d.ts","sourceRoot":"","sources":["../../../src/lib/rehype-toc.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAW,MAAM,OAAO,CAAC;AAE3C,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,SAAS,CAAC,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,IAGnD,MAAM,IAAI,UAiCnB"}

package/dist/types/lib/shiki-highlighter.d.ts

@@ -0,0 +1,10 @@
+import { Highlighter } from 'shiki';
+export declare function getHighlighter(): Promise<Highlighter>;
+export interface HighlightOptions {
+    lang?: string;
+    theme?: 'github-light' | 'github-dark';
+    showLineNumbers?: boolean;
+}
+export declare function highlightCode(code: string, options?: HighlightOptions): Promise<string>;
+export declare function resolveLang(lang: string | undefined): string;
+//# sourceMappingURL=shiki-highlighter.d.ts.map

package/dist/types/lib/shiki-highlighter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shiki-highlighter.d.ts","sourceRoot":"","sources":["../../../src/lib/shiki-highlighter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiC,KAAK,WAAW,EAAyB,MAAM,OAAO,CAAA;AAK9F,wBAAsB,cAAc,IAAI,OAAO,CAAC,WAAW,CAAC,CAkD3D;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,cAAc,GAAG,aAAa,CAAA;IACtC,eAAe,CAAC,EAAE,OAAO,CAAA;CAC1B;AAYD,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,MAAM,CAAC,CAqCjB;AAWD,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAiB5D"}

package/dist/types/lib/utils.d.ts

@@ -0,0 +1,4 @@
+import { ClassValue } from 'clsx';
+export declare function cn(...inputs: ClassValue[]): string;
+export declare function toBase64(str: string): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/types/lib/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/lib/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAQ,MAAM,MAAM,CAAA;AAG5C,wBAAgB,EAAE,CAAC,GAAG,MAAM,EAAE,UAAU,EAAE,UAEzC;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,UAEnC"}

package/dist/types/vite-env.d.ts

@@ -0,0 +1 @@
+/// <reference types="vite/client" />

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "react-docs-ui",
-    "version": "0.5.4",
+    "version": "0.6.0",
     "type": "module",
     "description": "React documentation site UI components — navigation, sidebar, search, code highlight, MDX rendering and theming to help you build docs fast.",
     "homepage": "https://shenjianZ.github.io/react-docs-ui",
@@ -47,7 +47,9 @@
         "@radix-ui/react-dropdown-menu": "^2.1.15",
         "@radix-ui/react-scroll-area": "^1.2.9",
         "@radix-ui/react-slot": "^1.2.3",
+        "@radix-ui/react-toast": "^1.2.15",
         "@radix-ui/react-tooltip": "^1.2.7",
+        "@shikijs/transformers": "^4.0.1",
         "class-variance-authority": "^0.7.1",
         "clsx": "^2.1.1",
         "cmdk": "^1.1.1",
@@ -56,16 +58,20 @@
         "katex": "^0.16.11",
         "katex-physics": "^1.0.2",
         "lucide-react": "^0.539.0",
+        "mdast": "^2.3.2",
         "next-themes": "^0.4.6",
         "react-markdown": "^10.1.0",
         "rehype-autolink-headings": "^7.1.0",
-        "rehype-highlight": "^7.0.2",
         "rehype-katex": "^7.0.1",
         "rehype-raw": "^7.0.0",
         "rehype-slug": "^6.0.0",
         "remark-gfm": "^4.0.1",
         "remark-math": "^6.0.0",
+        "remark-parse": "^11.0.0",
+        "remark-rehype": "^11.1.2",
+        "shiki": "^4.0.1",
         "tailwind-merge": "^3.3.1",
+        "unified": "^11.0.5",
         "unist-util-visit": "^5.1.0"
     },
     "devDependencies": {