@oj-module/runtime 0.1.5

package/dist/contract/errors.js

@@ -0,0 +1,20 @@
+/**
+ * 契约制 client 的统一错误类型（AC-D5/§6.2）。
+ *
+ * 业务错误（非 2xx，oj json.fail(code,msg)）与契约违例（dev 校验失败，
+ * code=-1）都收敛为本类型，消费方可 `instanceof` 判别并取 code/msg。
+ *
+ * 本子路径出口（`@oj-module/runtime/contract/errors`）是**生成 client 在
+ * 浏览器侧的唯一入口**（评审 F3）：刻意 zod-free——zod 只随 runtime dist
+ * 走（AC-D15），不进共享资产。
+ */
+export class ContractApiError extends Error {
+    code;
+    msg;
+    constructor(code, msg) {
+        super(msg);
+        this.name = "ContractApiError";
+        this.code = code;
+        this.msg = msg;
+    }
+}

package/dist/contract/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @oj-module/runtime/contract —— API 契约 DSL（AC-D11）。
+ *
+ * 零浏览器依赖（Node codegen 与浏览器运行时双安全）：
+ * - defineApi：契约端点定义（含定义期校验）
+ * - API_DEF：端点品牌标记（旧标记 `ram.api.def` 由 cli 侧自行识别，不在公共出口）
+ * - z：zod re-export（契约 schema 书写；v4 钉版，pnpm catalog 单一来源）
+ * - ContractApiError：契约制 client 统一错误类型
+ * - ScopedRequestLike：生成 client 的 request 最小结构类型
+ */
+export { API_DEF, defineApi } from "./define-api.ts";
+export type { ApiDefinitionInput, HttpMethod } from "./define-api.ts";
+export { ContractApiError } from "./errors.ts";
+export type { ScopedRequestLike } from "./scoped-request-like.ts";
+export { z } from "zod";

package/dist/contract/index.js

@@ -0,0 +1,13 @@
+/**
+ * @oj-module/runtime/contract —— API 契约 DSL（AC-D11）。
+ *
+ * 零浏览器依赖（Node codegen 与浏览器运行时双安全）：
+ * - defineApi：契约端点定义（含定义期校验）
+ * - API_DEF：端点品牌标记（旧标记 `ram.api.def` 由 cli 侧自行识别，不在公共出口）
+ * - z：zod re-export（契约 schema 书写；v4 钉版，pnpm catalog 单一来源）
+ * - ContractApiError：契约制 client 统一错误类型
+ * - ScopedRequestLike：生成 client 的 request 最小结构类型
+ */
+export { API_DEF, defineApi } from "./define-api.js";
+export { ContractApiError } from "./errors.js";
+export { z } from "zod";

package/dist/contract/scoped-request-like.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 生成 client 对 request 实例的最小结构类型（ISP——不依赖 ky/runtime 类型，
+ * 任何满足该形状的对象（runtime 全局 request、模块 scoped client、测试 stub）
+ * 都可 bindRequest 注入）。
+ */
+/** ky ResponsePromise 的最小结构：既是 Promise<Response>（raw 通道）又有 .json() */
+export interface ResponsePromiseLike extends Promise<Response> {
+    json: <T>() => Promise<T>;
+}
+export interface RequestCall {
+    (url: string, options?: {
+        /** 与 ky SearchParamsOption 的 Record 形态对齐——宽于它则真 ky 实例无法赋给本接口 */
+        searchParams?: Record<string, string | number | boolean>;
+        json?: unknown;
+        ignoreLoading?: boolean;
+    }): ResponsePromiseLike;
+}
+export interface ScopedRequestLike {
+    get: RequestCall;
+    post: RequestCall;
+    put: RequestCall;
+    delete: RequestCall;
+    patch: RequestCall;
+    head: RequestCall;
+}

package/dist/contract/scoped-request-like.js

@@ -0,0 +1,6 @@
+/**
+ * 生成 client 对 request 实例的最小结构类型（ISP——不依赖 ky/runtime 类型，
+ * 任何满足该形状的对象（runtime 全局 request、模块 scoped client、测试 stub）
+ * 都可 bindRequest 注入）。
+ */
+export {};

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;
+};

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

