@done-coding/admin-core 0.3.1-alpha.0 → 0.4.0

package/types/bridge/index.d.ts

@@ -1,11 +1,13 @@
 import { RouteRecordRaw } from 'vue-router';
+import { createUseState } from './state';
+import { createGenerateRouteMetaRawTree } from './route';
 
 /**
  * 认证桥接无状态纯工厂。
  *
  * core 模块级零状态——每次调用 `createAdminBridge({...})` 在函数作用域内新建一组
  * 闭包变量，传入 init 参数立即初始化，返回可直接使用的实例。core [MUST NOT] 持
- * 已实例化单例（避免 dist/src 双 module instance 分裂，规避机制见 design §2.3，
+ * 已实例化单例（避免 dist/src 双 module instance 分裂，规避机制见 design §2.3,
  * 结构上不持单例，[MUST NOT] 用 Symbol.for / globalThis 兜底）。
  */
 /**
@@ -24,24 +26,14 @@ export interface AdminBridgeRegisterOptions<UserInfo = unknown, LoginParams = un
     refreshToken?: () => Promise<unknown>;
     /** 刷新鉴权（重新拉取用户信息） */
     refreshAuth?: () => Promise<unknown>;
-    /** 登录 api（对应 app accountLogin），增量可选 */
-    loginApi?: (params: LoginParams) => Promise<{
-        data: UserInfo;
-    }>;
+    /** 登录 api（对应 app accountLogin；#2.7 期 axios `{data}` wrapper 业务层 wrap 剥离，core 直读 UserInfo），增量可选 */
+    loginApi?: (params: LoginParams) => Promise<Partial<UserInfo>>;
     /** 退出登录 api（对应 app accountLogout），增量可选 */
     logoutApi?: () => Promise<unknown>;
-    /** 取用户信息 api（对应 app getLoginAccountInfo，含 {user_info} wrapper 连壳，见 design D2），增量可选 */
-    getUserInfoApi?: () => Promise<{
-        data: UserInfo;
-    }>;
-    /** 刷新 token api（对应 app refreshAccountToken），增量可选 */
-    refreshTokenApi?: (headers: {
-        Authorization: string;
-    }) => Promise<{
-        data: {
-            token: string;
-        };
-    }>;
+    /** 取用户信息 api（对应 app getLoginAccountInfo；#2.7 期 axios `{data}` wrapper 业务层 wrap 剥离；{user_info} 连壳历史语义在业务层 wrap 决定是否保留 D2），增量可选 */
+    getUserInfoApi?: () => Promise<Partial<UserInfo>>;
+    /** 刷新 token api（#C 期签名最简化：core 不感知业务 shape，直传 refreshToken string；业务方 wrap 内自打包业务约定的入参 shape，如 `{Authorization: rt}`），增量可选 */
+    refreshTokenApi?: (refreshToken: string) => Promise<string>;
 }
 /**
  * pinia persist storage 适配器最小接口。
@@ -146,54 +138,144 @@ export interface AppConfig {
     };
 }
 /**
- * UserInfo 单字段取写访问器（v3 终锁 Δ0a）。
+ * 应用环境信息（#2.5 期新增，per ADR-6）。
  *
- * 两档形态（解析优先级 `typeof === "string"`）：
- * - **string 点路径串**（如 `"token"` / `"auth.t"`）：core 内经 `lodash/get` 读、
- *   `lodash/cloneDeep` then `lodash/set` 写（先 clone 产新对象再 set，不可变，
- *   1:1 镜像现行 spread 语义；见 design D2-bis）。`UserInfo` 对 core 完全不透明。
- * - **显式方法档** `{ get, set }`：app 自定取写逻辑（嵌套字段 / 自定义合并），
- *   `set` [MUST] 产新对象（app 自负不可变，core 不包装、无 lodash 介入）。
+ * 镜像 app 端 `@/config` `APP_ENV_INFO` 字面量推导结构。`mode` 取自
+ * `import.meta.env.MODE`，`isProd` / `isDev` 派生自 mode 比较；本类型对外
+ * 显式声明便于下游业务项目直接 import 使用。
+ */
+export interface AppEnvInfo {
+    /** 环境模式（如 "production" / "development"） */
+    mode: string;
+    /** 是生产环境 */
+    isProd: boolean;
+    /** 是开发环境 */
+    isDev: boolean;
+}
+/**
+ * 应用布局-面包屑配置（#2.5 期新增，per ADR-6）。
+ */
+export interface AppLayoutBreadcrumbConfig {
+    /** 面包屑高度(px) */
+    height: number;
+}
+/**
+ * 应用布局聚合配置（#2.5 期新增，per ADR-3 候选 b bridge 内部派生）。
+ *
+ * 由 `createAdminBridge` 内部从 5 子布局配置（HEADER/FOOTER/SIDEBAR/BREADCRUMB/BODY）
+ * Object.freeze 聚合派生，挂载到 `bridge.APP_LAYOUT_CONFIG` readonly 属性。
+ */
+export interface AppLayoutConfig {
+    /** header 配置 */
+    header: AppConfig["APP_LAYOUT_HEADER_CONFIG"];
+    /** footer 配置 */
+    footer: AppConfig["APP_LAYOUT_FOOTER_CONFIG"];
+    /** sidebar 配置 */
+    sidebar: AppConfig["APP_LAYOUT_SIDEBAR_CONFIG"];
+    /** 面包屑配置 */
+    breadcrumb: AppLayoutBreadcrumbConfig;
+    /** 页面主体配置 */
+    body: AppConfig["APP_LAYOUT_BODY_CONFIG"];
+}
+/**
+ * 应用路由配置（#2.5 期新增，per ADR-6）。
  *
- * permission [MUST NOT] 入本访问器——core route-permission-tree 经固定约定路径
- * `"permission"` 读（design D-a 记账，本期维持现状）。
+ * 镜像 app 端 `@/config/router.ts` `APP_ROUTER_CONFIG` 字面量结构。
  */
