@go-wind/admin-react 0.0.0-stage → 0.2.0

package/dist/preferences/types/app.d.ts

@@ -0,0 +1,238 @@
+import type { BuiltinThemeType, ThemeModeType } from "./theme";
+import type { AccessModeType, AuthPageLayoutType, BreadcrumbStyleType, ContentCompactType, LayoutHeaderModeType, LayoutType, LoginExpiredModeType, NavigationStyleType, PageTransitionType, PreferencesButtonPositionType, SupportedLanguagesType, TabsStyleType } from "./layout";
+/**
+ * 应用偏好设置
+ */
+export interface AppPreferences {
+    /** 权限模式 */
+    accessMode: AccessModeType;
+    /** 登录注册页面布局 */
+    authPageLayout: AuthPageLayoutType;
+    /** 检查更新轮询时间 */
+    checkUpdatesInterval: number;
+    /** 是否开启灰色模式 */
+    colorGrayMode: boolean;
+    /** 是否开启色弱模式 */
+    colorWeakMode: boolean;
+    /** 是否开启紧凑模式 */
+    compact: boolean;
+    /** 是否开启内容紧凑模式 */
+    contentCompact: ContentCompactType;
+    defaultAvatar: string;
+    dynamicTitle: boolean;
+    /** 是否开启检查更新 */
+    enableCheckUpdates: boolean;
+    /** 是否显示偏好设置 */
+    enablePreferences: boolean;
+    /**
+     * @zh_CN 是否开启refreshToken
+     */
+    enableRefreshToken: boolean;
+    /** 是否启用多租户 */
+    enableTenant: boolean;
+    /** 是否移动端 */
+    isMobile: boolean;
+    /** 布局方式 */
+    layout: LayoutType;
+    /** 支持的语言 */
+    locale: SupportedLanguagesType;
+    /** 登录过期模式 */
+    loginExpiredMode: LoginExpiredModeType;
+    /** 应用名 */
+    name: string;
+    /** 应用版本 */
+    version: string;
+    /** 偏好设置按钮位置 */
+    preferencesButtonPosition: PreferencesButtonPositionType;
+    /**
+     * @zh_CN 是否开启水印
+     */
+    watermark: boolean;
+}
+/**
+ * 面包屑偏好设置
+ */
+export interface BreadcrumbPreferences {
+    /** 面包屑是否启用 */
+    enable: boolean;
+    /** 面包屑是否只有一个时隐藏 */
+    hideOnlyOne: boolean;
+    /** 面包屑首页图标是否可见 */
+    showHome: boolean;
+    /** 面包屑图标是否可见 */
+    showIcon: boolean;
+    /** 面包屑风格 */
+    styleType: BreadcrumbStyleType;
+}
+/**
+ * 版权偏好设置
+ */
+export interface CopyrightPreferences {
+    /** 版权公司名 */
+    companyName: string;
+    /** 版权公司名链接 */
+    companySiteLink: string;
+    /** 版权日期 */
+    date: string;
+    /** 版权是否可见 */
+    enable: boolean;
+    /** 备案号 */
+    icp: string;
+    /** 备案号链接 */
+    icpLink: string;
+    /** 设置面板是否显示*/
+    settingShow?: boolean;
+}
+/**
+ * 顶栏偏好设置
+ */
+export interface HeaderPreferences {
+    /** 顶栏是否启用 */
+    enable: boolean;
+    /** 顶栏是否隐藏,css-隐藏 */
+    hidden: boolean;
+    /** header显示模式 */
+    mode: LayoutHeaderModeType;
+}
+/**
+ * 底栏偏好设置
+ */
+export interface FooterPreferences {
+    /** 底栏是否可见 */
+    enable: boolean;
+    /** 底栏是否固定 */
+    fixed: boolean;
+}
+/**
+ * logo偏好设置
+ */
+export interface LogoPreferences {
+    /** logo是否可见 */
+    enable: boolean;
+    /** logo地址 */
+    source: string;
+}
+/**
+ * 导航偏好设置
+ */
+export interface NavigationPreferences {
+    /** 导航菜单手风琴模式 */
+    accordion: boolean;
+    /** 导航菜单是否切割，只在 layout=mixed-nav 生效 */
+    split: boolean;
+    /** 导航菜单风格 */
+    styleType: NavigationStyleType;
+}
+/**
+ * 侧边栏偏好设置
+ */
+export interface SidebarPreferences {
+    /** 侧边栏是否折叠 */
+    collapsed: boolean;
+    /** 侧边栏折叠时，是否显示title */
+    collapsedShowTitle: boolean;
+    /** 侧边栏是否可见 */
+    enable: boolean;
+    /** 菜单自动展开状态 */
+    expandOnHover: boolean;
+    /** 侧边栏扩展区域是否折叠 */
+    extraCollapse: boolean;
+    /** 侧边栏是否隐藏 - css */
+    hidden: boolean;
+    /** 侧边栏宽度 */
+    width: number;
+}
+/**
+ * 快捷键偏好设置
+ */
+export interface ShortcutKeyPreferences {
+    /** 是否启用快捷键-全局 */
+    enable: boolean;
+    /** 是否启用全局锁屏快捷键 */
+    globalLockScreen: boolean;
+    /** 是否启用全局注销快捷键 */
+    globalLogout: boolean;
+    /** 是否启用全局偏好设置快捷键 */
+    globalPreferences: boolean;
+    /** 是否启用全局搜索快捷键 */
+    globalSearch: boolean;
+}
+/**
+ * 标签栏偏好设置
+ */
+export interface TabbarPreferences {
+    /** 是否开启多标签页拖拽 */
+    draggable: boolean;
+    /** 是否开启多标签页 */
+    enable: boolean;
+    /** 标签页高度 */
+    height: number;
+    /** 开启标签页缓存功能 */
+    keepAlive: boolean;
+    /** 是否持久化标签 */
+    persist: boolean;
+    /** 是否开启多标签页图标 */
+    showIcon: boolean;
+    /** 显示最大化按钮 */
+    showMaximize: boolean;
+    /** 显示更多按钮 */
+    showMore: boolean;
+    /** 标签页风格 */
+    styleType: TabsStyleType;
+}
+/**
+ * 主题偏好设置
+ */
+export interface ThemePreferences {
+    /** 内置主题名 */
+    builtinType: BuiltinThemeType;
+    /** 错误色 */
+    colorDestructive: string;
+    /** 主题色 */
+    colorPrimary: string;
+    /** 成功色 */
+    colorSuccess: string;
+    /** 警告色 */
+    colorWarning: string;
+    /** 当前主题 */
+    mode: ThemeModeType;
+    /** 圆角 */
+    radius: string;
+    /** 是否开启半深色header（只在theme='light'时生效） */
+    semiDarkHeader: boolean;
+    /** 是否开启半深色菜单（只在theme='light'时生效） */
+    semiDarkSidebar: boolean;
+}
+/**
+ * 页面切换动画偏好设置
+ */
+export interface TransitionPreferences {
+    /** 页面切换动画是否启用 */
+    enable: boolean;
+    loading: boolean;
+    /** 页面切换动画 */
+    name: PageTransitionType | string;
+    /** 是否开启页面加载进度动画 */
+    progress: boolean;
+}
+/**
+ * 小部件偏好设置
+ */
+export interface WidgetPreferences {
+    /** 是否启用全屏部件 */
+    fullscreen: boolean;
+    /** 是否启用全局搜索部件 */
+    globalSearch: boolean;
+    /** 是否启用语言切换部件 */
+    languageToggle: boolean;
+    /** 是否开启锁屏功能 */
+    lockScreen: boolean;
+    /** 是否显示通知部件 */
+    notification: boolean;
+    /** 显示刷新按钮 */
+    refresh: boolean;
+    /** 是否显示侧边栏显示/隐藏部件 */
+    sidebarToggle: boolean;
+    /** 是否显示主题切换部件 */
+    themeToggle: boolean;
+}