@@ -0,0 +1,61 @@
+/**
+ * 包装下用户偏好设置的参数，不需要存储在 localStorage 中，但是为了方便使用的变量可以在这里出现。
+ *
+ * @returns 返回包含用户偏好设置的对象，包括主题、是否为默认设置、是否为深色主题、是否为浅色主题
+ */
+export declare function usePreferences(): {
+    isDefault: boolean;
+    isDark: boolean;
+    isLight: boolean;
+    theme: import("../../store/preferences/types").ThemeType;
+    colorBlindMode: boolean;
+    colorGrayMode: boolean;
+    themeRadius: number;
+    themeColorPrimary: string;
+    builtinTheme: import("../../store/preferences/types").BuiltinThemeType;
+    tabbarStyleType: import("../../store/preferences/types").TabsStyleType;
+    tabbarEnable: boolean;
+    tabbarShowIcon: boolean;
+    tabbarPersist: boolean;
+    tabbarDraggable: boolean;
+    tabbarShowMore: boolean;
+    tabbarShowMaximize: boolean;
+    transitionProgress: boolean;
+    transitionLoading: boolean;
+    transitionEnable: boolean;
+    transitionName: string;
+    navigationStyle: import("../../store/preferences/types").NavigationType;
+    watermark: boolean;
+    watermarkContent: string;
+    enableBackTopButton: boolean;
+    pageLayout: import("../../store/preferences/types").PageLayoutType;
+    enableFrontendAceess: boolean;
+    enableBackendAccess: boolean;
+    language: import("../../locales").LanguageType;
+    enableDynamicTitle: boolean;
+    enableCheckUpdates: boolean;
+    checkUpdatesInterval: number;
+    sidebarEnable?: boolean;
+    sidebarWidth: number;
+    sideCollapsedWidth: number;
+    sidebarCollapsed: boolean;
+    sidebarCollapseShowTitle: boolean;
+    sidebarExtraCollapsedWidth: number;
+    firstColumnWidthInTwoColumnNavigation: number;
+    sidebarTheme: import("antd").MenuProps["theme"];
+    accordion: boolean;
+    enableFooter: boolean;
+    fixedFooter: boolean;
+    companyName: string;
+    companyWebsite: string;
+    copyrightDate: string;
+    ICPNumber: string;
+    ICPLink: string;
+    reset: () => void;
+    changeSiteTheme: (theme: import("../../store/preferences/types").ThemeType) => void;
+    changeLanguage: (language: import("../../locales").LanguageType) => void;
+    setPreferences: {
+        <T>(key: string, value: T): void;
+        <T extends Partial<import("../../store/preferences/types").PreferencesState>>(preferences: T): void;
+    };
+};

package/dist/icons/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./local-icons";
+export * from "./menu-icons";
+export * from "./ri";

package/dist/icons/local-icons.d.ts

@@ -0,0 +1,17 @@
+import type { IconComponent } from "./types";
+/**
+ * 本地 SVG 图标集（构建期由 unplugin-icons 内联，P3.1 起包装导出，
+ * 避免 `~icons/*` 虚拟模块泄漏进包声明）。
+ */
+export declare const EmbeddedIcon: IconComponent;
+export declare const ExternalIcon: IconComponent;
+export declare const LayoutCenterIcon: IconComponent;
+export declare const LayoutLeftIcon: IconComponent;
+export declare const LayoutRightIcon: IconComponent;
+export declare const MixedNavigationIcon: IconComponent;
+export declare const OutsidePageIcon: IconComponent;
+export declare const ProfileCardIcon: IconComponent;
+export declare const ServerErrorIcon: IconComponent;
+export declare const SideNavigationIcon: IconComponent;
+export declare const TopNavigationIcon: IconComponent;
+export declare const TwoColumnNavigationIcon: IconComponent;