-export type UserInfoFieldAccess<UserInfo = unknown> = string | {
-    /** 从 userInfo 读取该字段字符串值（未命中返回 undefined） */
-    get: (info: UserInfo) => string | undefined;
-    /** 写入该字段并返回新 userInfo（[MUST] 产新对象不 mutate 入参） */
-    set: (info: UserInfo, v: string | undefined) => UserInfo;
-};
+export interface AppRouterConfig {
+    /** 是否使用 hash 路由 */
+    isHash: boolean;
+    /** 路由根路径（同一域名不同 pathname 对应不同应用） */
+    basePath: string;
+    /** 相同层级路由缓存最大数量 */
+    keepAliveMaxCount: number;
+    /** 路由 meta 默认值（复用 AppConfig 字段类型） */
+    metaDefault: AppConfig["APP_ROUTER_META_DEFAULT_CONFIG"];
+}
 /**
- * UserInfo 的 token / refreshToken 双字段访问器集（v3 终锁 Δ0a）。
+ * 应用路由路径配置——8 path 聚合（#7.3 期新增）。
  *
- * 经 `createAdminBridge({ userInfoAccess })` 注入 → createUserStore 经
- * `bridge.getUserInfoAccess()` 取，使 core 对 UserInfo token/refreshToken
- * 字段名零硬编（用户终锁 1/6）。permission **不入此集**（design D-a）。
+ * 镜像 app 端 `@/config/router.ts` `APP_ROUTER_PATHS_CONFIG` 聚合结构；供
+ * layout 族下沉 core 时通过 `appAdminBridge.APP_ROUTER_PATHS_CONFIG.homePath`
+ * 等读取路径常量，避免直 import 业务侧 `@/config` 路径符号。
+ *
+ * `loginNoCheckPath` / `authNoCheckPath` 标 `readonly string[]` 表只读语义；
+ * 业务侧 `string[]` 协变兼容 `readonly string[]`（赋值方向单向）。
  */