package/dist/preferences/types/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./app";
+export * from "./layout";
+export * from "./theme";
+export * from "./preferences-root";

package/dist/preferences/types/layout.d.ts

@@ -0,0 +1,78 @@
+/**
+ * 登录过期模式
+ * modal 弹窗模式
+ * page 页面模式
+ */
+export type LoginExpiredModeType = "modal" | "page";
+/**
+ * 权限模式
+ * backend 后端权限模式
+ * frontend 前端权限模式
+ */
+export type AccessModeType = "backend" | "frontend";
+/**
+ * 支持的语言类型
+ * 与应用使用的语言值保持一致
+ */
+export type SupportedLanguagesType = "zh-CN" | "en-US";
+/**
+ * 布局方式
+ * sidebar-nav 侧边菜单布局
+ * header-nav 顶部菜单布局
+ * mixed-nav 侧边&顶部菜单布局
+ * sidebar-mixed-nav 侧边混合菜单布局
+ * full-content 全屏内容布局
+ */
+export type LayoutType = "full-content" | "header-nav" | "mixed-nav" | "sidebar-mixed-nav" | "sidebar-nav";
+/**
+ * 偏好设置按钮位置
+ * fixed 固定在右侧
+ * header 顶栏
+ * auto 自动
+ */
+export type PreferencesButtonPositionType = "auto" | "fixed" | "header";
+/**
+ * 内容区域宽度
+ * compact 紧凑宽度
+ * wide 宽屏
+ */
+export type ContentCompactType = "compact" | "wide";
+/**
+ * 布局头部模式
+ * auto 自动隐藏
+ * auto-scroll 滚动时自动隐藏
+ * fixed 固定在顶部
+ * static 随内容滚动
+ */
+export type LayoutHeaderModeType = "auto" | "auto-scroll" | "fixed" | "static";
+/**
+ * 导航风格
+ * plain 朴素
+ * rounded 圆润
+ */
+export type NavigationStyleType = "plain" | "rounded";
+/**
+ * 标签栏风格
+ * brisk 轻快
+ * card 卡片
+ * chrome 谷歌
+ * plain 朴素
+ */
+export type TabsStyleType = "brisk" | "card" | "chrome" | "plain";
+/**
+ * 页面切换动画
+ */
+export type PageTransitionType = "fade" | "fade-down" | "fade-slide" | "fade-up";
+/**
+ * 页面切换动画
+ * panel-center 居中布局
+ * panel-left 居左布局
+ * panel-right 居右布局
+ */
+export type AuthPageLayoutType = "panel-center" | "panel-left" | "panel-right";
+/**
+ * 面包屑样式
+ * background 背景
+ * normal 默认
+ */
+export type BreadcrumbStyleType = 'background' | 'normal';

