@react-antd-module/runtime 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 CondorHero
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,119 @@
+# @react-antd-module/runtime
+
+框架运行时。模块工程**唯一**应该 import 的框架入口。
+
+## 定位
+
+| | |
+|---|---|
+| 消费者 | 模块工程（`entry.ts` 与页面代码）、预构建宿主 `@react-antd-module/shell` |
+| 产物 | `dist/runtime.js`（单文件 ESM）。`dist/runtime.d.ts` 尚未产出，类型出口在 P3 随出口冻结一起收敛 |
+| 加载方式 | 由宿主 importmap 映射为 `/assets/runtime.js`，全站唯一实例（单例，见设计文档 D5） |
+
+产物只保留**相对路径**代码；所有裸说明符（`react` / `antd` / `react-router` …）都被 external，交给宿主 importmap 解析。这是单例的实现前提——模块与宿主 import 到的是同一个 URL，因而是同一份实例。
+
+## 安装
+
+模块工程把它放在 `devDependencies`（仅用于类型检查与 IDE 跳转），运行期由宿主提供：
+
+```jsonc
+{
+  "devDependencies": {
+    "@react-antd-module/runtime": "^x.y.z"
+  }
+}
+```
+
+## 对外出口
+
+出口在 `src/index.ts` 收敛，当前为最小集合（P3 阶段依据实际用量冻结）：
+
+```ts
+// 模块契约
+import type {
+  AppRouteRecordRaw,
+  ModuleDefinition,
+  RouteMeta,
+} from "@react-antd-module/runtime";
+import {
+  BasicContent,
+  defineModule,
+} from "@react-antd-module/runtime";
+
+// 宿主侧模块加载（模块工程一般不需要）
+import {
+  getModule,
+  getModules,
+  getRegisteredApiPrefix,
+  getRegisteredStore,
+  getRoutes,
+  loadAll,
+} from "@react-antd-module/runtime";
+```
+
+> `antd`、`react`、`react-router`、`@tanstack/react-query` 等共享依赖**不从 runtime 转出**。模块请直接 import 这些包，由 importmap 命中宿主提供的同一份实例。
+
+## 模块定义示例
+
+```ts
+import type { AppRouteRecordRaw, ModuleDefinition } from "@react-antd-module/runtime";
+import { defineModule } from "@react-antd-module/runtime";
+import { lazy } from "react";
+
+const routes: AppRouteRecordRaw[] = [
+  {
+    path: "/demo",
+    Component: lazy(() => import("./pages/demo")),
+    handle: {
+      title: "demo:menu.demo",
+      // 布局语义：container（默认）| parent | none
+      layout: "container",
+    },
+  },
+];
+
+export default defineModule({
+  name: "demo",
+  description: "示例模块",
+  version: "1.0.0",
+  routes,
+  i18n: {
+    "zh-CN": () => import("./locales/zh-CN.json"),
+    "en-US": () => import("./locales/en-US.json"),
+  },
+} satisfies ModuleDefinition);
+```
+
+## 内置能力（非出口，但影响模块行为）
+
+- **路由级缓存**：KeepAlive 位于宿主固定层，缓存开关由各模块路由的 `handle.keepAlive` 汇总得出，不依赖任何具体布局组件是否存在。
+- **布局语义**：`handle.layout` 决定该路由用哪层布局包裹（`container` / `parent` / `none`）。迁移期未声明时按 `container` 处理，保持既有行为。
+- **兜底页**：`NotFound`（404）与 `UnknownComponent`（后端下发路由找不到前端组件）由框架内置，模块无需提供；需要自定义时用自己的路由覆盖。
+
+## 构建
+
+```bash
+# 只出 JS（shell 构建链路走这条，当前唯一可用的构建）
+pnpm --filter @react-antd-module/runtime exec vite build
+
+# vite build + tsc 出 d.ts + 重写 d.ts 里的 #src/* 说明符
+# ⚠️ 目前 tsc 声明阶段仍有 3 处 declaration-emit 报错，属 P3 待办
+pnpm --filter @react-antd-module/runtime build
+```
+
+`dist/` 是**随仓库分发的预置产物**（`.gitignore` 中已显式放行），改动 runtime 源码后需要重新构建并提交。
+
+## 目录约定
+
+```
+packages/runtime/src/
+├── index.ts          # 唯一对外出口
+├── components/       # 框架组件（含 not-found / unknown-component 兜底页）
+├── layout/           # 布局与 keep-alive-layer（宿主固定层）
+├── module-loader/    # 模块加载、拓扑排序、生命周期、i18n 合并
+├── router/           # 路由类型、工具、核心路由表
+├── locales/          # 框架文案（模块文案由模块自带）
+└── store/            # 框架状态
+```
+
+内部引用统一走 `#src/*` 子路径 imports；**禁止**出现 `#modules/*`（框架不得反向依赖业务模块，CI 有卡口）。