-export interface UserInfoAccess<UserInfo = unknown> {
-    /** token 字段访问器（string 点路径串 / 显式 `{get,set}`） */
-    token: UserInfoFieldAccess<UserInfo>;
-    /** refreshToken 字段访问器（string 点路径串 / 显式 `{get,set}`） */
-    refreshToken: UserInfoFieldAccess<UserInfo>;
+export interface AppRouterPathsConfig {
+    /** 根路径[!!!必设重定向] */
+    rootPath: string;
+    /** 首页路径 */
+    homePath: string;
+    /** 登录路径 */
+    loginPath: string;
+    /** 注册路径 */
+    registerPath: string;
+    /** 404 路径 */
+    noFoundPath: string;
+    /** 无权限路径 */
+    noPermissionPath: string;
+    /** 登录免检路径 */
+    loginNoCheckPath: readonly string[];
+    /** 权限免检路径 */
+    authNoCheckPath: readonly string[];
 }
+/** 应用基础信息 type 别名（#2.5 期 type 别名复用，per ADR-6） */
+export type AppBaseInfo = AppConfig["APP_BASE_INFO"];
+/** 应用布局-header 配置 type 别名 */
+export type AppLayoutHeaderConfig = AppConfig["APP_LAYOUT_HEADER_CONFIG"];
+/** 应用布局-footer 配置 type 别名 */
+export type AppLayoutFooterConfig = AppConfig["APP_LAYOUT_FOOTER_CONFIG"];
+/** 应用布局-sidebar 配置 type 别名 */
+export type AppLayoutSidebarConfig = AppConfig["APP_LAYOUT_SIDEBAR_CONFIG"];
+/** 应用布局-页面主体配置 type 别名 */
+export type AppLayoutBodyConfig = AppConfig["APP_LAYOUT_BODY_CONFIG"];
+/** 应用主题配置 type 别名 */
+export type AppThemeConfig = AppConfig["APP_THEME_CONFIG"];
+/** 应用路由元信息默认配置 type 别名 */
+export type AppRouterMetaDefaultConfig = AppConfig["APP_ROUTER_META_DEFAULT_CONFIG"];
+/** 应用缓存配置 type 别名 */
+export type AppCacheConfig = AppConfig["APP_CACHE_CONFIG"];
 /**
- * `createAdminBridge` 入参类型，全入参均必传。
+ * `createAdminBridge` 入参类型（#2.5 期 schema 扩张到 14 顶层字段，per ADR-3 / ADR-6）。
+ *
+ * #2.5 期完全显式入参化：原 `appConfig: AppConfig` 嵌套字段拆解为 11 个顶层字段平铺
+ * + 新增 `APP_ENV_INFO` / `APP_LAYOUT_BREADCRUMB_CONFIG` / `APP_ROUTER_CONFIG` 3 字段
+ * + 注：`APP_LAYOUT_CONFIG` 由 bridge 内部从 5 子布局配置聚合派生（候选 b，不在 initOptions 中）。
  *
- * `appConfig` 与 `storage` 均为 env-driven、不依赖 core、app pre-Vue 即可备好；
  * `routes`（#4e additive）为 app 嵌套路由树（带 children），createUserStore 经此算权限树；
- * `userInfoAccess` / `getUserInfoInitFn`（v3 终锁 Δ0b）为 createUserStore token/refreshToken
- * 取写 + 用户信息空保底注入面（core 对 UserInfo 不透明，业务 shape 不下沉，规则 8）。
+ * `getUserInfoInitFn` 为 createUserStore 用户信息空保底注入面（core 对 UserInfo 不透明，
+ * 业务 shape 不下沉，规则 8）。#C 期：删 `userInfoAccess` access pattern——token/refreshToken
+ * 与 permission 对称为固定字面字段名（`"token"` / `"refresh_token"` / `"permission"`），
+ * 嵌套场景由业务方 wrap getUserInfoApi 时摊平（wrap 是业务方天然控制点）。
  */
 export interface AdminBridgeInitOptions<UserInfo = unknown> {
-    /** store/app + createUserStore 消费的 app config 子集（必传） */
-    appConfig: AppConfig;
-    /** pinia persist storage 适配器（必传） */
-    storage: StorageLike;
+    /** 应用基础信息（store/app 仅取 name） */
+    APP_BASE_INFO: AppBaseInfo;
+    /** 应用环境信息（mode / isProd / isDev，env 派生） */
+    APP_ENV_INFO: AppEnvInfo;
+    /** 应用缓存配置（bridge 内部 storage / useState 派生 namespace） */
+    APP_CACHE_CONFIG: AppCacheConfig;
+    /** 应用布局-header 配置 */
+    APP_LAYOUT_HEADER_CONFIG: AppLayoutHeaderConfig;
+    /** 应用布局-footer 配置 */
+    APP_LAYOUT_FOOTER_CONFIG: AppLayoutFooterConfig;
+    /** 应用布局-sidebar 配置 */
+    APP_LAYOUT_SIDEBAR_CONFIG: AppLayoutSidebarConfig;
+    /** 应用布局-面包屑配置（#2.5 期新增字段） */
+    APP_LAYOUT_BREADCRUMB_CONFIG: AppLayoutBreadcrumbConfig;
+    /** 应用布局-页面主体配置 */
+    APP_LAYOUT_BODY_CONFIG: AppLayoutBodyConfig;
+    /** 应用路由元信息默认配置（bridge 内部 generateRouteMetaRawTree 派生） */
+    APP_ROUTER_META_DEFAULT_CONFIG: AppRouterMetaDefaultConfig;
+    /** 应用路由配置（#2.5 期新增字段） */
+    APP_ROUTER_CONFIG: AppRouterConfig;
+    /** 应用路由路径配置（#7.3 期新增字段；8 path 聚合供 layout 族通过 bridge 取业务路径） */
+    APP_ROUTER_PATHS_CONFIG: AppRouterPathsConfig;
+    /** 应用主题配置（light / dark 双主题） */
+    APP_THEME_CONFIG: AppThemeConfig;
     /** app 嵌套路由树（必传，#4e additive；createUserStore 权限树依赖 children 嵌套，[MUST NOT] 传扁平化数据） */
     routes: RouteRecordRaw[];
-    /** UserInfo token/refreshToken 取写访问器（v3 终锁 Δ0b；createUserStore 经此取写，core 不透明 UserInfo，permission 不入） */
-    userInfoAccess: UserInfoAccess<UserInfo>;
     /** 用户信息空保底工厂（v3 终锁 Δ0b；恒返非空业务字段默认值对象，createUserStore useState 经此取初值，core 不锁业务 shape） */
     getUserInfoInitFn: () => UserInfo;
 }
@@ -215,34 +297,55 @@ export interface AdminBridge<UserInfo = unknown, LoginParams = unknown> {
     refreshToken: () => Promise<void>;
     /** 刷新鉴权 */
     refreshAuth: () => Promise<void>;
-    /** 返回 `init` 注册的 appConfig 引用 */
-    getAppConfig: () => AppConfig;
-    /** 返回 `init` 注册的 storage 引用 */
+    /**
+     * @deprecated 改用 `appAdminBridge.APP_XXX` 直接属性读（per #2.5 期 ADR-4；下个 MAJOR 删除）。
+     * 返回 8 字段聚合对象（每次调用产新对象，多次调用 !== 引用不等）。
+     */
+    getAppConfig: () => Readonly<AppConfig>;
+    /** 返回 bridge 内部派生的 storage 实例（per REQ-1 入参内化；保持 StorageLike 可变方法可调用） */
     getStorage: () => StorageLike;
-    /** 返回 `init` 注册的 routes 引用 */
+    /** 返回 `init` 注册的 routes 引用（routes 例外保持可变，破循环依赖时序，per REQ-4 + audit §3.4） */
     getRoutes: () => RouteRecordRaw[];
-    /** 返回 `init` 注册的 userInfoAccess 引用（v3 终锁 Δ0d，镜像 getRoutes 范式） */
-    getUserInfoAccess: () => UserInfoAccess<UserInfo>;
     /** 返回 `init` 注册的 getUserInfoInitFn 引用（v3 终锁 Δ0d，镜像 getRoutes 范式） */
     getUserInfoInitFn: () => () => UserInfo;
-    /** 登录 api（createUserStore login 内调；未注册被调同步 throw 原生 Error 前 reject——异步对 reject 原生 Error） */
-    loginApi: (params: LoginParams) => Promise<{
-        data: UserInfo;
-    }>;
+    /** bridge 内部派生 useState 实例方法（per REQ-2；ns 已绑定，调用方零 ns 参；cacheKey 形如 `${ns}/useState/${moduleKey}`） */
+    useState: ReturnType<typeof createUseState>;
+    /** bridge 内部派生 generateRouteMetaRawTree 实例方法（per REQ-3；metaDefault 已绑定 APP_ROUTER_META_DEFAULT_CONFIG，调用方零 metaDefault 参） */
+    generateRouteMetaRawTree: ReturnType<typeof createGenerateRouteMetaRawTree>;
+    /** 登录 api（createUserStore login 内调；#2.7 期 axios `{data}` wrapper 业务层 wrap 剥离；未注册被调 reject 原生 Error） */
+    loginApi: (params: LoginParams) => Promise<Partial<UserInfo>>;
     /** 退出登录 api（createUserStore logout 内调；未注册被调 reject 原生 Error） */
     logoutApi: () => Promise<unknown>;
-    /** 取用户信息 api（createUserStore getInfo 内调；连壳 {user_info} 见 design D2；未注册被调 reject 原生 Error） */
-    getUserInfoApi: () => Promise<{
-        data: UserInfo;
-    }>;
-    /** 刷新 token api（createUserStore refreshTokenFn 内调；未注册被调 reject 原生 Error） */
-    refreshTokenApi: (headers: {
-        Authorization: string;
-    }) => Promise<{
-        data: {
-            token: string;
-        };
-    }>;
+    /** 取用户信息 api（createUserStore getInfo 内调；#2.7 期 axios `{data}` wrapper 业务层 wrap 剥离；连壳 {user_info} 见 design D2 由业务层决定；未注册被调 reject 原生 Error） */
+    getUserInfoApi: () => Promise<Partial<UserInfo>>;
+    /** 刷新 token api（createUserStore refreshTokenFn 内调；#C 期签名最简化：core 直传 refreshToken string，业务 wrap 内自打包业务 shape；未注册被调 reject 原生 Error） */
+    refreshTokenApi: (refreshToken: string) => Promise<string>;
+    /** 应用基础信息（per #2.5 期 REQ-1 直接挂载形态） */
+    readonly APP_BASE_INFO: AppBaseInfo;
+    /** 应用环境信息（per #2.5 期 REQ-1） */
+    readonly APP_ENV_INFO: AppEnvInfo;
+    /** 应用缓存配置（per #2.5 期 REQ-1） */
+    readonly APP_CACHE_CONFIG: AppCacheConfig;
+    /** 应用布局-header 配置（per #2.5 期 REQ-1） */
+    readonly APP_LAYOUT_HEADER_CONFIG: AppLayoutHeaderConfig;
+    /** 应用布局-footer 配置（per #2.5 期 REQ-1） */
+    readonly APP_LAYOUT_FOOTER_CONFIG: AppLayoutFooterConfig;
+    /** 应用布局-sidebar 配置（per #2.5 期 REQ-1） */
+    readonly APP_LAYOUT_SIDEBAR_CONFIG: AppLayoutSidebarConfig;
+    /** 应用布局-面包屑配置（per #2.5 期 REQ-1） */
+    readonly APP_LAYOUT_BREADCRUMB_CONFIG: AppLayoutBreadcrumbConfig;
+    /** 应用布局-页面主体配置（per #2.5 期 REQ-1） */
+    readonly APP_LAYOUT_BODY_CONFIG: AppLayoutBodyConfig;
+    /** 应用布局聚合配置（per #2.5 期 ADR-3 bridge 内部聚合派生） */
+    readonly APP_LAYOUT_CONFIG: AppLayoutConfig;
+    /** 应用路由元信息默认配置（per #2.5 期 REQ-1） */
+    readonly APP_ROUTER_META_DEFAULT_CONFIG: AppRouterMetaDefaultConfig;
+    /** 应用路由配置（per #2.5 期 REQ-1） */
+    readonly APP_ROUTER_CONFIG: AppRouterConfig;
+    /** 应用路由路径配置（per #7.3 期；8 path 聚合 readonly 挂载） */
+    readonly APP_ROUTER_PATHS_CONFIG: AppRouterPathsConfig;
+    /** 应用主题配置（per #2.5 期 REQ-1） */
+    readonly APP_THEME_CONFIG: AppThemeConfig;
 }
 /**
  * 认证桥接无状态纯工厂：接收 init 参数，内部立即初始化，返回可直接使用的
@@ -251,10 +354,11 @@ export interface AdminBridge<UserInfo = unknown, LoginParams = unknown> {
  *
  * @example
  *   const appAdminBridge = createAdminBridge<LoginAccountInfo, AccountLoginParams>({
- *     appConfig: { ... },
- *     storage: localStorageWithNamespace,
+ *     APP_BASE_INFO, APP_ENV_INFO, APP_CACHE_CONFIG,
+ *     APP_LAYOUT_HEADER_CONFIG, APP_LAYOUT_FOOTER_CONFIG, APP_LAYOUT_SIDEBAR_CONFIG,
+ *     APP_LAYOUT_BREADCRUMB_CONFIG, APP_LAYOUT_BODY_CONFIG,
+ *     APP_ROUTER_META_DEFAULT_CONFIG, APP_ROUTER_CONFIG, APP_THEME_CONFIG,
  *     routes,
- *     userInfoAccess: { token: "token", refreshToken: "refresh_token" },
  *     getUserInfoInitFn: getUserInfoInit,
  *   });
  */

package/types/components/app-layout/AppBody.vue.d.ts

@@ -0,0 +1,45 @@
+import { RouteMetaResolveRaw } from '../../types';
+
+declare function __VLS_template(): {
+    footer?(_: {}): any;
+};
+declare const __VLS_component: import('vue').DefineComponent<globalThis.ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<{
+    menus: RouteMetaResolveRaw[];
+    menuFlatList: RouteMetaResolveRaw[];
+}>, {
+    menus: () => never[];
+    menuFlatList: () => never[];
+}>>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<globalThis.ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<{
+    menus: RouteMetaResolveRaw[];
+    menuFlatList: RouteMetaResolveRaw[];
+}>, {
+    menus: () => never[];
+    menuFlatList: () => never[];
+}>>> & Readonly<{}>, {
+    menus: RouteMetaResolveRaw[];
+    menuFlatList: RouteMetaResolveRaw[];
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, ReturnType<typeof __VLS_template>>;
+export default _default;
+type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
+type __VLS_TypePropsToRuntimeProps<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: import('vue').PropType<__VLS_NonUndefinedable<T[K]>>;
+    } : {
+        type: import('vue').PropType<T[K]>;
+        required: true;
+    };
+};
+type __VLS_WithDefaults<P, D> = {
+    [K in keyof Pick<P, keyof P>]: K extends keyof D ? __VLS_Prettify<P[K] & {
+        default: D[K];
+    }> : P[K];
+};
+type __VLS_Prettify<T> = {
+    [K in keyof T]: T[K];
+} & {};
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/types/components/app-layout/AppBreadcrumb.vue.d.ts

