@done-coding/admin-core 0.8.2 → 0.9.0

package/types/inject/key.d.ts

@@ -1,4 +1,5 @@
 import { InjectionKey } from 'vue';
+import { AdminBridge } from '../bridge';
 import { ModalLevel, ShelfController } from '../components/modal';
 import { AppLayoutAppStoreSlice, AppLayoutUserStoreSlice, AppLayoutBridgeSlice } from '../components/app-layout';
 /**
@@ -52,3 +53,20 @@ export declare const APP_LAYOUT_USER_STORE_KEY: InjectionKey<AppLayoutUserStoreS
  * Symbol.for 保证跨包同一性（同 APP_LAYOUT_APP_STORE_KEY / APP_LAYOUT_USER_STORE_KEY）。
  */
 export declare const APP_LAYOUT_BRIDGE_KEY: InjectionKey<AppLayoutBridgeSlice>;
+/**
+ * 整 admin bridge app 级注入 key（#插件系统一期挂载）。
+ * ---
+ * `bridge.install(app)`（即 `app.use(bridge)`）经 `app.provide(ADMIN_BRIDGE_KEY, bridge)`
+ * 把**整个 bridge 实例**注入应用级 provide 链；任意后代组件经 `inject(ADMIN_BRIDGE_KEY)`
+ * 取整 bridge（含 7 响应式只读配置视图 + `update` + 全部 auth/api/派生方法）。
+ * ---
+ * **opt-in**：仅当 app 显式 `app.use(bridge)` 时注入；未 use 则 `inject(ADMIN_BRIDGE_KEY)`
+ * 返回 `undefined`（不报错）。
+ * ---
+ * **区别于 `APP_LAYOUT_BRIDGE_KEY`**：后者是 AppLayout 族**组件级**窄切片（`AppLayoutBridgeSlice`
+ * Pick 子集，由 AppLayout 从 `props.adminBridge` 接收后 provide，供 layout 子组件 inject），
+ * 两 KEY 各管各、并存——本 KEY 注入的是 app 级**整 bridge**，非 layout 窄切片。
+ * ---
+ * Symbol.for 保证跨包/跨 chunk/跨 ESM 实例唯一（同 APP_LAYOUT_BRIDGE_KEY，规则 8）。
+ */
+export declare const ADMIN_BRIDGE_KEY: InjectionKey<AdminBridge>;

package/types/store/app.d.ts

