@linyjs/plugin-docs 0.1.0

package/examples/blog-plugin/dist/client/index.js

@@ -0,0 +1,197 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import React from 'react';
+const API_BASE = '/api/articles';
+/**
+ * 文章列表组件
+ */
+function ArticleList() {
+    const [articles, setArticles] = React.useState([]);
+    const [loading, setLoading] = React.useState(true);
+    const [error, setError] = React.useState(null);
+    React.useEffect(() => {
+        loadArticles();
+    }, []);
+    const loadArticles = async () => {
+        try {
+            setLoading(true);
+            const response = await fetch(API_BASE);
+            const result = await response.json();
+            setArticles(result.data || result);
+        }
+        catch (err) {
+            setError(err.message || 'Failed to load articles');
+        }
+        finally {
+            setLoading(false);
+        }
+    };
+    if (loading)
+        return _jsx("div", { className: "text-center py-8", children: "\u52A0\u8F7D\u4E2D..." });
+    if (error)
+        return _jsxs("div", { className: "text-red-500 text-center py-8", children: ["\u9519\u8BEF: ", error] });
+    return (_jsxs("div", { className: "max-w-4xl mx-auto px-4 py-8", children: [_jsxs("div", { className: "flex justify-between items-center mb-8", children: [_jsx("h1", { className: "text-3xl font-bold text-gray-900", children: "\u6587\u7AE0\u5217\u8868" }), _jsx("button", { onClick: () => window.location.href = '/blog/new', className: "bg-blue-600 text-white px-4 py-2 rounded hover:bg-blue-700", children: "\u5199\u6587\u7AE0" })] }), articles.length === 0 ? (_jsxs("div", { className: "text-center py-12", children: [_jsx("p", { className: "text-gray-500 mb-4", children: "\u6682\u65E0\u6587\u7AE0" }), _jsx("button", { onClick: () => window.location.href = '/blog/new', className: "text-blue-600 hover:underline", children: "\u5199\u7B2C\u4E00\u7BC7\u6587\u7AE0" })] })) : (_jsx("div", { className: "grid gap-6 md:grid-cols-2 lg:grid-cols-3", children: articles.map((article) => (_jsxs("div", { className: "bg-white rounded-lg shadow-md p-6 hover:shadow-lg transition-shadow", children: [_jsx("h2", { className: "text-xl font-semibold mb-2 text-gray-900", children: _jsx("a", { href: `/blog/${article.id}`, className: "hover:text-blue-600", children: article.title }) }), _jsxs("p", { className: "text-gray-600 mb-4 line-clamp-3", children: [article.content?.substring(0, 120), "..."] }), _jsxs("div", { className: "flex justify-between items-center text-sm text-gray-500", children: [_jsx("span", { className: "font-medium", children: article.author || '匿名' }), _jsx("span", { children: new Date(article.createdAt).toLocaleDateString() })] })] }, article.id))) }))] }));
+}
+/**
+ * 文章详情组件
+ */
+function ArticleDetail() {
+    const [article, setArticle] = React.useState(null);
+    const [loading, setLoading] = React.useState(true);
+    const [error, setError] = React.useState(null);
+    // 获取URL参数
+    const urlParams = new URLSearchParams(window.location.search);
+    const id = urlParams.get('id');
+    React.useEffect(() => {
+        if (id) {
+            loadArticle(id);
+        }
+    }, [id]);
+    const loadArticle = async (articleId) => {
+        try {
+            setLoading(true);
+            const response = await fetch(`${API_BASE}/${articleId}`);
+            const result = await response.json();
+            setArticle(result);
+        }
+        catch (err) {
+            setError(err.message || 'Failed to load article');
+        }
+        finally {
+            setLoading(false);
+        }
+    };
+    if (loading)
+        return _jsx("div", { className: "text-center py-8", children: "\u52A0\u8F7D\u4E2D..." });
+    if (error)
+        return _jsxs("div", { className: "text-red-500 text-center py-8", children: ["\u9519\u8BEF: ", error] });
+    if (!article)
+        return _jsx("div", { className: "text-center py-8", children: "\u6587\u7AE0\u4E0D\u5B58\u5728" });
+    return (_jsxs("div", { className: "max-w-4xl mx-auto px-4 py-8", children: [_jsx("button", { onClick: () => window.history.back(), className: "mb-4 text-blue-600 hover:underline", children: "\u2190 \u8FD4\u56DE\u5217\u8868" }), _jsxs("article", { className: "bg-white rounded-lg shadow-md p-8", children: [_jsx("h1", { className: "text-4xl font-bold mb-4 text-gray-900", children: article.title }), _jsxs("div", { className: "flex justify-between items-center mb-8 pb-4 border-b", children: [_jsx("div", { className: "text-gray-600", children: _jsxs("span", { className: "font-medium", children: ["\u4F5C\u8005: ", article.author || '匿名'] }) }), _jsx("div", { className: "text-gray-500", children: _jsxs("span", { children: ["\u53D1\u5E03\u4E8E ", new Date(article.createdAt).toLocaleString()] }) })] }), _jsx("div", { className: "prose prose-lg max-w-none", children: _jsx("div", { dangerouslySetInnerHTML: { __html: formatContent(article.content) } }) }), article.updatedAt && article.updatedAt !== article.createdAt && (_jsx("div", { className: "mt-8 pt-4 border-t text-sm text-gray-500", children: _jsxs("span", { children: ["\u6700\u540E\u7F16\u8F91\u4E8E ", new Date(article.updatedAt).toLocaleString()] }) }))] })] }));
+}
+/**
+ * 文章编辑表单组件
+ */
+function ArticleForm() {
+    const [title, setTitle] = React.useState('');
+    const [content, setContent] = React.useState('');
+    const [author, setAuthor] = React.useState('');
+    const [loading, setLoading] = React.useState(false);
+    const [error, setError] = React.useState(null);
+    // 检查是否为编辑模式
+    const urlParams = new URLSearchParams(window.location.search);
+    const editId = urlParams.get('edit');
+    const isEdit = Boolean(editId);
+    React.useEffect(() => {
+        if (isEdit && editId) {
+            loadArticleForEdit(editId);
+        }
+    }, [isEdit, editId]);
+    const loadArticleForEdit = async (articleId) => {
+        try {
+            const response = await fetch(`${API_BASE}/${articleId}`);
+            const article = await response.json();
+            setTitle(article.title || '');
+            setContent(article.content || '');
+            setAuthor(article.author || '');
+        }
+        catch (err) {
+            setError('加载文章失败: ' + err.message);
+        }
+    };
+    const handleSubmit = async (e) => {
+        e.preventDefault();
+        if (!title.trim() || !content.trim()) {
+            setError('标题和内容不能为空');
+            return;
+        }
+        setLoading(true);
+        setError(null);
+        try {
+            const method = isEdit ? 'PUT' : 'POST';
+            const url = isEdit ? `${API_BASE}/${editId}` : API_BASE;
+            const response = await fetch(url, {
+                method,
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ title, content, author })
+            });
+            const result = await response.json();
+            if (result.success) {
+                // 重定向到文章列表
+                window.location.href = '/blog';
+            }
+            else {
+                throw new Error(result.data?.error || '保存失败');
+            }
+        }
+        catch (err) {
+            setError(err.message);
+        }
+        finally {
+            setLoading(false);
+        }
+    };
+    return (_jsxs("div", { className: "max-w-4xl mx-auto px-4 py-8", children: [_jsx("button", { onClick: () => window.history.back(), className: "mb-4 text-blue-600 hover:underline", children: "\u2190 \u8FD4\u56DE" }), _jsxs("div", { className: "bg-white rounded-lg shadow-md p-8", children: [_jsx("h1", { className: "text-3xl font-bold mb-8 text-gray-900", children: isEdit ? '编辑文章' : '写新文章' }), error && (_jsx("div", { className: "mb-4 p-3 bg-red-100 text-red-700 rounded", children: error })), _jsxs("form", { onSubmit: handleSubmit, className: "space-y-6", children: [_jsxs("div", { children: [_jsx("label", { className: "block text-sm font-medium text-gray-700 mb-2", children: "\u6807\u9898 *" }), _jsx("input", { type: "text", value: title, onChange: (e) => setTitle(e.target.value), className: "w-full px-3 py-2 border border-gray-300 rounded-md focus:outline-none focus:ring-2 focus:ring-blue-500", placeholder: "\u8F93\u5165\u6587\u7AE0\u6807\u9898", required: true })] }), _jsxs("div", { children: [_jsx("label", { className: "block text-sm font-medium text-gray-700 mb-2", children: "\u4F5C\u8005" }), _jsx("input", { type: "text", value: author, onChange: (e) => setAuthor(e.target.value), className: "w-full px-3 py-2 border border-gray-300 rounded-md focus:outline-none focus:ring-2 focus:ring-blue-500", placeholder: "\u4F5C\u8005\u59D3\u540D (\u53EF\u9009)" })] }), _jsxs("div", { children: [_jsx("label", { className: "block text-sm font-medium text-gray-700 mb-2", children: "\u5185\u5BB9 *" }), _jsx("textarea", { value: content, onChange: (e) => setContent(e.target.value), rows: 12, className: "w-full px-3 py-2 border border-gray-300 rounded-md focus:outline-none focus:ring-2 focus:ring-blue-500", placeholder: "\u5728\u8FD9\u91CC\u5199\u4E0B\u4F60\u7684\u6587\u7AE0\u5185\u5BB9...", required: true })] }), _jsxs("div", { className: "flex justify-end space-x-4", children: [_jsx("button", { type: "button", onClick: () => window.history.back(), className: "px-6 py-2 border border-gray-300 text-gray-700 rounded-md hover:bg-gray-50", children: "\u53D6\u6D88" }), _jsx("button", { type: "submit", disabled: loading, className: "px-6 py-2 bg-blue-600 text-white rounded-md hover:bg-blue-700 disabled:opacity-50", children: loading ? '保存中...' : (isEdit ? '更新' : '发布') })] })] })] })] }));
+}
+/**
+ * 博客主页组件
+ */
+function BlogHome() {
+    return (_jsxs("div", { className: "min-h-screen bg-gray-50", children: [_jsx("nav", { className: "bg-white shadow-sm", children: _jsx("div", { className: "max-w-4xl mx-auto px-4 py-4", children: _jsxs("div", { className: "flex justify-between items-center", children: [_jsx("h1", { className: "text-2xl font-bold text-gray-900", children: _jsx("a", { href: "/blog", className: "hover:text-blue-600", children: "\u6211\u7684\u535A\u5BA2" }) }), _jsxs("div", { className: "flex space-x-4", children: [_jsx("a", { href: "/blog", className: "text-gray-600 hover:text-blue-600", children: "\u6587\u7AE0\u5217\u8868" }), _jsx("a", { href: "/blog/new", className: "text-gray-600 hover:text-blue-600", children: "\u5199\u6587\u7AE0" })] })] }) }) }), _jsx("main", { children: _jsx("div", { id: "blog-content", children: window.location.search.includes('id=') ? (_jsx(ArticleDetail, {})) : window.location.pathname.includes('/new') || window.location.search.includes('edit=') ? (_jsx(ArticleForm, {})) : (_jsx(ArticleList, {})) }) })] }));
+}
+/**
+ * 简单的markdown格式化（支持基本的HTML标签）
+ */
+function formatContent(content) {
+    return content
+        .replace(/\n/g, '<br>')
+        .replace(/\*\*(.*?)\*\*/g, '<strong>$1</strong>')
+        .replace(/\*(.*?)\*/g, '<em>$1</em>')
+        .replace(/`(.*?)`/g, '<code>$1</code>');
+}
+/**
+ * 客户端模块定义
+ */
+export const blogClientModule = {
+    name: 'blogClient',
+    serviceDefs: [
+        {
+            serviceTag: 'blogRoute',
+            serviceImpl: class BlogRouteService {
+                constructor() {
+                    this.basePath = '/blog';
+                }
+                getRoutes() {
+                    return [
+                        {
+                            path: '/',
+                            component: BlogHome,
+                            key: 'blog-home',
+                            meta: {
+                                title: '博客首页 - linyjs示例',
+                                description: '一个简单的博客示例，展示linyjs插件开发'
+                            }
+                        }
+                    ];
+                }
+            },
+            meta: { usageType: 'route' }
+        },
+        {
+            serviceTag: 'blogComponent',
+            serviceImpl: class BlogComponentService {
+                // 注册全局组件
+                getComponents() {
+                    return {
+                        BlogHome,
+                        ArticleList,
+                        ArticleDetail,
+                        ArticleForm
+                    };
+                }
+            },
+            meta: { usageType: 'component' }
+        }
+    ]
+};
+// 导出组件方便其他模块使用
+export { BlogHome, ArticleList, ArticleDetail, ArticleForm };