@@ -0,0 +1,25 @@
+import { RouteMetaResolveRaw } from '../../types';
+
+declare const _default: import('vue').DefineComponent<globalThis.ExtractPropTypes<__VLS_TypePropsToRuntimeProps<{
+    menus: RouteMetaResolveRaw[];
+    height: number;
+    menuFlatList: RouteMetaResolveRaw[];
+}>>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    show: (status: boolean) => void;
+}, string, import('vue').PublicProps, Readonly<globalThis.ExtractPropTypes<__VLS_TypePropsToRuntimeProps<{
+    menus: RouteMetaResolveRaw[];
+    height: number;
+    menuFlatList: RouteMetaResolveRaw[];
+}>>> & Readonly<{
+    onShow?: ((status: boolean) => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+export default _default;
+type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
+type __VLS_TypePropsToRuntimeProps<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: import('vue').PropType<__VLS_NonUndefinedable<T[K]>>;
+    } : {
+        type: import('vue').PropType<T[K]>;
+        required: true;
+    };
+};

package/types/components/app-layout/AppFooter.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, {}, any>;
+export default _default;

package/types/components/app-layout/AppHeader.vue.d.ts

@@ -0,0 +1,55 @@
+import { RouteMetaResolveRaw } from '../../types';
+
+declare function __VLS_template(): {
+    left?(_: {}): any;
+    right?(_: {}): any;
+};
+declare const __VLS_component: import('vue').DefineComponent<globalThis.ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<{
+    /** 整体不用管 AppLayout控制 用在定位出去的子元素的显隐 */
+    show: boolean;
+    menus: RouteMetaResolveRaw[];
+    /** 聚焦的路由菜单 */
+    activeMenu?: RouteMetaResolveRaw;
+    /** 聚焦的模块菜单 */
+    activeModuleMenu?: RouteMetaResolveRaw;
+    menuFlatList: RouteMetaResolveRaw[];
+}>, {
+    menus: () => never[];
+}>>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<globalThis.ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<{
+    /** 整体不用管 AppLayout控制 用在定位出去的子元素的显隐 */
+    show: boolean;
+    menus: RouteMetaResolveRaw[];
+    /** 聚焦的路由菜单 */
+    activeMenu?: RouteMetaResolveRaw;
+    /** 聚焦的模块菜单 */
+    activeModuleMenu?: RouteMetaResolveRaw;
+    menuFlatList: RouteMetaResolveRaw[];
+}>, {
+    menus: () => never[];
+}>>> & Readonly<{}>, {
+    menus: RouteMetaResolveRaw[];
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, ReturnType<typeof __VLS_template>>;
+export default _default;
+type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
+type __VLS_TypePropsToRuntimeProps<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: import('vue').PropType<__VLS_NonUndefinedable<T[K]>>;
+    } : {
+        type: import('vue').PropType<T[K]>;
+        required: true;
+    };
+};
+type __VLS_WithDefaults<P, D> = {
+    [K in keyof Pick<P, keyof P>]: K extends keyof D ? __VLS_Prettify<P[K] & {
+        default: D[K];
+    }> : P[K];
+};
+type __VLS_Prettify<T> = {
+    [K in keyof T]: T[K];
+} & {};
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/types/components/app-layout/AppLayout.vue.d.ts