package/dist/api/home.d.ts

@@ -0,0 +1,10 @@
+export interface PieDataType {
+    value: number;
+    code: string;
+}
+export declare function fetchPie(data: {
+    by: string | number;
+}): Promise<ApiResponse<PieDataType[]>>;
+export declare function fetchLine(data: {
+    range: string;
+}): Promise<ApiResponse<string[]>>;

package/dist/api/notifications/index.d.ts

@@ -0,0 +1,2 @@
+import type { NotificationItem } from "../../layout/widgets/notification/types";
+export declare function fetchNotifications(): Promise<ApiResponse<NotificationItem[]>>;

package/dist/api/system/menu/index.d.ts

@@ -0,0 +1,6 @@
+import type { MenuItemType } from "./types";
+export * from "./types";
+export declare function fetchMenuList(data: any): Promise<ApiListResponse<MenuItemType>>;
+export declare function fetchAddMenuItem(data: MenuItemType): Promise<ApiResponse<string>>;
+export declare function fetchUpdateMenuItem(data: MenuItemType): Promise<ApiResponse<string>>;
+export declare function fetchDeleteMenuItem(id: number): Promise<ApiResponse<string>>;

package/dist/api/system/menu/types.d.ts

@@ -0,0 +1,19 @@
+export interface MenuItemType {
+    parentId: string;
+    id: number;
+    menuType: 0 | 1 | 2 | 3;
+    name: string;
+    path: string;
+    component: string;
+    order: number;
+    icon: string;
+    currentActiveMenu: string;
+    iframeLink: string;
+    keepAlive: number;
+    externalLink: string;
+    hideInMenu: number;
+    ignoreAccess: number;
+    status: 1;
+    createTime: number;
+    updateTime: number;
+}

package/dist/api/system/role/index.d.ts

@@ -0,0 +1,10 @@
+import type { RoleItemType } from "./types";
+export * from "./types";
+export declare function fetchRoleList(data: any): Promise<ApiListResponse<RoleItemType>>;
+export declare function fetchAddRoleItem(data: RoleItemType): Promise<ApiResponse<string>>;
+export declare function fetchUpdateRoleItem(data: RoleItemType): Promise<ApiResponse<string>>;
+export declare function fetchDeleteRoleItem(id: number): Promise<ApiResponse<string>>;
+export declare function fetchRoleMenu(): Promise<ApiResponse<RoleItemType[]>>;
+export declare function fetchMenuByRoleId(data: {
+    id: number;
+}): Promise<ApiResponse<string[]>>;

package/dist/api/system/role/types.d.ts

@@ -0,0 +1,9 @@
+export interface RoleItemType {
+    id: number;
+    createTime: number;
+    updateTime: number;
+    name: string;
+    code: string;
+    status: 1 | 0;
+    remark: string;
+}

package/dist/api/user/index.d.ts

@@ -0,0 +1,16 @@
+import type { AppRouteRecordRaw } from "../../router/types";
+import type { AuthType, LoginInfo, UserInfoType } from "./types";
+export * from "./types";
+export declare function fetchLogin(data: LoginInfo): Promise<ApiResponse<AuthType>>;
+export declare function fetchLogout(data?: {
+    readonly refreshToken?: string;
+}): Promise<unknown>;
+export declare function fetchAsyncRoutes(): Promise<ApiResponse<AppRouteRecordRaw[]>>;
+export declare function fetchUserInfo(): Promise<ApiResponse<UserInfoType>>;
+export interface RefreshTokenResult {
+    token: string;
+    refreshToken: string;
+}
+export declare function fetchRefreshToken(data: {
+    readonly refreshToken: string;
+}): Promise<ApiResponse<AuthType>>;

