xto-fronted 0.1.0

package/README.md

@@ -0,0 +1,95 @@
+# Xto Demo
+
+基于 xto 组件库的后台管理系统脚手架。
+
+## 特性
+
+- 🚀 Vue 3 + TypeScript + Vite 5
+- 📦 Pinia 状态管理
+- 🛣️ Vue Router 4 动态路由
+- 🎨 xto 组件库
+- 🔐 权限管理（角色、按钮级别）
+- 🌓 亮色/暗色主题切换
+- 📱 响应式布局
+
+## 项目结构
+
+```
+src/
+├── api/                # API 接口
+├── assets/             # 静态资源
+│   └── styles/         # 全局样式
+├── components/         # 全局组件
+│   └── Layout/         # 布局组件
+├── composables/        # 组合式函数
+├── directives/         # 自定义指令
+├── enums/              # 枚举常量
+├── router/             # 路由配置
+├── stores/             # Pinia 状态
+├── types/              # 类型定义
+├── utils/              # 工具函数
+└── views/              # 页面视图
+```
+
+## 开发
+
+```bash
+# 安装依赖
+pnpm install
+
+# 启动开发服务器
+pnpm dev
+
+# 构建
+pnpm build
+```
+
+## 推送仓库
+```bash
+pnpm install
+
+# 1. 构建（库模式）
+pnpm run build:lib
+
+# 2. 登录 npm（首次需要）
+npm login
+
+# 3. 发布
+npm publish
+```
+## 功能模块
+
+- [x] 登录/登出
+- [x] 动态路由
+- [x] 侧边栏菜单
+- [x] 顶部导航/面包屑
+- [x] 标签页缓存
+- [x] 仪表盘
+- [x] 用户管理 CRUD
+- [x] 角色管理
+- [x] 菜单管理
+- [x] 主题切换
+- [x] 权限控制
+
+## Mock 数据
+
+项目使用本地 Mock 数据，可直接登录测试：
+
+- 用户名：任意
+- 密码：任意
+
+## 技术栈
+
+| 技术 | 版本 |
+|------|------|
+| Vue | 3.4+ |
+| TypeScript | 5.4+ |
+| Vite | 5.x |
+| Vue Router | 4.x |
+| Pinia | 2.x |
+| Axios | 1.x |
+| xto | npm |
+
+## License
+
+MIT

package/dist/403-MQkNUulz.js

@@ -0,0 +1,31 @@
+import { defineComponent as s, openBlock as n, createElementBlock as p, createElementVNode as o, createVNode as d, unref as _, withCtx as a, createTextVNode as i } from "vue";
+import { useRouter as m } from "vue-router";
+import { Button as c } from "@xto/base";
+import { c as l } from "./index-vVfjShJR.js";
+const f = { class: "error-page" }, u = { class: "error-page__content" }, g = /* @__PURE__ */ s({
+  __name: "403",
+  setup(v) {
+    const r = m(), t = () => {
+      r.push("/");
+    };
+    return (x, e) => (n(), p("div", f, [
+      o("div", u, [
+        e[1] || (e[1] = o("div", { class: "error-page__code" }, "403", -1)),
+        e[2] || (e[2] = o("div", { class: "error-page__title" }, "无访问权限", -1)),
+        e[3] || (e[3] = o("div", { class: "error-page__desc" }, "抱歉，您没有权限访问此页面", -1)),
+        d(_(c), {
+          type: "primary",
+          onClick: t
+        }, {
+          default: a(() => [...e[0] || (e[0] = [
+            i("返回首页", -1)
+          ])]),
+          _: 1
+        })
+      ])
+    ]));
+  }
+}), V = /* @__PURE__ */ l(g, [["__scopeId", "data-v-f6105e3d"]]);
+export {
+  V as default
+};

package/dist/404-BOFYLq4X.js