package/dist/preferences/types/preferences-root.d.ts

@@ -0,0 +1,48 @@
+import type { AppPreferences, BreadcrumbPreferences, CopyrightPreferences, FooterPreferences, HeaderPreferences, LogoPreferences, NavigationPreferences, ShortcutKeyPreferences, SidebarPreferences, TabbarPreferences, ThemePreferences, TransitionPreferences, WidgetPreferences } from "./app";
+/**
+ * 偏好设置总接口
+ */
+export interface Preferences {
+    /** 全局配置 */
+    app: AppPreferences;
+    /** 顶栏配置 */
+    breadcrumb: BreadcrumbPreferences;
+    /** 版权配置 */
+    copyright: CopyrightPreferences;
+    /** 底栏配置 */
+    footer: FooterPreferences;
+    /** 面包屑配置 */
+    header: HeaderPreferences;
+    /** logo配置 */
+    logo: LogoPreferences;
+    /** 导航配置 */
+    navigation: NavigationPreferences;
+    /** 快捷键配置 */
+    shortcutKeys: ShortcutKeyPreferences;
+    /** 侧边栏配置 */
+    sidebar: SidebarPreferences;
+    /** 标签页配置 */
+    tabbar: TabbarPreferences;
+    /** 主题配置 */
+    theme: ThemePreferences;
+    /** 动画配置 */
+    transition: TransitionPreferences;
+    /** 功能配置 */
+    widget: WidgetPreferences;
+}
+/**
+ * 偏好设置接口
+ */
+export type PreferencesKeys = keyof Preferences;
+export type DeepPartial<T> = {
+    [P in keyof T]?: T[P] extends object ? DeepPartial<T[P]> : T[P];
+};
+/**
+ * 偏好设置初始化参数
+ */
+export interface InitialOptions {
+    /** 命名空间 */
+    namespace: string;
+    /** 覆盖默认偏好设置 */
+    overrides?: DeepPartial<Preferences>;
+}