package/dist/api/user/types.d.ts

@@ -0,0 +1,26 @@
+import type { AppRouteRecordRaw } from "../../router/types";
+export interface AuthType {
+    token: string;
+    refreshToken: string;
+}
+export interface LoginInfo {
+    username: string;
+    password: string;
+}
+export interface UserInfoType {
+    id: string;
+    avatar: string;
+    username: string;
+    email: string;
+    phoneNumber: string;
+    description: string;
+    roles: Array<string>;
+    /** 权限码列表（后端下发；模块级 requiredPermissions 门禁消费，P7.12） */
+    permissions?: Array<string>;
+    menus?: AppRouteRecordRaw[];
+}
+export interface AuthListProps {
+    label: string;
+    name: string;
+    auth: string[];
+}

package/dist/components/access-control/index.d.ts

@@ -0,0 +1,15 @@
+import type { ReactNode } from "react";
+interface AccessControlProps {
+    type?: "code" | "role";
+    codes?: string | string[];
+    children?: ReactNode;
+    fallback?: ReactNode;
+}
+/**
+ * 权限验证组件
+ *
+ * @param AccessControlProps 权限验证组件的属性
+ * @returns 若子组件存在，并且传入的权限值有效，则返回子组件；否则返回 null
+ */
+export declare function AccessControl({ type, codes, children, fallback }: AccessControlProps): ReactNode;
+export {};

package/dist/components/basic-button/index.d.ts

@@ -0,0 +1,7 @@
+import type { ButtonProps } from "antd";
+import type { ReactNode } from "react";
+interface BasicButtonProps extends ButtonProps {
+    children?: ReactNode;
+}
+export declare function BasicButton(props: BasicButtonProps): import("#node_modules/@types/react").JSX.Element;
+export {};

package/dist/components/basic-content/index.d.ts

@@ -0,0 +1,7 @@
+interface Props {
+    style?: React.CSSProperties;
+    className?: string;
+    children: React.ReactNode;
+}
+export declare function BasicContent(props: Props): import("#node_modules/@types/react").JSX.Element;
+export {};

package/dist/components/basic-form/form-items/form-avatar-item.d.ts

@@ -0,0 +1,6 @@
+interface FormAvatarItemProps {
+    value?: string;
+    onChange?: (value: any) => void;
+}
+export declare function FormAvatarItem({ value, onChange }: FormAvatarItemProps): import("#node_modules/@types/react").JSX.Element;
+export {};

package/dist/components/basic-form/form-items/form-tree-item.d.ts

@@ -0,0 +1,13 @@
+import type { BasicDataNode } from "antd/lib/tree";
+export interface TreeDataNodeWithId extends BasicDataNode {
+    id: string;
+    title: string;
+    children: TreeDataNodeWithId[];
+}
+interface FormTreeItemProps {
+    treeData: TreeDataNodeWithId[];
+    value?: React.Key[];
+    onChange?: (value: React.Key[]) => void;
+}
+export declare function FormTreeItem({ treeData, value, onChange }: FormTreeItemProps): import("#node_modules/@types/react").JSX.Element;
+export {};

package/dist/components/basic-form/form-items/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./form-avatar-item";
+export * from "./form-tree-item";

package/dist/components/basic-form/index.d.ts

@@ -0,0 +1 @@
+export * from "./form-items";

package/dist/components/basic-table/constants.d.ts

@@ -0,0 +1 @@
+export declare const BASIC_TABLE_ROOT_CLASS_NAME = "basic-table";

package/dist/components/basic-table/index.d.ts

@@ -0,0 +1,12 @@
+import type { ParamsType, ProTableProps } from "@ant-design/pro-components";
+export interface BasicTableProps<D, U, V> extends ProTableProps<D, U, V> {
+    /**
+     * @description 自适应内容区高度，如果设置了 scroll.y，则不进行自适应
+     * @default false
+     */
+    adaptive?: boolean | {
+        /** 表格距离页面底部的偏移量，默认值为 `16` */
+        offsetBottom?: number;
+    };
+}
+export declare function BasicTable<DataType extends Record<string, any>, Params extends ParamsType = ParamsType, ValueType = "text">(props: BasicTableProps<DataType, Params, ValueType>): import("#node_modules/@types/react").JSX.Element;