package/dist/icons/menu-icons.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Icons used in the menu.
+ */
+export declare const menuIcons: Record<string, any>;

package/dist/icons/ri.d.ts

@@ -0,0 +1,14 @@
+import type { IconComponent } from "./types";
+/**
+ * Remix Icon 常用子集（构建期由 unplugin-icons 内联，P3.1 起包装导出，
+ * 避免 `~icons/*` 虚拟模块泄漏进包声明）。
+ */
+export declare const RiAccountCircleLine: IconComponent;
+export declare const RiContrastFill: IconComponent;
+export declare const RiFullscreenExitLine: IconComponent;
+export declare const RiFullscreenLine: IconComponent;
+export declare const RiMailCheckLine: IconComponent;
+export declare const RiMoonIcon: IconComponent;
+export declare const RiReactjsLine: IconComponent;
+export declare const RiSunIcon: IconComponent;
+export declare const RiUserSettingsLine: IconComponent;

package/dist/icons/types.d.ts

@@ -0,0 +1,9 @@
+import type { ComponentType, SVGProps } from "react";
+/**
+ * 图标组件统一形状（P3.1）。
+ *
+ * 图标在构建期由 unplugin-icons 内联为组件；运行时出口不直接
+ * re-export `~icons/*` 虚拟模块的 default，而是以本类型注解包装，
+ * 使 d.ts 声明自足、不泄漏虚拟模块说明符。
+ */
+export type IconComponent = ComponentType<SVGProps<SVGSVGElement>>;

package/dist/index.d.ts

@@ -0,0 +1,44 @@
+/**
+ * `@oj-module/runtime` 主入口。
+ *
+ * 这是模块工程**唯一**应该 import 的框架入口（设计文档 D3 / §4.3）。
+ * 出口已于 P3.1 依据 P1 的实际用量冻结（tests/runtime-exports.test.ts
+ * 即冻结契约）：components/basic-*、api、hooks、store、icons、
+ * utils/tree、constants/options、路由与模块类型。
+ *
+ * 注意：antd、react、react-router、@tanstack/react-query 等共享依赖
+ * 由宿主的 importmap 提供，模块应直接 import 它们，不要从 runtime 转出。
+ */
+import "./styles/index.css";
+export * from "./api/system/menu";
+export * from "./api/system/role";
+export * from "./api/user";
+export { AccessControl } from "./components/access-control";
+export { BasicButton } from "./components/basic-button";
+export { BasicContent } from "./components/basic-content";
+export * from "./components/basic-form";
+export { BasicTable } from "./components/basic-table";
+export type { BasicTableProps } from "./components/basic-table";
+export { Iframe } from "./components/iframe";
+export * from "./constants/options";
+export * from "./hooks/use-access";
+export { usePreferences } from "./hooks/use-preferences";
+export * from "./icons";
+export { LayoutEffects } from "./layout/layout-effects";
+export { setupI18n } from "./locales";
+export { getModule, getModules, getRegisteredApiPrefix, getRegisteredStore, getRoutes, loadAll, unloadModule, } from "./module-loader";
+export { defineModule } from "./module-loader/define-module";
+export { useSlotNodes } from "./module-loader/slots";
+export type { ModuleConfig, ModuleContext, ModuleDefinition, ModuleI18n, ModuleLifecycle, } from "./module-loader/types";
+export type { Manifest, ManifestModuleEntry, ModuleInstance, } from "./module-loader/types";
+export type { AppRouteRecordRaw, RouteMeta } from "./router/types";
+export type { NotificationsApiProvider, SystemApiProvider, UploadApiProvider, } from "./store/api-provider";
+export { useAuthStore } from "./store/auth";
+export type { AuthProvider } from "./store/auth-provider";
+export { useUserStore } from "./store/user";
+export type { AppInfo } from "./types/app-info";
+export { getAllExpandedKeys } from "./utils/get-all-expanded-keys";
+export { getAppInfo } from "./utils/get-app-info";
+export { getRedirectPath } from "./utils/get-redirect-path";
+export * from "./utils/tree";
+export { z } from "zod";