@@ -9,139 +9,218 @@ import { AdminBridge } from '../bridge';
  * #C 期：删第 3 泛型 RefreshTokenParams 透传（bridge 签名已删第 3 泛型）。
  */
 export interface CreateAppStoreDeps<UserInfo = unknown, LoginParams = unknown> {
-    /** app 侧 admin bridge 单例（注入而非 core 持单例，守规则 8；layout/theme/persist storage 全经此读） */
+    /** app 侧 admin bridge 单例（注入而非 core 持单例，守规则 8；layout/theme 配置全经此读） */
     bridge: AdminBridge<UserInfo, LoginParams>;
 }
 /**
  * app store 工厂下沉 core。
  *
- * 返回 `defineStore("APP", setup, { persist })` 结果（store id 保持 `"APP"`；
- * core 工厂无状态，store 实例由 app 侧 pinia 管理，规则 8）。setup 内 1:1 镜像
- * 原 `packages/app/src/store/app.ts` 全部运行时行为（layout/theme/persist/
- * watch isDarkTheme DOM class 切换），[MUST NOT] 重构 / 精简 / 调整顺序。
+ * 返回 `defineStore("APP", setup)` 结果（store id 保持 `"APP"`；core 工厂无状态，
+ * store 实例由 app 侧 pinia 管理，规则 8）。
  *
- * persist storage 走 `bridge.getStorage()` 惰性代理（沿用 app 端 appPersistStorage
- * 范式）——defineStore 第三参在模块求值时执行，此时尚 pre-init，直接
- * `bridge.getStorage()` 会同步 throw；包惰性代理使 bridge 解析推迟到每次 persist
- * 读写时（届时已 post-init），行为字节等价。
+ * 主题架构反转（不再 1:1 镜像原 app store dark 状态机）：dark/风格切换真相全移交
+ * bridge（`bridge.themeIsDark` / `bridge.theme.setStyle/setDark`）——
+ * - `isDarkTheme` 改读 `bridge.themeIsDark`（store 不再持 ref 真相）；
+ * - `changeIsDarkTheme` 转发 `bridge.theme.setDark`（旧消费方兼容兜底）；
+ * - 退役 store `watch isDarkTheme → className`（由挂值 composable toggle `.dark`）；
+ * - 退役 store dark 持久化（`pick:["isDarkTheme"]`）——bridge 持久化 `{themeStyle,themeIsDark}`。
+ * layout/route/sidebar 等非主题运行时行为保持不变。
  *
  * @example
  *   export const useAppStore = createAppStore({ bridge: appAdminBridge });
  */
 export declare function createAppStore<UserInfo = unknown, LoginParams = unknown>(deps: CreateAppStoreDeps<UserInfo, LoginParams>): import('pinia').StoreDefinition<"APP", Pick<{
-    name: globalThis.Ref<string, string>;
-    isDarkTheme: globalThis.ComputedRef<boolean>;
-    theme: globalThis.ComputedRef<import('../bridge').AppThemeColor>;
-    extractLevel1ToHeader: globalThis.Ref<boolean, boolean>;
-    showHeader: globalThis.ComputedRef<boolean>;
-    showFooter: globalThis.ComputedRef<boolean>;
-    showSidebar: globalThis.ComputedRef<boolean>;
-    showBreadcrumb: globalThis.ComputedRef<boolean>;
-    keepAlive: globalThis.ComputedRef<boolean | undefined>;
-    headerStyle: globalThis.ComputedRef<{
+    name: import('vue').ComputedRef<string>;
+    isDarkTheme: import('vue').ComputedRef<boolean>;
+    theme: import('vue').ComputedRef<{
+        readonly bodyColor: string;
+        readonly baseColor: string;
+        readonly primaryColor: string;
+        readonly successColor: string;
+        readonly warningColor: string;
+        readonly dangerColor: string;
+        readonly errorColor: string;
+        readonly infoColor: string;
+        readonly radius?: string | undefined;
+        readonly borderColor?: string | undefined;
+        readonly shadow?: string | undefined;
+        readonly borderWidth?: string | undefined;
+        readonly accent?: string | undefined;
+        readonly glow?: string | undefined;
+        readonly blur?: string | undefined;
+        readonly focusRing?: string | undefined;
+        readonly surface?: string | undefined;
+    }>;
+    extractLevel1ToHeader: import('vue').Ref<boolean, boolean>;
+    showHeader: import('vue').ComputedRef<boolean>;
+    showFooter: import('vue').ComputedRef<boolean>;
+    showSidebar: import('vue').ComputedRef<boolean>;
+    showBreadcrumb: import('vue').ComputedRef<boolean>;
+    keepAlive: import('vue').ComputedRef<boolean | undefined>;
+    headerStyle: import('vue').ComputedRef<{
         height: string;
         backgroundColor: string;
         color: string;
     }>;
-    footerStyle: globalThis.ComputedRef<{
+    footerStyle: import('vue').ComputedRef<{
         height: string;
         backgroundColor: string;
     }>;
-    sidebarStyle: globalThis.ComputedRef<{
+    sidebarStyle: import('vue').ComputedRef<{
         width: string;
         paddingTop: string;
         backgroundColor: string;
         color: string;
     }>;
-    bodyStyle: globalThis.ComputedRef<{
+    bodyStyle: import('vue').ComputedRef<{
         paddingLeft: string;
         paddingTop: string;
+        paddingRight: string;
+        paddingBottom: string;
         backgroundColor: string;
     }>;
-    bodyShimPadding: globalThis.ComputedRef<number>;
-    bodyShimStyle: globalThis.ComputedRef<{
+    bodyShimPadding: import('vue').ComputedRef<number>;
+    bodyShimStyle: import('vue').ComputedRef<{
         minHeight: string;
         padding: string;
     }>;
-    sidebarIsCollapse: globalThis.ComputedRef<boolean>;
+    viewportPadding: import('vue').ComputedRef<{
+        top: string;
+        right: string;
+        bottom: string;
+        left: string;
+    }>;
+    sidebarIsCollapse: import('vue').ComputedRef<boolean>;
     changeSidebarCollapseStatus: (status: boolean) => void;
     changeSidebarHasMenusStatus: (status: boolean) => void;
     changeIsDarkTheme: (status: boolean) => void;
-}, "name" | "extractLevel1ToHeader">, Pick<{
-    name: globalThis.Ref<string, string>;
-    isDarkTheme: globalThis.ComputedRef<boolean>;
-    theme: globalThis.ComputedRef<import('../bridge').AppThemeColor>;
-    extractLevel1ToHeader: globalThis.Ref<boolean, boolean>;
-    showHeader: globalThis.ComputedRef<boolean>;
-    showFooter: globalThis.ComputedRef<boolean>;
-    showSidebar: globalThis.ComputedRef<boolean>;
-    showBreadcrumb: globalThis.ComputedRef<boolean>;
-    keepAlive: globalThis.ComputedRef<boolean | undefined>;
-    headerStyle: globalThis.ComputedRef<{
+}, "extractLevel1ToHeader">, Pick<{
+    name: import('vue').ComputedRef<string>;
+    isDarkTheme: import('vue').ComputedRef<boolean>;
+    theme: import('vue').ComputedRef<{
+        readonly bodyColor: string;
+        readonly baseColor: string;
+        readonly primaryColor: string;
+        readonly successColor: string;
+        readonly warningColor: string;
+        readonly dangerColor: string;
+        readonly errorColor: string;
+        readonly infoColor: string;
+        readonly radius?: string | undefined;
+        readonly borderColor?: string | undefined;
+        readonly shadow?: string | undefined;
+        readonly borderWidth?: string | undefined;
+        readonly accent?: string | undefined;
+        readonly glow?: string | undefined;
+        readonly blur?: string | undefined;
+        readonly focusRing?: string | undefined;
+        readonly surface?: string | undefined;
+    }>;
+    extractLevel1ToHeader: import('vue').Ref<boolean, boolean>;
+    showHeader: import('vue').ComputedRef<boolean>;
+    showFooter: import('vue').ComputedRef<boolean>;
+    showSidebar: import('vue').ComputedRef<boolean>;
+    showBreadcrumb: import('vue').ComputedRef<boolean>;
+    keepAlive: import('vue').ComputedRef<boolean | undefined>;
+    headerStyle: import('vue').ComputedRef<{
         height: string;
         backgroundColor: string;
         color: string;
     }>;
-    footerStyle: globalThis.ComputedRef<{
+    footerStyle: import('vue').ComputedRef<{
         height: string;
         backgroundColor: string;
     }>;
-    sidebarStyle: globalThis.ComputedRef<{
+    sidebarStyle: import('vue').ComputedRef<{
         width: string;
         paddingTop: string;
         backgroundColor: string;
         color: string;
     }>;
-    bodyStyle: globalThis.ComputedRef<{
+    bodyStyle: import('vue').ComputedRef<{
         paddingLeft: string;
         paddingTop: string;
+        paddingRight: string;
+        paddingBottom: string;
         backgroundColor: string;
     }>;
-    bodyShimPadding: globalThis.ComputedRef<number>;
-    bodyShimStyle: globalThis.ComputedRef<{
+    bodyShimPadding: import('vue').ComputedRef<number>;
+    bodyShimStyle: import('vue').ComputedRef<{
         minHeight: string;
         padding: string;
     }>;
-    sidebarIsCollapse: globalThis.ComputedRef<boolean>;
+    viewportPadding: import('vue').ComputedRef<{
+        top: string;
+        right: string;
+        bottom: string;
+        left: string;
+    }>;
+    sidebarIsCollapse: import('vue').ComputedRef<boolean>;
     changeSidebarCollapseStatus: (status: boolean) => void;
     changeSidebarHasMenusStatus: (status: boolean) => void;
     changeIsDarkTheme: (status: boolean) => void;
-}, "keepAlive" | "bodyShimPadding" | "isDarkTheme" | "theme" | "showHeader" | "showFooter" | "showSidebar" | "showBreadcrumb" | "headerStyle" | "footerStyle" | "sidebarStyle" | "bodyStyle" | "bodyShimStyle" | "sidebarIsCollapse">, Pick<{
-    name: globalThis.Ref<string, string>;
-    isDarkTheme: globalThis.ComputedRef<boolean>;
-    theme: globalThis.ComputedRef<import('../bridge').AppThemeColor>;
-    extractLevel1ToHeader: globalThis.Ref<boolean, boolean>;
-    showHeader: globalThis.ComputedRef<boolean>;
-    showFooter: globalThis.ComputedRef<boolean>;
-    showSidebar: globalThis.ComputedRef<boolean>;
-    showBreadcrumb: globalThis.ComputedRef<boolean>;
-    keepAlive: globalThis.ComputedRef<boolean | undefined>;
-    headerStyle: globalThis.ComputedRef<{
+}, "name" | "theme" | "showHeader" | "keepAlive" | "bodyShimPadding" | "isDarkTheme" | "showFooter" | "showSidebar" | "showBreadcrumb" | "headerStyle" | "footerStyle" | "sidebarStyle" | "bodyStyle" | "bodyShimStyle" | "viewportPadding" | "sidebarIsCollapse">, Pick<{
+    name: import('vue').ComputedRef<string>;
+    isDarkTheme: import('vue').ComputedRef<boolean>;
+    theme: import('vue').ComputedRef<{
+        readonly bodyColor: string;
+        readonly baseColor: string;
+        readonly primaryColor: string;
+        readonly successColor: string;
+        readonly warningColor: string;
+        readonly dangerColor: string;
+        readonly errorColor: string;
+        readonly infoColor: string;
+        readonly radius?: string | undefined;
+        readonly borderColor?: string | undefined;
+        readonly shadow?: string | undefined;
+        readonly borderWidth?: string | undefined;
+        readonly accent?: string | undefined;
+        readonly glow?: string | undefined;
+        readonly blur?: string | undefined;
+        readonly focusRing?: string | undefined;
+        readonly surface?: string | undefined;
+    }>;
+    extractLevel1ToHeader: import('vue').Ref<boolean, boolean>;
+    showHeader: import('vue').ComputedRef<boolean>;
+    showFooter: import('vue').ComputedRef<boolean>;
+    showSidebar: import('vue').ComputedRef<boolean>;
+    showBreadcrumb: import('vue').ComputedRef<boolean>;
+    keepAlive: import('vue').ComputedRef<boolean | undefined>;
+    headerStyle: import('vue').ComputedRef<{
         height: string;
         backgroundColor: string;
         color: string;
     }>;
-    footerStyle: globalThis.ComputedRef<{
+    footerStyle: import('vue').ComputedRef<{
         height: string;
         backgroundColor: string;
     }>;
-    sidebarStyle: globalThis.ComputedRef<{
+    sidebarStyle: import('vue').ComputedRef<{
         width: string;
         paddingTop: string;
         backgroundColor: string;
         color: string;
     }>;
-    bodyStyle: globalThis.ComputedRef<{
+    bodyStyle: import('vue').ComputedRef<{
         paddingLeft: string;
         paddingTop: string;
+        paddingRight: string;
+        paddingBottom: string;
         backgroundColor: string;
     }>;
-    bodyShimPadding: globalThis.ComputedRef<number>;
-    bodyShimStyle: globalThis.ComputedRef<{
+    bodyShimPadding: import('vue').ComputedRef<number>;
+    bodyShimStyle: import('vue').ComputedRef<{
         minHeight: string;
         padding: string;
     }>;
-    sidebarIsCollapse: globalThis.ComputedRef<boolean>;
+    viewportPadding: import('vue').ComputedRef<{
+        top: string;
+        right: string;
+        bottom: string;
+        left: string;
+    }>;
+    sidebarIsCollapse: import('vue').ComputedRef<boolean>;
     changeSidebarCollapseStatus: (status: boolean) => void;
     changeSidebarHasMenusStatus: (status: boolean) => void;
     changeIsDarkTheme: (status: boolean) => void;

package/types/store/user.d.ts

@@ -30,7 +30,7 @@ export interface CreateUserStoreDeps<UserInfo, LoginParams = unknown> {
  */
 export declare function createUserStore<UserInfo, LoginParams = unknown>(deps: CreateUserStoreDeps<UserInfo, LoginParams>): import('pinia').StoreDefinition<"USER", Pick<{
     userInfo: ComputedRef<UserInfo>;
-    token: ComputedRef<string | undefined>;
+    token: ComputedRef<string>;
     isLogin: ComputedRef<boolean>;
     login: (params: LoginParams) => Promise<void>;
     logout: () => Promise<void>;
@@ -40,7 +40,7 @@ export declare function createUserStore<UserInfo, LoginParams = unknown>(deps: C
     havePermissionByKey: (key?: RoutePermission["key"]) => boolean;
 }, never>, Pick<{
     userInfo: ComputedRef<UserInfo>;
-    token: ComputedRef<string | undefined>;
+    token: ComputedRef<string>;
     isLogin: ComputedRef<boolean>;
     login: (params: LoginParams) => Promise<void>;
     logout: () => Promise<void>;
@@ -50,7 +50,7 @@ export declare function createUserStore<UserInfo, LoginParams = unknown>(deps: C
     havePermissionByKey: (key?: RoutePermission["key"]) => boolean;
 }, "userInfo" | "token" | "isLogin">, Pick<{
     userInfo: ComputedRef<UserInfo>;
-    token: ComputedRef<string | undefined>;
+    token: ComputedRef<string>;
     isLogin: ComputedRef<boolean>;
     login: (params: LoginParams) => Promise<void>;
     logout: () => Promise<void>;

package/types/utils/index.d.ts

@@ -2,3 +2,4 @@ export * from './time';
 export * from './id';
 export * from './router';
 export * from './export';
+export * from './theme-scale';

package/types/utils/theme-scale.d.ts

@@ -0,0 +1,35 @@
+/**
+ * 主题色阶派生（模式感知，复刻 Element Plus 的 SCSS `mix` 算法）。
+ *
+ * core 挂值时对 6 个语义色（primary/success/warning/danger/info + error）
+ * 由基色派生 EP 7 档（base 自身 + light-3/5/7/8/9 + dark-2），亮/暗模式各用
+ * 不同的混入色，使派生结果与 EP 原生色阶一致。
+ */
+/** 主题明暗模式（决定色阶向哪一端混合） */
+export type ThemeScaleMode = "light" | "dark";
+/** 一个语义色的 EP 7 档色阶（key 与 `--el-color-*-light-#` / `-dark-2` 对齐） */
+export interface ThemeColorScale {
+    /** 基色自身 */
+    base: string;
+    "light-3": string;
+    "light-5": string;
+    "light-7": string;
+    "light-8": string;
+    "light-9": string;
+    "dark-2": string;
+}
+/**
+ * 混色：`c1` 占 `w1`、`c2` 占 `1-w1`，各通道线性混合后四舍五入
+ * （复刻 EP/SCSS `mix(c1, c2, w1)` 语义，w1 为 c1 的权重 [0,1]）。
+ * 任一入参非 hex（如 `var(...)` / `rgba(...)`）→ 返回 `c2` 兜底，不崩。
+ */
+export declare const themeScaleMix: (c1: string, c2: string, w1: number) => string;
+/**
+ * 按 EP 算法 + 模式感知派生一个语义色的 7 档色阶。
+ *
+ * - light：`light-i = mix(#fff, base, i*10%)`，`dark-2 = mix(#000, base, 20%)`
+ * - dark： `light-i = mix(#141414, base, i*10%)`，`dark-2 = mix(#fff, base, 20%)`
+ *
+ * `base` 非 hex 时各档兜底返回 `base` 原值（保持可挂载、不崩）。
+ */
+export declare const themeScaleDerive: (base: string, mode: ThemeScaleMode) => ThemeColorScale;