qy-better-lib 0.0.1

package/src/views/docs/styles/docs-content.scss

@@ -0,0 +1,106 @@
+// Docs Content Styles
+.docs-main {
+  flex: 1;
+  background-color: var(--el-bg-color);
+  border-radius: 8px;
+  box-shadow: var(--el-box-shadow-dark);
+  padding: 16px;
+  overflow-y: auto;
+  display: flex;
+  flex-direction: column;
+
+  .doc-header {
+    padding-bottom: 16px;
+    border-bottom: 1px solid var(--el-border-color);
+
+    h2 {
+      font-size: 22px;
+      font-weight: 600;
+      color: var(--el-text-color-primary);
+      line-height: 1.3;
+    }
+  }
+
+  .doc-content {
+    flex: 1 0 0;
+    padding: 16px 0;
+    overflow-y: auto;
+    scrollbar-width: none;
+
+    &::-webkit-scrollbar {
+      display: none;
+    }
+
+    h3 {
+      font-size: 18px;
+      font-weight: 600;
+      color: var(--el-text-color-regular);
+      padding-bottom: 10px;
+      border-bottom: 1px solid var(--el-border-color);
+    }
+
+    p {
+      color: var(--el-text-color-secondary);
+      line-height: 1.6;
+    }
+
+    ul,
+    ol {
+      color: var(--el-text-color-secondary);
+      line-height: 1.5;
+    }
+
+    li{
+      margin: 12px 0;
+    }
+
+    code {
+      background-color: var(--el-fill-color-light);
+      color: var(--el-color-danger);
+      padding: 2px 4px;
+      border-radius: 3px;
+      font-family: 'Consolas', 'Monaco', 'Courier New', monospace;
+    }
+
+    pre {
+      background-color: var(--el-fill-color) !important;
+      border-radius: 8px !important;
+      padding: 16px !important;
+      margin: 16px 0 !important;
+      overflow-x: auto !important;
+    }
+
+    pre code {
+      background-color: transparent;
+      color: var(--el-text-color-regular);
+      padding: 0;
+    }
+  }
+
+  .doc-empty {
+    display: flex;
+    flex-direction: column;
+    justify-content: center;
+    align-items: flex-start;
+    background-color: var(--el-bg-color);
+    border-radius: 8px;
+
+    .empty-content {
+      text-align: center;
+      color: var(--el-text-color-placeholder);
+
+      p {
+        margin: 0;
+        font-size: 16px;
+      }
+
+      // 添加一个简单的图标
+      &::before {
+        content: '📄';
+        font-size: 48px;
+        display: block;
+        margin-bottom: 16px;
+      }
+    }
+  }
+}

package/src/views/docs/styles/docs-header.scss

@@ -0,0 +1,20 @@
+// Docs Header Styles
+.docs-header {
+  background-color: var(--el-bg-color);
+  padding: 20px 40px;
+  box-shadow: var(--el-box-shadow-dark);
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+
+  h1 {
+    margin: 0;
+    color: var(--el-color-primary);
+    font-size: 20px;
+    font-weight: 500;
+  }
+
+  .search-box {
+    width: 400px;
+  }
+}

package/src/views/docs/styles/docs-sidebar.scss