package/dist/layout/constants.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Layout Header Height
+ */
+export declare const headerHeight = 48;
+/**
+ * Layout Footer Height
+ */
+export declare const footerHeight = 40;
+/**
+ * Sidebar Title Height
+ */
+export declare const sidebarTitleHeight = 52;
+/**
+ * Sider Trigger Height
+ */
+export declare const siderTriggerHeight = 40;
+/**
+ * Tabbar Height Height
+ */
+export declare const tabbarHeight = 35;
+/**
+ * @zh 默认命名空间
+ * @en Default namespace
+ */
+export declare const DEFAULT_NAMESPACE = "react-antd-admin";
+/**
+ * @zh 主内容区域的元素 ID
+ * @en Main content element ID
+ */
+export declare const ELEMENT_ID_MAIN_CONTENT = "__react-antd-admin_main_content";
+/**
+ * @zh layout content 组件的高度
+ * @en Height of the layout content component
+ */
+export declare const CSS_VARIABLE_LAYOUT_CONTENT_HEIGHT = "--react-antd-admin-content-height";
+/**
+ * @zh layout content 组件的宽度
+ * @en Width of the layout content component
+ */
+export declare const CSS_VARIABLE_LAYOUT_CONTENT_WIDTH = "--react-antd-admin-content-width";
+/**
+ * @zh layout header 组件的高度
+ * @en Height of the layout header component
+ */
+export declare const CSS_VARIABLE_LAYOUT_HEADER_HEIGHT = "--react-antd-admin-header-height";
+/**
+ * @zh layout footer 组件的高度
+ * @en Height of the layout footer component
+ */
+export declare const CSS_VARIABLE_LAYOUT_FOOTER_HEIGHT = "--react-antd-admin-footer-height";

package/dist/layout/container-layout/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Please do not use this component through lazy, otherwise the switching routing page will flash.
+ * 请不要通过 lazy 使用这个组件，否则切换路由页面会发生闪动。
+ *
+ * NO:
+ * const ContainerLayout = lazy(() => import("./index"));
+ *
+ * YES:
+ * import ContainerLayout from "./index";
+ */
+export default function ContainerLayout(): import("#node_modules/@types/react").JSX.Element;

package/dist/layout/fullscreen-layout/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 全屏布局（P1，login 模块化）：框架兜住「占满视口 + 无 chrome + 主题正确 +
+ * 品牌位统一」——品牌区（logo + 应用标题）、右上角工具区（布局预览/主题/语言）、
+ * 横幅列与页脚全部内置，模块只写内容区（经 Outlet 渲染），零 `#src/` 依赖。
+ *
+ * 与 `none` 的分工：`none` 是裸 Outlet，框架不保证任何视口。
+ * 外壳从原内置登录页（pages/login）平移而来（P2 完成页面侧剥离）。
+ */
+export default function FullscreenLayout(): import("#node_modules/@types/react").JSX.Element;

package/dist/layout/hooks/index.d.ts

@@ -0,0 +1 @@
+export * from "./use-layout";

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

@@ -0,0 +1,20 @@
+/**
+ * 获取当前页面的布局类型信息
+ *
+ * @returns 返回包含当前布局类型信息的对象，包含：
+ * - currentLayout: 当前导航类型
+ * - isSideNav: 是否为侧边导航
+ * - isTopNav: 是否为顶部导航
+ * - isMixedNav: 是否为混合导航
+ * - isTwoColumnNav: 是否为双列导航
+ */
+export declare function useLayout(): {
+    currentLayout: import("../../store/preferences/types").NavigationType;
+    isSideNav: boolean;
+    isTopNav: boolean;
+    isMixedNav: boolean;
+    isTwoColumnNav: boolean;
+    sidebarWidth: number;
+    sideCollapsedWidth: number;
+    firstColumnWidthInTwoColumnNavigation: number;
+};