package/dist/components/basic-table/styles.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 显式标注返回的 classes 形状（P3.1 / TS2883，同 P3.5 的 layout-menu、
+ * layout-tabbar 修法）：推断类型会引用 jss 的 Classes（非直接依赖，
+ * 声明不可移植），这里用结构化等价类型 Record<C, string> 替代。
+ */
+export declare const useStyles: (data?: any) => Record<"basicTable", string>;

package/dist/components/exception-page/index.d.ts

@@ -0,0 +1,3 @@
+export default function ExceptionPage({ status }: {
+    status: "403" | "404" | "500";
+}): import("#node_modules/@types/react").JSX.Element;

package/dist/components/fullscreen-button/index.d.ts

@@ -0,0 +1,17 @@
+import type { ButtonProps } from "antd";
+import type { RefObject } from "react";
+export interface FullscreenButtonProps extends Omit<ButtonProps, "target"> {
+    target: HTMLElement | (() => Element) | RefObject<Element>;
+    fullscreenIcon?: React.ReactNode;
+    fullscreenExitIcon?: React.ReactNode;
+}
+/**
+ * 全屏按钮组件
+ *
+ * @param target 全屏目标元素
+ * @param fullscreenIcon 全屏时图标
+ * @param fullscreenExitIcon 退出全屏时图标
+ * @param restProps 其他属性
+ * @returns 返回全屏按钮组件
+ */
+export declare const FullscreenButton: React.FC<FullscreenButtonProps>;

package/dist/components/global-spin/index.d.ts

@@ -0,0 +1,6 @@
+import type { ReactNode } from "react";
+export interface GlobalSpinProps {
+    className?: string;
+    children: ReactNode;
+}
+export declare function GlobalSpin({ children, className }: GlobalSpinProps): string | number | bigint | boolean | Iterable<ReactNode> | Promise<string | number | bigint | boolean | import("#node_modules/@types/react").ReactPortal | import("#node_modules/@types/react").ReactElement<unknown, string | import("#node_modules/@types/react").JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | import("#node_modules/@types/react").JSX.Element | null | undefined;

package/dist/components/iframe/index.d.ts

@@ -0,0 +1 @@
+export declare function Iframe(): import("#node_modules/@types/react").JSX.Element | null;

package/dist/components/jss-theme-provider/index.d.ts

@@ -0,0 +1,26 @@
+import type { ReactNode } from "react";
+/**
+ * 自定义的JSS主题提供者组件
+ *
+ * @zh 自定义的 JSS 主题提供者组件，用于在 React 应用中提供 JSS 主题
+ * @en Custom JSS theme provider component, used to provide JSS themes in React applications
+ */
+export interface JSSThemeProviderProps {
+    /**
+     * 子组件
+     *
+     * @zh 子组件，该组件将接收JSS主题
+     * @en Children components, which will receive the JSS theme
+     */
+    children: ReactNode;
+}
+/**
+ * JSSThemeProvider 组件
+ *
+ * @zh JSSThemeProvider 组件，用于将 Ant Design 的 token 和全局主题状态传递给子组件
+ * @en JSSThemeProvider component, used to pass Ant Design tokens and global theme state to child components
+ *
+ * @param {JSSThemeProviderProps} props 组件属性
+ * @returns {JSX.Element} 返回的JSX元素
+ */
+export declare function JSSThemeProvider({ children }: JSSThemeProviderProps): import("#node_modules/@types/react").JSX.Element;

package/dist/components/not-found/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @zh 框架内置 404 兜底页。模块可通过自定义 `*` 路由覆盖。
+ * @en Framework built-in 404 fallback. Modules may override it with their own `*` route.
+ */
+export declare function NotFound(): import("#node_modules/@types/react").JSX.Element;
+export default NotFound;

package/dist/components/page-error/index.d.ts

@@ -0,0 +1,2 @@
+import type { FallbackProps } from "react-error-boundary";
+export declare function PageError({ error, resetErrorBoundary }: FallbackProps): import("#node_modules/@types/react").JSX.Element;