package/examples/blog-plugin/dist/server/index.d.ts

@@ -0,0 +1,5 @@
+import type { IModule } from '@linyjs/server-module-interface';
+/**
+ * 服务端模块定义
+ */
+export declare const blogServerModule: IModule;

package/examples/blog-plugin/dist/server/index.js

@@ -0,0 +1,220 @@
+/**
+ * 文章服务 - 处理文章的业务逻辑
+ */
+class ArticleService {
+    constructor() {
+        this.articles = [];
+        this.nextId = 1;
+    }
+    /**
+     * 获取所有文章(支持分页)
+     */
+    async getArticles(page = 1, limit = 10) {
+        const skip = (page - 1) * limit;
+        const total = this.articles.length;
+        const items = this.articles.slice(skip, skip + limit);
+        return {
+            data: items,
+            total,
+            page,
+            limit,
+            totalPages: Math.ceil(total / limit)
+        };
+    }
+    /**
+     * 根据ID获取文章
+     */
+    async getArticleById(id) {
+        const article = this.articles.find(a => a.id === id);
+        if (!article) {
+            throw new Error('Article not found');
+        }
+        return article;
+    }
+    /**
+     * 创建文章
+     */
+    async createArticle(data) {
+        const article = {
+            id: this.nextId++,
+            title: data.title,
+            content: data.content,
+            author: data.author || 'Anonymous',
+            createdAt: new Date().toISOString(),
+            updatedAt: new Date().toISOString()
+        };
+        this.articles.push(article);
+        return article;
+    }
+    /**
+     * 更新文章
+     */
+    async updateArticle(id, data) {
+        const index = this.articles.findIndex(a => a.id === id);
+        if (index === -1) {
+            throw new Error('Article not found');
+        }
+        this.articles[index] = {
+            ...this.articles[index],
+            ...data,
+            updatedAt: new Date().toISOString()
+        };
+        return this.articles[index];
+    }
+    /**
+     * 删除文章
+     */
+    async deleteArticle(id) {
+        const index = this.articles.findIndex(a => a.id === id);
+        if (index === -1) {
+            throw new Error('Article not found');
+        }
+        this.articles.splice(index, 1);
+        return { success: true };
+    }
+}
+/**
+ * 文章控制器 - 定义API路由
+ */
+class ArticleController {
+    constructor() {
+        this.articleService = new ArticleService();
+    }
+    getRoutes() {
+        return [
+            // GET /api/articles - 获取文章列表
+            {
+                method: 'GET',
+                path: '/api/articles',
+                middlewares: [],
+                responseType: 'json',
+                handler: async (params, ctx) => {
+                    const page = parseInt(params.query?.page || '1');
+                    const limit = parseInt(params.query?.limit || '10');
+                    try {
+                        const result = await this.articleService.getArticles(page, limit);
+                        return result;
+                    }
+                    catch (error) {
+                        return {
+                            status: 500,
+                            data: { error: error.message }
+                        };
+                    }
+                }
+            },
+            // GET /api/articles/:id - 获取单篇文章
+            {
+                method: 'GET',
+                path: '/api/articles/:id',
+                middlewares: [],
+                responseType: 'json',
+                handler: async (params, ctx) => {
+                    try {
+                        const id = parseInt(params.id);
+                        const article = await this.articleService.getArticleById(id);
+                        return article;
+                    }
+                    catch (error) {
+                        return {
+                            status: 404,
+                            data: { error: error.message }
+                        };
+                    }
+                }
+            },
+            // POST /api/articles - 创建文章
+            {
+                method: 'POST',
+                path: '/api/articles',
+                middlewares: [],
+                responseType: 'json',
+                handler: async (params, ctx) => {
+                    try {
+                        const { title, content, author } = params.body;
+                        if (!title || !content) {
+                            return {
+                                status: 400,
+                                data: { error: 'Title and content are required' }
+                            };
+                        }
+                        const article = await this.articleService.createArticle({
+                            title,
+                            content,
+                            author
+                        });
+                        return {
+                            success: true,
+                            data: article
+                        };
+                    }
+                    catch (error) {
+                        return {
+                            status: 500,
+                            data: { error: error.message }
+                        };
+                    }
+                }
+            },
+            // PUT /api/articles/:id - 更新文章
+            {
+                method: 'PUT',
+                path: '/api/articles/:id',
+                middlewares: [],
+                responseType: 'json',
+                handler: async (params, ctx) => {
+                    try {
+                        const id = parseInt(params.id);
+                        const article = await this.articleService.updateArticle(id, params.body);
+                        return {
+                            success: true,
+                            data: article
+                        };
+                    }
+                    catch (error) {
+                        return {
+                            status: 404,
+                            data: { error: error.message }
+                        };
+                    }
+                }
+            },
+            // DELETE /api/articles/:id - 删除文章
+            {
+                method: 'DELETE',
+                path: '/api/articles/:id',
+                middlewares: [],
+                responseType: 'json',
+                handler: async (params, ctx) => {
+                    try {
+                        const id = parseInt(params.id);
+                        await this.articleService.deleteArticle(id);
+                        return {
+                            success: true,
+                            message: 'Article deleted successfully'
+                        };
+                    }
+                    catch (error) {
+                        return {
+                            status: 404,
+                            data: { error: error.message }
+                        };
+                    }
+                }
+            }
+        ];
+    }
+}
+/**
+ * 服务端模块定义
+ */
+export const blogServerModule = {
+    name: 'blogServer',
+    serviceDefs: [
+        {
+            serviceTag: 'articleController',
+            serviceImpl: ArticleController,
+            meta: { usageType: 'controller' }
+        }
+    ]
+};

package/examples/blog-plugin/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "@linyjs/example-blog-plugin",
+  "version": "1.0.0",
+  "description": "Blog plugin example with CRUD operations for linyjs framework",
+  "type": "module",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "pack": "npx @linyjs/cli pack"
+  },
+  "dependencies": {
+    "@linyjs/server-module-interface": "^0.0.1",
+    "@linyjs/client-module-interface": "^0.0.1",
+    "@linyjs/mongodb": "^0.0.1",
+    "react": "^19.0.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "@types/react": "^19.0.0"
+  },
+  "linyjs": {
+    "compatibleVersions": ">=0.0.1 <1.0.0"
+  }
+}