package/dist/layout/keep-alive-layer/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * KeepAlive 固定层（P2.1）。
+ *
+ * 设计要点（设计文档 §4.4 / B13 / R9）：
+ * - 从 `ContainerLayout → LayoutContent` 上移为 shell 固定层组件，缓存逻辑不再耦合
+ *   某个具体布局组件；后续布局去中心化（handle.layout）不会影响缓存是否生效。
+ * - `exclude` 改由 module-loader 汇总各模块 `handle.keepAlive` 计算
+ *   （`getKeepAliveExcludeKeys`），而非 access store 的 flatRouteList。
+ * - 只包裹「页面 outlet」本身：顶部 chrome（header / sidebar / tabbar）在 KeepAlive
+ *   之外渲染，因此整站 chrome 不进入缓存，避免切回路由时 chrome 状态错位。
+ *
+ * 注意：这里刻意不把 KeepAlive 直接包在 LayoutRoot 的 <Outlet/> 外层，否则会把
+ * chrome 一起缓存，违背「整站 chrome 不消失 / 状态不错位」的约束。
+ */
+export default function KeepAliveLayer(): import("#node_modules/@types/react").JSX.Element;

package/dist/layout/layout-content/index.d.ts

@@ -0,0 +1,3 @@
+export interface LayoutContentProps {
+}
+export default function LayoutContent(): import("#node_modules/@types/react").JSX.Element;

package/dist/layout/layout-effects/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 全局副作用（不含路由守卫）：动态标题、暗色主题 html.dark、NProgress 收尾。
+ *
+ * 偏差 4（layout e2e H4 暴露）：这些 effect 原先只存在于 LayoutRoot，而
+ * LayoutRoot 同时携带 AuthGuard——宿主（shell）为免登录能力绕开 LayoutRoot
+ * 后，副作用一并丢失：主题切换只改 store、html.dark 永不生效。抽取为本组件
+ * 供两条链路共用：App 链 = LayoutRoot 内部使用；宿主链 = 根路由直接挂载。
+ */
+export declare function LayoutEffects(): null;

package/dist/layout/layout-footer/index.d.ts

@@ -0,0 +1,5 @@
+interface LayoutFooterProps {
+    className?: string;
+}
+export default function LayoutFooter({ className }: LayoutFooterProps): import("#node_modules/@types/react").JSX.Element | null;
+export {};

package/dist/layout/layout-header/components/fullscreen-button.d.ts

@@ -0,0 +1,2 @@
+import type { FullscreenButtonProps } from "../../../components/fullscreen-button/index";
+export declare function FullscreenButton({ target, ...restProps }: FullscreenButtonProps): import("#node_modules/@types/react").JSX.Element;

package/dist/layout/layout-header/components/language-button.d.ts

@@ -0,0 +1,2 @@
+import type { ButtonProps } from "antd";
+export declare function LanguageButton({ ...restProps }: ButtonProps): import("#node_modules/@types/react").JSX.Element;

package/dist/layout/layout-header/components/theme-button.d.ts

@@ -0,0 +1,9 @@
+import type { ButtonProps } from "antd";
+/**
+ * @zh 主题切换组件
+ * 允许用户通过按钮切换网站的亮色和暗色主题
+ *
+ * @en Theme Button Component
+ * Allows users to toggle between light and dark themes of the website via a button
+ */
+export declare function ThemeButton({ ...restProps }: ButtonProps): import("#node_modules/@types/react").JSX.Element;

package/dist/layout/layout-header/components/user-menu.d.ts

@@ -0,0 +1,2 @@
+import type { ButtonProps } from "antd";
+export declare function UserMenu({ ...restProps }: ButtonProps): import("#node_modules/@types/react").JSX.Element;

package/dist/layout/layout-header/index.d.ts

@@ -0,0 +1,5 @@
+export interface LayoutHeaderProps {
+    className?: string;
+    children?: React.ReactNode;
+}
+export default function LayoutHeader({ className, children }: LayoutHeaderProps): import("#node_modules/@types/react").JSX.Element;

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