package/dist/components/scrollbar/index.d.ts

@@ -0,0 +1,7 @@
+import type { Props as SimplebarProps } from "simplebar-react";
+/**
+ * @see https://github.com/Grsmto/simplebar/tree/master/packages/simplebar-react
+ */
+export declare function Scrollbar({ ref, children, ...other }: SimplebarProps & {
+    ref?: React.RefObject<HTMLElement | null>;
+}): import("#node_modules/@types/react").JSX.Element;

package/dist/components/unknown-component/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @zh 框架内置「路由无对应组件」兜底页，用于后端下发路由找不到前端组件时。
+ * @en Framework built-in fallback for backend routes whose frontend component is missing.
+ */
+export declare function UnknownComponent(): import("#node_modules/@types/react").JSX.Element;
+export default UnknownComponent;

package/dist/constants/options.d.ts

@@ -0,0 +1,9 @@
+import type { TFunction } from "i18next";
+export declare function getYesNoOptions(t: TFunction<"translation", undefined>): {
+    label: string;
+    value: number;
+}[];
+export declare function getBooleanOptions(t: TFunction<"translation", undefined>): {
+    label: string;
+    value: boolean;
+}[];

package/dist/constants/regular-expressions.d.ts

@@ -0,0 +1,22 @@
+/**
+ * 正则大全
+ * @see https://any-rule.vercel.app/
+ *
+ * 你需要的大部分规则可以通过上面的网站生成，然后复制粘贴到你的代码中。
+ */
+export declare const USERNAME_REGEXP: RegExp;
+export declare const ALPHA_NUMERIC_ONLY_REGEXP: RegExp;
+/**
+ * @description 统一社会信用代码
+ * @see https://creditbj.jxj.beijing.gov.cn/credit-portal/credit_service/legal/search
+ *
+ * @example 91110105MA0071F38D, 91110105MADDCJMC8C, 91110101MABUT67T06
+ */
+export declare const UNIFIED_SOCIAL_CREDIT_CODE_REGEXP: RegExp;
+/**
+ * @description 手机号，只要是 1 开头即可
+ *
+ * @example 008618311006933, +8617888829981, 19119255642
+ */
+export declare const MOBILE_PHONE_REGEXP: RegExp;
+export declare const TELEPHONE_REGEXP: RegExp;

package/dist/constants/rules.d.ts

@@ -0,0 +1,80 @@
+import type { TFunction } from "i18next";
+export declare const FORM_REQUIRED: {
+    required: boolean;
+}[];
+/**
+ * 用户名规则验证函数
+ */
+export declare function USERNAME_RULES(t: TFunction<"translation", undefined>): ({
+    required: boolean;
+    message: string;
+    pattern?: undefined;
+} | {
+    pattern: RegExp;
+    message: string;
+    required?: undefined;
+})[];
+/**
+ * 密码规则验证函数
+ *
+ */
+export declare function PASSWORD_RULES(t: TFunction<"translation", undefined>): ({
+    required: boolean;
+    message: string;
+    pattern?: undefined;
+} | {
+    pattern: RegExp;
+    message: string;
+    required?: undefined;
+})[];
+/**
+ * 仅允许字母和数字的规则函数
+ *
+ */
+export declare function ALPHA_NUMERIC_ONLY_RULES(t: TFunction<"translation", undefined>): ({
+    required: boolean;
+    message: string;
+    pattern?: undefined;
+} | {
+    pattern: RegExp;
+    message: string;
+    required?: undefined;
+})[];
+/**
+ * 获取统一社会信用代码校验规则
+ *
+ */
+export declare function UNIFIED_SOCIAL_CREDIT_CODE_RULES(t: TFunction<"translation", undefined>): ({
+    required: boolean;
+    message: string;
+    pattern?: undefined;
+} | {
+    pattern: RegExp;
+    message: string;
+    required?: undefined;
+})[];
+/**
+ * 返回手机验证规则对象
+ *
+ */
+export declare function MOBILE_PHONE_RULES(t: TFunction<"translation", undefined>): ({
+    required: boolean;
+    message: string;
+    pattern?: undefined;
+} | {
+    pattern: RegExp;
+    message: string;
+    required?: undefined;
+})[];
+export declare function TELEPHONE_RULES(t: TFunction<"translation", undefined>): ({
+    required: boolean;
+    message: string;
+    pattern?: undefined;
+} | {
+    pattern: RegExp;
+    message: string;
+    required?: undefined;
+})[];
+export declare function PHONE_RULE(t: TFunction<"translation", undefined>): {
+    validator: (_: unknown, value: string) => Promise<void>;
+};