@@ -0,0 +1,76 @@
+import { AppLayoutAppStoreSlice, AppLayoutUserStoreSlice, AppLayoutBridgeSlice } from './types';
+import { WatermarkProps } from 'element-plus';
+
+declare function __VLS_template(): {
+    "sidebar-top"?(_: {}): any;
+    "sidebar-bottom"?(_: {}): any;
+    "header-left"?(_: {}): any;
+    "header-right"?(_: {}): any;
+};
+declare const __VLS_component: import('vue').DefineComponent<globalThis.ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<{
+    /**
+     * admin bridge 实例（#7.6 期新增必填）。
+     * AppLayout 经 `props.adminBridge` 注入后 provide 给子 layout 组件
+     * （AppBody / AppSidebar 自取 12 readonly 配置 + getRoutes / generateRouteMetaRawTree）。
+     * 业务侧 App.vue 模板：`<AppLayout :admin-bridge="appAdminBridge" ...>`。
+     */
+    adminBridge: AppLayoutBridgeSlice;
+    appStore: AppLayoutAppStoreSlice;
+    userStore: AppLayoutUserStoreSlice;
+    /** 水印内容（空数组/空串/undefined 不展示）；layout 不耦合 UserInfo shape，由业务侧派生 */
+    watermarkContent?: WatermarkProps["content"];
+    /**
+     * sidebar 层级是否高于 header（#7.5 期新增，默认 false）。
+     * true 时 AppSidebar z-index 调高于 AppHeader——适合 sidebar 顶部悬挂内容
+     * 需要覆盖 header 区域的场景（如悬浮 logo/搜索框）。
+     */
+    sidebarAboveHeader?: boolean;
+}>, {
+    sidebarAboveHeader: boolean;
+}>>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<globalThis.ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<{
+    /**
+     * admin bridge 实例（#7.6 期新增必填）。
+     * AppLayout 经 `props.adminBridge` 注入后 provide 给子 layout 组件
+     * （AppBody / AppSidebar 自取 12 readonly 配置 + getRoutes / generateRouteMetaRawTree）。
+     * 业务侧 App.vue 模板：`<AppLayout :admin-bridge="appAdminBridge" ...>`。
+     */
+    adminBridge: AppLayoutBridgeSlice;
+    appStore: AppLayoutAppStoreSlice;
+    userStore: AppLayoutUserStoreSlice;
+    /** 水印内容（空数组/空串/undefined 不展示）；layout 不耦合 UserInfo shape，由业务侧派生 */
+    watermarkContent?: WatermarkProps["content"];
+    /**
+     * sidebar 层级是否高于 header（#7.5 期新增，默认 false）。
+     * true 时 AppSidebar z-index 调高于 AppHeader——适合 sidebar 顶部悬挂内容
+     * 需要覆盖 header 区域的场景（如悬浮 logo/搜索框）。
+     */
+    sidebarAboveHeader?: boolean;
+}>, {
+    sidebarAboveHeader: boolean;
+}>>> & Readonly<{}>, {
+    sidebarAboveHeader: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, ReturnType<typeof __VLS_template>>;
+export default _default;
+type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
+type __VLS_TypePropsToRuntimeProps<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: import('vue').PropType<__VLS_NonUndefinedable<T[K]>>;
+    } : {
+        type: import('vue').PropType<T[K]>;
+        required: true;
+    };
+};
+type __VLS_WithDefaults<P, D> = {
+    [K in keyof Pick<P, keyof P>]: K extends keyof D ? __VLS_Prettify<P[K] & {
+        default: D[K];
+    }> : P[K];
+};
+type __VLS_Prettify<T> = {
+    [K in keyof T]: T[K];
+} & {};
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/types/components/app-layout/AppPage.vue.d.ts