@@ -0,0 +1,31 @@
+import { defineComponent as s, openBlock as n, createElementBlock as p, createElementVNode as o, createVNode as a, unref as _, withCtx as d, createTextVNode as i } from "vue";
+import { useRouter as c } from "vue-router";
+import { Button as m } from "@xto/base";
+import { c as l } from "./index-vVfjShJR.js";
+const f = { class: "error-page" }, u = { class: "error-page__content" }, g = /* @__PURE__ */ s({
+  __name: "404",
+  setup(v) {
+    const r = c(), t = () => {
+      r.push("/");
+    };
+    return (x, e) => (n(), p("div", f, [
+      o("div", u, [
+        e[1] || (e[1] = o("div", { class: "error-page__code" }, "404", -1)),
+        e[2] || (e[2] = o("div", { class: "error-page__title" }, "页面不存在", -1)),
+        e[3] || (e[3] = o("div", { class: "error-page__desc" }, "抱歉，您访问的页面不存在或已被删除", -1)),
+        a(_(m), {
+          type: "primary",
+          onClick: t
+        }, {
+          default: d(() => [...e[0] || (e[0] = [
+            i("返回首页", -1)
+          ])]),
+          _: 1
+        })
+      ])
+    ]));
+  }
+}), V = /* @__PURE__ */ l(g, [["__scopeId", "data-v-f1a1acb0"]]);
+export {
+  V as default
+};

package/dist/App.vue.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import('vue').DefineComponent<{}, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, HTMLDivElement>;
+export default _default;

package/dist/api/auth.d.ts

@@ -0,0 +1,8 @@
+import { LoginParams, LoginResult, UserInfo } from '../types/api';
+export declare function login(data: LoginParams): Promise<import('../utils/request').ApiResponse<LoginResult>>;
+export declare function logout(): Promise<import('../utils/request').ApiResponse<unknown>>;
+export declare function getUserInfo(): Promise<import('../utils/request').ApiResponse<UserInfo>>;
+export declare function refreshToken(refreshToken: string): Promise<import('../utils/request').ApiResponse<{
+    token: string;
+    expireTime: number;
+}>>;

package/dist/api/system.d.ts

@@ -0,0 +1,16 @@
+import { PageParams, PageResponse } from '../utils/request';
+import { RoleInfo, MenuItem } from '../types/api';
+export declare function getRoleList(params: PageParams & {
+    status?: number;
+    keyword?: string;
+}): Promise<import('../utils/request').ApiResponse<PageResponse<RoleInfo>>>;
+export declare function getRoleDetail(id: string | number): Promise<import('../utils/request').ApiResponse<RoleInfo>>;
+export declare function createRole(data: Partial<RoleInfo>): Promise<import('../utils/request').ApiResponse<RoleInfo>>;
+export declare function updateRole(id: string | number, data: Partial<RoleInfo>): Promise<import('../utils/request').ApiResponse<RoleInfo>>;
+export declare function deleteRole(id: string | number): Promise<import('../utils/request').ApiResponse<unknown>>;
+export declare function updateRoleStatus(id: string | number, status: number): Promise<import('../utils/request').ApiResponse<unknown>>;
+export declare function getMenuList(): Promise<import('../utils/request').ApiResponse<MenuItem[]>>;
+export declare function getMenuTree(): Promise<import('../utils/request').ApiResponse<MenuItem[]>>;
+export declare function createMenu(data: Partial<MenuItem>): Promise<import('../utils/request').ApiResponse<MenuItem>>;
+export declare function updateMenu(id: string | number, data: Partial<MenuItem>): Promise<import('../utils/request').ApiResponse<MenuItem>>;
+export declare function deleteMenu(id: string | number): Promise<import('../utils/request').ApiResponse<unknown>>;

package/dist/api/user.d.ts

@@ -0,0 +1,13 @@
+import { PageParams, PageResponse } from '../utils/request';
+import { UserInfo } from '../types/api';
+export declare function getUserList(params: PageParams & {
+    status?: number;
+    keyword?: string;
+}): Promise<import('../utils/request').ApiResponse<PageResponse<UserInfo>>>;
+export declare function getUserDetail(id: string | number): Promise<import('../utils/request').ApiResponse<UserInfo>>;
+export declare function createUser(data: Partial<UserInfo>): Promise<import('../utils/request').ApiResponse<UserInfo>>;
+export declare function updateUser(id: string | number, data: Partial<UserInfo>): Promise<import('../utils/request').ApiResponse<UserInfo>>;
+export declare function deleteUser(id: string | number): Promise<import('../utils/request').ApiResponse<unknown>>;
+export declare function batchDeleteUsers(ids: (string | number)[]): Promise<import('../utils/request').ApiResponse<unknown>>;
+export declare function updateUserStatus(id: string | number, status: number): Promise<import('../utils/request').ApiResponse<unknown>>;
+export declare function resetPassword(id: string | number): Promise<import('../utils/request').ApiResponse<unknown>>;