package/dist/preferences/types/theme.d.ts

@@ -0,0 +1,29 @@
+/**
+ * 主题模式
+ * auto 自动
+ * dark 暗色
+ * light 亮色
+ */
+export type ThemeModeType = "auto" | "dark" | "light";
+/**
+ * 内置主题名称
+ * custom 自定义
+ * deep-blue 深蓝
+ * deep-green 深绿
+ * default 默认
+ * gray 灰色
+ * green 绿色
+ * neutral 中性色
+ * orange 橙色
+ * pink 粉色
+ * red 红色
+ * rose 玫红色
+ * sky-blue 天蓝色
+ * slate 石板灰色
+ * stone 石灰色
+ * violet 紫罗兰色
+ * yellow 黄色
+ * zinc 锌色
+ * (Record<never, never> & string) 自定义主题
+ */
+export type BuiltinThemeType = "custom" | "deep-blue" | "deep-green" | "default" | "gray" | "green" | "neutral" | "orange" | "pink" | "red" | "rose" | "sky-blue" | "slate" | "stone" | "violet" | "yellow" | "zinc" | (Record<never, never> & string);

package/dist/preferences/utils/diff.d.ts

@@ -0,0 +1,7 @@
+import type { DeepPartial } from "../types";
+/**
+ * 深度比较 initial 与 current，产出「与出厂默认的增量」对象（只含被改过的叶子值）。
+ * 与 vben 的 diffPreference 同语义：复制偏好设置时导出的是增量 overrides，
+ * 不是全量快照（对齐 framework/effects/layouts/widgets/preferences/preferences-drawer.vue 的 handleCopy）。
+ */
+export declare function diffDeep<T extends object>(initial: T, current: DeepPartial<T>): DeepPartial<T>;

package/dist/preferences/utils/merge.d.ts

@@ -0,0 +1,9 @@
+import type { DeepPartial } from "../types";
+/**
+ * 深度合并对象
+ */
+export declare function mergeDeep<T extends object>(target: T, source: DeepPartial<T>): T;
+/**
+ * 判断是否为普通对象
+ */
+export declare function isPlainObject(value: any): value is Record<string, any>;

package/dist/query-client.d.ts

@@ -0,0 +1,9 @@
+import { QueryClient } from '@tanstack/react-query';
+export declare const queryClient: QueryClient;
+/**
+ * 宿主在 bootstrap 阶段调整 query 行为。
+ * @param options.isDev 开发环境姿态：任何查询错误重试 3 次（默认仅网络错误重试 1 次）
+ */
+export declare function configureQueryClient(options?: {
+    isDev?: boolean;
+}): void;

package/dist/rolldown-runtime-BbCBk-LD.js

@@ -0,0 +1,19 @@
+// \0rolldown/runtime.js
+var e = Object.create, t = Object.defineProperty, n = Object.getOwnPropertyDescriptor, r = Object.getOwnPropertyNames, i = Object.getPrototypeOf, a = Object.prototype.hasOwnProperty, o = (e, t) => () => (t || (e((t = { exports: {} }).exports, t, t.exports), e = null), t.exports), s = (e, n) => {
+	let r = {};
+	for (var i in e) t(r, i, {
+		get: e[i],
+		enumerable: !0
+	});
+	return n || t(r, Symbol.toStringTag, { value: "Module" }), r;
+}, c = (e, i, o, s) => {
+	if (i && typeof i == "object" || typeof i == "function") for (var c = r(i), l = 0, u = c.length, d; l < u; l++) d = c[l], !a.call(e, d) && d !== o && t(e, d, {
+		get: ((e) => i[e]).bind(null, d),
+		enumerable: !(s = n(i, d)) || s.enumerable
+	});
+	return e;
+}, l = (e, t, n) => (c(e, t, "default"), n && c(n, t, "default")), u = (n, r, o) => (o = n == null ? {} : e(i(n)), c(r || !n || !n.__esModule || !a.call(n, "default") ? t(o, "default", {
+	value: n,
+	enumerable: !0
+}) : o, n));
+export { u as i, s as n, l as r, o as t };