@@ -0,0 +1,182 @@
+// Docs Sidebar Styles
+.docs-sidebar {
+  width: 300px;
+  background-color: var(--el-bg-color);
+  border-radius: 4px;
+  box-shadow: var(--el-box-shadow-dark);
+  overflow: hidden;
+
+  .sidebar-header {
+    padding: 16px;
+    border-bottom: 1px solid var(--el-border-color);
+
+    h2 {
+      font-size: 16px;
+      font-weight: 500;
+      color: var(--el-text-color-primary);
+    }
+
+    .filter-buttons {
+      display: flex;
+      gap: 8px;
+      flex-wrap: wrap;
+
+      .filter-btn {
+        padding: 4px 12px;
+        border: 1px solid var(--el-border-color);
+        border-radius: 4px;
+        background-color: var(--el-fill-color);
+        color: var(--el-text-color-secondary);
+        font-size: 12px;
+        cursor: pointer;
+        transition: all 0.3s;
+
+        &:hover {
+          border-color: var(--el-color-primary);
+          color: var(--el-color-primary);
+        }
+
+        &.primary {
+          background-color: var(--el-color-primary);
+          border-color: var(--el-color-primary);
+          color: #fff;
+
+          &:hover {
+            background-color: var(--el-color-primary-light-3);
+            border-color: var(--el-color-primary-light-3);
+          }
+        }
+
+        &.active {
+          background-color: var(--el-color-primary-light-9);
+          border-color: var(--el-color-primary);
+          color: var(--el-color-primary);
+        }
+      }
+    }
+  }
+
+  .docs-list {
+    max-height: calc(100vh - 200px);
+    overflow-y: auto;
+
+    .doc-tree {
+      list-style: none;
+      padding: 0;
+      margin: 0;
+
+      .module-item {
+        border-bottom: 1px solid var(--el-border-color);
+
+        .module-label {
+          padding: 16px 20px;
+          font-weight: 500;
+          font-size: 14px;
+          color: var(--el-text-color-primary);
+          background-color: var(--el-fill-color);
+          cursor: pointer;
+          transition: all 0.3s;
+          border-left: 3px solid transparent;
+
+          &:hover {
+            background-color: var(--el-fill-color-light);
+            border-left-color: var(--el-color-primary);
+          }
+        }
+
+        .doc-items {
+          list-style: none;
+          padding: 12px;
+          margin: 0;
+          display: flex;
+          flex-wrap: wrap;
+          gap: 12px;
+
+          .doc-item {
+            flex: 0 0 calc(50% - 6px);
+            padding: 12px;
+            font-size: 14px;
+            color: var(--el-text-color-secondary);
+            cursor: pointer;
+            transition: all 0.3s;
+            border: 1px solid var(--el-border-color);
+            background-color: var(--el-fill-color);
+            border-radius: 4px;
+            position: relative;
+            box-sizing: border-box;
+
+            &:hover {
+              background-color: var(--el-fill-color-light);
+              color: var(--el-color-primary);
+              border-color: var(--el-color-primary);
+              transform: translateY(-2px);
+              box-shadow: 0 4px 12px rgba(64, 158, 255, 0.15);
+            }
+
+            &.active {
+              background-color: var(--el-color-primary-light-9);
+              color: var(--el-color-primary);
+              border-color: var(--el-color-primary);
+              font-weight: 600;
+              box-shadow: 0 4px 12px rgba(64, 158, 255, 0.2);
+              position: relative;
+              transform: translateY(-2px);
+            }
+          }
+        }
+
+        &::-webkit-scrollbar {
+          width: 6px;
+        }
+
+        &::-webkit-scrollbar-track {
+          background: var(--el-fill-color);
+        }
+
+        &::-webkit-scrollbar-thumb {
+          background: var(--el-border-color);
+          border-radius: 3px;
+
+          &:hover {
+            background: var(--el-border-color-light);
+          }
+        }
+      }
+    }
+  }
+}
+
+.last-menu-item {
+  height: auto !important;
+  line-height: 1 !important;
+  padding-top: 12px;
+  padding-bottom: 12px;
+}
+
+.menu-item-content {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+}
+
+.menu-item-name {
+  font-size: 14px;
+  font-weight: 500;
+  color: var(--el-text-color-primary);
+}
+
+.menu-item-desc {
+  font-size: 12px;
+  color: var(--el-text-color-secondary);
+  line-height: 1.2;
+}
+
+.el-menu-item.is-active {
+  .menu-item-name {
+    color: inherit;
+  }
+
+  .menu-item-desc {
+    color: inherit;
+  }
+}

package/src/views/docs/styles/index.scss

@@ -0,0 +1,14 @@
+// 基础布局样式
+.docs-container {
+  min-height: 100vh;
+  background-color: var(--el-bg-color-page);
+  display: flex;
+  flex-direction: column;
+}
+
+.docs-content {
+  display: flex;
+  padding: 16px;
+  gap: 16px;
+  flex: 1 0 0;
+}

package/src/views/docs/type.ts

@@ -0,0 +1,101 @@
+/**
+ * 文档类型定义
+ */
+export interface DocItem {
+  /**
+   * 文档ID
+   */
+  id: string;
+  /**
+   * 文档名称
+   */
+  name: string;
+  /**
+   * 文档描述
+   */
+  description: string;
+  /**
+   * 所属模块
+   */
+  module: string;
+  /**
+   * 文档类型
+   */
+  type: 'function' | 'component' | 'hook';
+  /**
+   * 文档内容
+   */
+  content: string;
+  /**
+   * 文档路径
+   */
+  path: string;
+  /**
+   * 父级菜单ID
+   */
+  parentId?: string;
+}
+
+/**
+ * 模块子项类型
+ */
+export interface ModuleChild {
+  /**
+   * 子项ID
+   */
+  id: string;
+  /**
+   * 子项标签
+   */
+  label: string;
+  /**
+   * 子项描述
+   */
+  description: string;
+  /**
+   * 子项的子项（用于嵌套菜单）
+   */
+  children?: ModuleChild[];
+}
+
+/**
+ * 模块数据类型
+ */
+export interface ModuleData {
+  /**
+   * 模块标签
+   */
+  label: string;
+  /**
+   * 模块子项
+   */
+  children: ModuleChild[];
+}
+
+
+// 类型定义
+type DocContentMap = Record<string, string>;
+
+// 状态接口
+export interface DocsState {
+  /**
+   * 搜索查询
+   */
+  search_query: string;
+  /**
+   * 所有文档列表
+   */
+  all_docs: DocItem[];
+  /**
+   * 选中的文档
+   */
+  selected_doc: DocItem | null;
+  /**
+   * 默认展开的菜单
+   */
+  default_openeds: string[];
+  /**
+   * 文档内容映射
+   */
+  doc_content_map: DocContentMap;
+}