@@ -0,0 +1,54 @@
+declare function __VLS_template(): {
+    default?(_: {}): any;
+};
+declare const __VLS_component: import('vue').DefineComponent<globalThis.ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<{
+    /** 充满视口 */
+    fullViewport?: boolean;
+    fullMode?: "min-height" | "height";
+    /** 下个viewport高度 */
+    nextViewportMaxHeight?: string;
+    background?: string;
+}>, {
+    fullViewport: boolean;
+    fullMode: string;
+    nextViewportMaxHeight: string;
+}>>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<globalThis.ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<{
+    /** 充满视口 */
+    fullViewport?: boolean;
+    fullMode?: "min-height" | "height";
+    /** 下个viewport高度 */
+    nextViewportMaxHeight?: string;
+    background?: string;
+}>, {
+    fullViewport: boolean;
+    fullMode: string;
+    nextViewportMaxHeight: string;
+}>>> & Readonly<{}>, {
+    fullViewport: boolean;
+    fullMode: "min-height" | "height";
+    nextViewportMaxHeight: string;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, ReturnType<typeof __VLS_template>>;
+export default _default;
+type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
+type __VLS_TypePropsToRuntimeProps<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: import('vue').PropType<__VLS_NonUndefinedable<T[K]>>;
+    } : {
+        type: import('vue').PropType<T[K]>;
+        required: true;
+    };
+};
+type __VLS_WithDefaults<P, D> = {
+    [K in keyof Pick<P, keyof P>]: K extends keyof D ? __VLS_Prettify<P[K] & {
+        default: D[K];
+    }> : P[K];
+};
+type __VLS_Prettify<T> = {
+    [K in keyof T]: T[K];
+} & {};
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/types/components/app-layout/AppSidebar.vue.d.ts