package/dist/hooks/use-access/constants.d.ts

@@ -0,0 +1,24 @@
+/**
+ * 统一管理权限常量，避免在项目中到处写死字符串，便于维护。
+ */
+/**
+ * 按钮权限前缀
+ */
+export declare const permissionPrefix = "permission:button";
+/**
+ * 常见按钮权限：
+ * - get: 获取
+ * - update: 更新
+ * - delete: 删除
+ * - add: 新增
+ */
+export declare const accessControlCodes: {
+    get: string;
+    update: string;
+    delete: string;
+    add: string;
+};
+export declare const AccessControlRoles: {
+    admin: string;
+    common: string;
+};

package/dist/hooks/use-access/index.d.ts

@@ -0,0 +1,9 @@
+export * from "./constants";
+/**
+ * @zh 权限判断
+ * @en Access judgment
+ */
+export declare function useAccess(): {
+    hasAccessByCodes: (permission?: string | Array<string>) => boolean;
+    hasAccessByRoles: (roles?: string | Array<string>) => boolean;
+};

package/dist/hooks/use-css-var/index.d.ts

@@ -0,0 +1,17 @@
+export interface UseCssVarOptions {
+    initialValue?: string;
+}
+export interface UseCssVarProps {
+    name: `--${string}`;
+    root?: HTMLElement;
+    options?: UseCssVarOptions;
+}
+export interface CssVarControls {
+    set: (value: string) => void;
+    get: () => string;
+    remove: () => void;
+}
+/**
+ * @see https://soorria.com/snippets/use-css-var-react
+ */
+export declare function useCssVar(name: `--${string}`, root?: HTMLElement, options?: UseCssVarOptions): CssVarControls;

package/dist/hooks/use-current-route/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 获取当前路由信息
+ *
+ * @returns 当前路由的匹配结果
+ */
+export declare function useCurrentRoute(): import("react-router").UIMatch<unknown, import("../..").RouteMeta>;

package/dist/hooks/use-device-type/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 判断当前设备类型（移动设备、iPad、PC 等）
+ *
+ */
+export declare function useDeviceType(): {
+    isMobile: boolean;
+    isIpad: boolean;
+    isPC: boolean;
+};

package/dist/hooks/use-language/index.d.ts

@@ -0,0 +1,5 @@
+import type { LanguageType } from "../../locales/index";
+export declare function useLanguage(): {
+    language: LanguageType;
+    setLanguage: (locale: LanguageType) => Promise<void>;
+};

package/dist/hooks/use-layout-menu/index.d.ts

@@ -0,0 +1,6 @@
+import type { PageLayoutType } from "../../store/preferences/types";
+export declare function useLayoutMenu(): {
+    pageLayout: PageLayoutType;
+    setPageLayout: (value: PageLayoutType) => void;
+    layoutButtonTrigger: import("#node_modules/@types/react").JSX.Element;
+};

package/dist/hooks/use-layout-style/index.d.ts

@@ -0,0 +1,19 @@
+import type { CSSProperties } from "react";
+import type { VisibleDomRect } from "../../utils/dom/index";
+/**
+ * @zh 获取布局内容区域的样式
+ * @en Get the style of the layout content area
+ */
+export declare function useLayoutContentStyle(): {
+    contentElement: import("#node_modules/@types/react").RefObject<HTMLDivElement | null>;
+    overlayStyle: CSSProperties;
+    visibleDomRect: VisibleDomRect | null;
+};
+export declare function useLayoutHeaderStyle(): {
+    getLayoutHeaderHeight: () => number;
+    setLayoutHeaderHeight: (height: number) => void;
+};
+export declare function useLayoutFooterStyle(): {
+    getLayoutFooterHeight: () => number;
+    setLayoutFooterHeight: (height: number) => void;
+};