@@ -0,0 +1,17 @@
+import type { MenuProps } from "antd";
+import type { MenuItemType } from "./types";
+interface LayoutMenuProps {
+    mode?: MenuProps["mode"];
+    /**
+     * 控制是否自动展开当前路由对应的菜单项
+     *
+     * Why?
+     * 注意：当菜单模式为顶部导航模式，菜单 mode 为 horizontal，初次进入页面时，菜单不应自动展开，可以指定 autoExpandCurrentMenu 为 false 关闭自动展开功能
+     * @see https://github.com/user-attachments/assets/705ae01d-db7f-4f42-b4dd-66adba0dd68f
+     */
+    autoExpandCurrentMenu?: boolean;
+    menus?: MenuItemType[];
+    handleMenuSelect?: (key: string, mode: MenuProps["mode"]) => void;
+}
+export default function LayoutMenu({ mode, autoExpandCurrentMenu, handleMenuSelect, menus, }: LayoutMenuProps): import("#node_modules/@types/react").JSX.Element;
+export {};

package/dist/layout/layout-menu/style.d.ts

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

package/dist/layout/layout-menu/types.d.ts

@@ -0,0 +1,26 @@
+/**
+ * 菜单项目类型
+ */
+export interface MenuItemType {
+    /**
+     * 菜单路径,item 的唯一标志
+     */
+    key: string;
+    /**
+     * 菜单项标题
+     */
+    label: React.ReactNode;
+    /**
+     * 子菜单的菜单项
+     */
+    children?: MenuItemType[];
+    /**
+     * 菜单图标
+     */
+    icon?: React.ReactNode;
+    /**
+     * 是否禁用菜单
+     * @default false
+     */
+    disabled?: boolean;
+}

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

@@ -0,0 +1,7 @@
+import type { MenuProps } from "antd";
+export declare function useMenu(): {
+    handleMenuSelect: (key: string, mode: MenuProps["mode"]) => void;
+    sideNavMenuKeyInSplitMode: string;
+    topNavItems: import("./types").MenuItemType[];
+    sideNavItems: import("./types").MenuItemType[];
+};

package/dist/layout/layout-menu/utils.d.ts

@@ -0,0 +1,49 @@
+import type { MenuItemType } from "./types";
+/**
+ * 将菜单树中的所有 label 转换为国际化文本
+ * @param menus 原始菜单数组
+ * @param t Translation 函数
+ * @returns 转换后的菜单数组
+ */
+export declare function translateMenus(menus: MenuItemType[], t: (key: string) => string): MenuItemType[];
+/**
+ * 通过路径查找菜单
+ *
+ * @param list 菜单列表
+ * @param path 菜单路径
+ * @returns 找到的菜单对象，未找到则返回 null
+ */
+export declare function findMenuByPath(list: MenuItemType[], path?: string): MenuItemType | null;
+/**
+ * 通过路径查找根菜单
+ *
+ * @param menus 菜单列表
+ * @param path 菜单路径，可选
+ * @returns 包含查找到的菜单、根菜单和根菜单路径的对象
+ */
+export declare function findRootMenuByPath(menus: MenuItemType[], path?: string): {
+    findMenu: MenuItemType | null;
+    rootMenu: MenuItemType | null;
+    rootMenuPath: string | null;
+};
+/**
+ * 递归查找第一个子菜单路径下的最深层级的第一个菜单项
+ *
+ * @param splitSideNavItems 菜单列表
+ * @returns 找到的最深层级的第一个菜单项
+ */
+export declare function findDeepestFirstItem(splitSideNavItems: MenuItemType[]): MenuItemType | null;
+/**
+ * 获取菜单项中所有键及其对应的层级
+ *
+ * @param menuItems1 菜单项数组
+ * @returns 一个对象，键为菜单项的 key，值为菜单项的层级
+ */
+export declare function getLevelKeys(menuItems1: MenuItemType[]): Record<string, number>;
+/**
+ * 获取菜单项的父级键
+ *
+ * @param menuItems 菜单项数组
+ * @returns 返回记录每个菜单项键对应的父级键数组的对象
+ */
+export declare function getParentKeys(menuItems: MenuItemType[]): Record<string, string[]>;