package/dist/components/Layout/Footer.vue.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import('vue').DefineComponent<{}, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, HTMLDivElement>;
+export default _default;

package/dist/components/Layout/Header.vue.d.ts

@@ -0,0 +1,4 @@
+declare const _default: import('vue').DefineComponent<{}, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {
+    dropdownRef: HTMLDivElement;
+}, HTMLDivElement>;
+export default _default;

package/dist/components/Layout/Sidebar.vue.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import('vue').DefineComponent<{}, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, HTMLDivElement>;
+export default _default;

package/dist/components/Layout/Tabs.vue.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import('vue').DefineComponent<{}, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, HTMLDivElement>;
+export default _default;

package/dist/components/Layout/index.vue.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import('vue').DefineComponent<{}, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, HTMLDivElement>;
+export default _default;

package/dist/composables/useAuth.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 权限组合函数
+ */
+export declare function useAuth(): {
+    hasPermission: (permission: string | string[]) => boolean;
+    hasRole: (role: string | string[]) => boolean;
+    isAdmin: import('vue').ComputedRef<boolean>;
+    isLoggedIn: import('vue').ComputedRef<boolean>;
+};

package/dist/composables/useForm.d.ts

@@ -0,0 +1,20 @@
+/**
+ * 表单组合函数
+ */
+export interface FormOptions<T = any> {
+    rules?: Record<string, any[]>;
+    onSubmit?: (data: T) => Promise<void> | void;
+}
+export declare function useForm<T extends Record<string, any> = Record<string, any>>(initialValues: T, options?: FormOptions<T>): {
+    formRef: import('vue').Ref<any, any>;
+    formData: import('vue').Reactive<T>;
+    rules: Record<string, any[]> | undefined;
+    loading: import('vue').Ref<boolean, boolean>;
+    visible: import('vue').Ref<boolean, boolean>;
+    isEdit: import('vue').Ref<boolean, boolean>;
+    openAdd: () => void;
+    openEdit: (data: Partial<T>) => void;
+    close: () => void;
+    resetForm: () => void;
+    handleSubmit: () => Promise<void>;
+};

package/dist/composables/useTable.d.ts

@@ -0,0 +1,29 @@
+/**
+ * 表格组合函数
+ */
+export interface TableOptions<T = any> {
+    fetchData: (params: any) => Promise<{
+        list: T[];
+        total: number;
+    }>;
+    defaultPageSize?: number;
+}
+export declare function useTable<T = any>(options: TableOptions<T>): {
+    loading: import('vue').Ref<boolean, boolean>;
+    data: any;
+    total: import('vue').Ref<number, number>;
+    currentPage: import('vue').Ref<number, number>;
+    pageSize: import('vue').Ref<number, number>;
+    searchParams: Record<string, any>;
+    pagination: import('vue').ComputedRef<{
+        current: number;
+        pageSize: number;
+        total: number;
+    }>;
+    getData: () => Promise<void>;
+    handleSearch: () => void;
+    handleReset: () => void;
+    handlePageChange: (page: number) => void;
+    handleSizeChange: (size: number) => void;
+    refresh: () => void;
+};

package/dist/directives/permission.d.ts

@@ -0,0 +1,4 @@
+import { Directive } from 'vue';
+declare const permission: Directive;
+export default permission;
+export declare function setupPermissionDirective(app: any): void;

package/dist/enums/index.d.ts

@@ -0,0 +1,32 @@
+/**
+ * 枚举常量
+ */
+export declare enum Status {
+    ENABLED = 1,
+    DISABLED = 0
+}
+export declare enum Gender {
+    UNKNOWN = 0,
+    MALE = 1,
+    FEMALE = 2
+}
+export declare enum MenuType {
+    DIRECTORY = 0,
+    MENU = 1,
+    BUTTON = 2
+}
+export declare const StatusText: Record<Status, string>;
+export declare const GenderText: Record<Gender, string>;
+export declare const MenuTypeText: Record<MenuType, string>;
+export declare const StatusOptions: {
+    label: string;
+    value: Status;
+}[];
+export declare const GenderOptions: {
+    label: string;
+    value: Gender;
+}[];
+export declare const MenuTypeOptions: {
+    label: string;
+    value: MenuType;
+}[];