package/src/views/index.vue

@@ -0,0 +1,34 @@
+<script setup lang="ts">
+import { onMounted } from 'vue';
+import { useRouter } from 'vue-router';
+
+const router = useRouter();
+
+onMounted(() => {
+  // 重定向到 docs 路径
+  router.push('/docs');
+});
+</script>
+
+<template>
+    <div class="page-container">
+        <h1>正在跳转到文档页面...</h1>
+    </div>
+</template>
+
+<style lang="scss" scoped>
+.page-container {
+    height: 100vh;
+    display: flex;
+    flex: 1 0 0%;
+    flex-direction: column;
+    justify-content: center;
+    align-items: center;
+    background-color: var(--el-bg-color);
+}
+
+h1 {
+    font-size: 18px;
+    color: var(--el-text-color-secondary);
+}
+</style>

package/tsconfig.json

@@ -0,0 +1,37 @@
+{
+  "compilerOptions": {
+    "target": "esnext",
+    "useDefineForClassFields": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "strict": true,
+    "jsx": "preserve",
+    "sourceMap": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "esModuleInterop": true,
+    "lib": ["esnext", "dom"],
+    "skipLibCheck": true,
+    "baseUrl": "./",
+    "paths": {
+      "@packages/*": ["./packages/*"],
+      "@/router/*": ["./src/router/*"],
+      "@/plugins/*": ["./src/plugins/*"],
+    },
+    "declaration": true,
+    "declarationDir": "./dist/types",
+    "types": ["node", "./src/types"]
+  },
+  "include": [
+    "src/**/*",
+    "./src/**/*.ts",
+    "./src/**/*.tsx",
+    "./src/**/*.js",
+    "./src/**/*.vue",
+    "packages/**/*",
+    "packages/**/*.vue",
+    "packages/**/*.ts",
+    "packages/**/*.d.ts"
+  ],
+  "references": [{ "path": "./tsconfig.node.json" }]
+}

package/tsconfig.node.json

@@ -0,0 +1,8 @@
+{
+  "compilerOptions": {
+    "composite": true,
+    "module": "esnext",
+    "moduleResolution": "node"
+  },
+  "include": ["vite.config.ts"]
+}

package/vite.config.ts

@@ -0,0 +1,54 @@
+import { defineConfig } from "vite";
+import vue from "@vitejs/plugin-vue";
+import AutoImport from "unplugin-auto-import/vite";
+import Components from "unplugin-vue-components/vite";
+import vueJsx from "@vitejs/plugin-vue-jsx";
+import {
+  ElementPlusResolver,
+  VantResolver,
+} from "unplugin-vue-components/resolvers";
+import { resolve } from "path";
+
+export default defineConfig({
+  plugins: [
+    vue(),
+    vueJsx(),
+    AutoImport({
+      include: [/\.[tj]sx?$/, /\.vue$/],
+      imports: ["vue", "vue-router", "vue-i18n"],
+      resolvers: [ElementPlusResolver(), VantResolver()],
+      dts: "./src/types/auto-imports.d.ts",
+    }),
+    Components({
+      dirs: [],
+      dts: "./src/types/components.d.ts",
+      resolvers: [ElementPlusResolver({ importStyle: false }), VantResolver()],
+    }),
+  ],
+  resolve: {
+    alias: {
+      "@": resolve(__dirname, "src"),
+      "vue-i18n": "vue-i18n/dist/vue-i18n.cjs.js", //解决i8n警告
+    },
+  },
+  server: {
+    port: 13045,
+    proxy: {
+      // "/api/": {
+      //   target: "http://36.134.137.215:19100/",
+      //   changeOrigin: true,
+      //   rewrite: (path) => path.replace(/^\/api/, "/api"),
+      // }
+    },
+  },
+  build: {
+    rollupOptions: {
+      output: [
+        {
+          format: "es",
+          preserveModules: true,
+        },
+      ],
+    },
+  },
+});