@@ -0,0 +1,51 @@
+import { RouteMetaResolveRaw } from '../../types';
+
+declare function __VLS_template(): {
+    top?(_: {}): any;
+    bottom?(_: {}): any;
+};
+declare const __VLS_component: import('vue').DefineComponent<globalThis.ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<{
+    /** 整体不用管 AppLayout 控制 用在定位出去的子元素的显隐 */
+    show: boolean;
+    /** 层级是否高于 header（#7.5 期；true 时 z-index 提升盖住 header） */
+    aboveHeader?: boolean;
+    menus: RouteMetaResolveRaw[];
+    menuFlatList: RouteMetaResolveRaw[];
+}>, {
+    aboveHeader: boolean;
+}>>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<globalThis.ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<{
+    /** 整体不用管 AppLayout 控制 用在定位出去的子元素的显隐 */
+    show: boolean;
+    /** 层级是否高于 header（#7.5 期；true 时 z-index 提升盖住 header） */
+    aboveHeader?: boolean;
+    menus: RouteMetaResolveRaw[];
+    menuFlatList: RouteMetaResolveRaw[];
+}>, {
+    aboveHeader: boolean;
+}>>> & Readonly<{}>, {
+    aboveHeader: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, ReturnType<typeof __VLS_template>>;
+export default _default;
+type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
+type __VLS_TypePropsToRuntimeProps<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: import('vue').PropType<__VLS_NonUndefinedable<T[K]>>;
+    } : {
+        type: import('vue').PropType<T[K]>;
+        required: true;
+    };
+};
+type __VLS_WithDefaults<P, D> = {
+    [K in keyof Pick<P, keyof P>]: K extends keyof D ? __VLS_Prettify<P[K] & {
+        default: D[K];
+    }> : P[K];
+};
+type __VLS_Prettify<T> = {
+    [K in keyof T]: T[K];
+} & {};
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};