package/dist/router/factory.d.ts

@@ -0,0 +1,7 @@
+import { createBrowserRouter } from 'react-router-dom';
+import type { GenerateMenuAndRoutesOptions, AppRouteObject } from './types';
+import type { AccessModeType } from '../preferences';
+export declare const createAccessibleRouter: (mode: AccessModeType, options: GenerateMenuAndRoutesOptions) => Promise<{
+    router: ReturnType<typeof createBrowserRouter>;
+    routes: AppRouteObject[];
+}>;

package/dist/router/generators/generate-menus.d.ts

@@ -0,0 +1,13 @@
+import type { AppMenu, AppRouteObject } from "../../router/types";
+/**
+ * 根据路由配置生成菜单列表
+ * @param routes - 路由配置数组（AppRouteObject[]，含 meta）
+ * @param getAllRoutes - 获取完整路由树的函数（用于解析动态路径）
+ * @returns 菜单树数组（AppMenu[]），可直接传给 ProLayout
+ */
+export declare function generateMenus(routes: AppRouteObject[], getAllRoutes: () => AppRouteObject[]): Promise<AppMenu[]>;
+/**
+ * 工具：判断菜单是否应该显示（权限 + 配置）
+ * 可用于二次过滤
+ */
+export declare const shouldShowMenu: (menu: AppMenu, permissions: string[]) => boolean;

package/dist/router/generators/generate-routes-backend.d.ts

@@ -0,0 +1,12 @@
+import type { AppRouteObject, GenerateRoutesOptions } from "../../router/types";
+/**
+ * 动态生成路由 - 后端方式（React 版本）
+ * @param options - 配置选项
+ * @returns 转换后的路由树（AppRouteObject[]），可直接传入 createBrowserRouter
+ */
+export declare function generateRoutesByBackend(options: GenerateRoutesOptions): Promise<AppRouteObject[]>;
+/**
+ * 标准化视图路径（适配 React 目录结构）
+ * @param path - 后端返回的组件路径，如 "./views/system/user" 或 "/views/dashboard"
+ */
+export declare function normalizeViewPath(path: string): string;

package/dist/router/generators/generate-routes-frontend.d.ts

@@ -0,0 +1,17 @@
+import type { ReactNode } from "react";
+import type { AppRouteObject } from "../../router/types";
+/**
+ * 动态生成路由 - 前端权限过滤方式
+ * @param routes - 静态路由表（AppRouteObject[]，含 meta）
+ * @param permissions - 用户权限码列表
+ * @param forbiddenElement - 无权限时渲染的元素（<Forbidden />）
+ */
+export declare function generateRoutesByFrontend(routes: AppRouteObject[], permissions: string[], forbiddenElement?: ReactNode): Promise<AppRouteObject[]>;
+/**
+ * 判断路由是否有权限访问
+ * @param route - 路由对象
+ * @param permissions - 用户权限码列表
+ * @returns 是否允许访问
+ */
+declare function hasPermission(route: AppRouteObject, permissions: string[]): boolean;
+export { hasPermission };

package/dist/router/generators/index.d.ts

@@ -0,0 +1,3 @@
+export * from './generate-routes-backend';
+export * from './generate-routes-frontend';
+export * from './generate-menus';

package/dist/router/index.d.ts

@@ -0,0 +1,5 @@
+export * from './factory';
+export * from './generators';
+export * from './routes-context';
+export * from './types';
+export * from './utils';

package/dist/router/routes-context.d.ts

@@ -0,0 +1,8 @@
+import type { AppRouteObject } from "./types";
+/**
+ * 当前实际挂载的路由树（createAccessibleRouter 的产物）：
+ * 后端模式=后端下发路由；前端模式=权限过滤后的静态路由。
+ * 侧栏等消费方必须镜像此树保证"菜单即路由"——后端模式下若回退静态全量表，
+ * 会出现未授权菜单可见、点击 404 的越权观感。
+ */
+export declare const AccessibleRoutesContext: import("react").Context<AppRouteObject[] | null>;