@oj-module/runtime 0.1.5

package/dist/layout/layout-mixed-sidebar/first-column-menu.d.ts

@@ -0,0 +1,9 @@
+import type { MenuProps } from "antd";
+import type { MenuItemType } from "../layout-menu/types";
+interface FirstColumnMenuProps {
+    menus?: MenuItemType[];
+    sideNavMenuKeyInSplitMode?: string;
+    handleMenuSelect?: (key: string, mode: MenuProps["mode"]) => void;
+}
+export default function FirstColumnMenu({ handleMenuSelect, menus, sideNavMenuKeyInSplitMode, }: FirstColumnMenuProps): import("#node_modules/@types/react").JSX.Element;
+export {};

package/dist/layout/layout-mixed-sidebar/index.d.ts

@@ -0,0 +1,14 @@
+import type { MenuProps } from "antd";
+import type { MenuItemType } from "../layout-menu/types";
+interface LayoutMixedSidebarProps {
+    computedSidebarWidth?: number;
+    topNavItems?: MenuItemType[];
+    sideNavItems?: MenuItemType[];
+    sideNavMenuKeyInSplitMode?: string;
+    handleMenuSelect?: (key: string, mode: MenuProps["mode"]) => void;
+}
+/**
+ * 双列布局侧边栏
+ */
+export default function LayoutMixedSidebar({ computedSidebarWidth, sideNavItems, topNavItems, handleMenuSelect, sideNavMenuKeyInSplitMode, }: LayoutMixedSidebarProps): import("#node_modules/@types/react").JSX.Element;
+export {};

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

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

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

@@ -0,0 +1,5 @@
+/**
+ * @zh 根布局组件
+ * @en Root layout component
+ */
+export default function LayoutRoot(): import("#node_modules/@types/react").JSX.Element;

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

@@ -0,0 +1,5 @@
+export interface LayoutSidebarProps {
+    children?: React.ReactNode;
+    computedSidebarWidth: number;
+}
+export default function LayoutSidebar({ children, computedSidebarWidth }: LayoutSidebarProps): import("#node_modules/@types/react").JSX.Element;

package/dist/layout/layout-tabbar/components/draggable-tab-bar.d.ts

@@ -0,0 +1,16 @@
+import type { MenuProps, TabsProps } from "antd";
+import type { TabItemProps } from "../../../store/tabs";
+interface DraggableTabPaneProps extends React.HTMLAttributes<HTMLElement> {
+    "data-node-key": string;
+    "children": React.ReactElement;
+}
+export declare function DraggableTabNode({ className, children, ...props }: DraggableTabPaneProps): import("#node_modules/@types/react").ReactElement<unknown, string | import("#node_modules/@types/react").JSXElementConstructor<any>>;
+interface DraggableTabBarProps {
+    tabBarProps: Parameters<Required<TabsProps>["renderTabBar"]>[0];
+    DefaultTabBar: Parameters<Required<TabsProps>["renderTabBar"]>[1];
+    tabItems: TabItemProps[];
+    items: (tabKey: string) => MenuProps["items"];
+    onClickMenu: (menuKey: string, nodeKey: string) => void;
+}
+export declare function DraggableTabBar({ tabBarProps, DefaultTabBar, tabItems, items, onClickMenu }: DraggableTabBarProps): import("#node_modules/@types/react").JSX.Element;
+export {};

package/dist/layout/layout-tabbar/components/tab-maximize.d.ts

@@ -0,0 +1,10 @@
+interface TabMaximizeProps {
+    className?: string;
+}
+/**
+ * 切换标签页最大化 / 最小化
+ *
+ * @returns 返回标签页最大化 / 最小化的按钮组件
+ */
+export declare function TabMaximize({ className }: TabMaximizeProps): import("#node_modules/@types/react").JSX.Element;
+export {};

package/dist/layout/layout-tabbar/components/tab-options.d.ts

@@ -0,0 +1,17 @@
+/**
+ * TabOptions组件的属性接口
+ * @interface TabOptionsProps
+ * @property {string} activeKey - 当前激活的标签页的key
+ */
+interface TabOptionsProps {
+    activeKey: string;
+    className?: string;
+}
+/**
+ * TabOptions组件
+ * 用于显示标签页的操作选项下拉菜单
+ * @param {TabOptionsProps} props - 组件属性
+ * @returns {JSX.Element} TabOptions组件
+ */
+export declare function TabOptions({ activeKey, className }: TabOptionsProps): import("#node_modules/@types/react").JSX.Element;
+export {};

package/dist/layout/layout-tabbar/hooks/use-dropdown-menu.d.ts

@@ -0,0 +1,26 @@
+import type { MenuProps } from "antd";
+/**
+ * 标签页操作的键值对象
+ * @readonly
+ * @enum {string}
+ * @property {string} REFRESH - 重新加载当前标签页
+ * @property {string} CLOSE - 关闭当前标签页
+ * @property {string} CLOSE_RIGHT - 关闭右侧标签页
+ * @property {string} CLOSE_LEFT - 关闭左侧标签页
+ * @property {string} CLOSE_OTHERS - 关闭其他标签页
+ * @property {string} CLOSE_ALL - 关闭所有标签页
+ */
+export declare const TabActionKeys: {
+    readonly REFRESH: "refresh";
+    readonly CLOSE: "close";
+    readonly CLOSE_RIGHT: "closeRight";
+    readonly CLOSE_LEFT: "closeLeft";
+    readonly CLOSE_OTHERS: "closeOthers";
+    readonly CLOSE_ALL: "closeAll";
+};
+export type TabActionKey = typeof TabActionKeys[keyof typeof TabActionKeys];
+/**
+ * 自定义钩子，用于处理标签页的下拉菜单
+ * @returns {[Function, Function]} 返回一个元组，包含菜单项生成函数和菜单点击处理函数
+ */
+export declare function useDropdownMenu(): readonly [(tabKey: string) => MenuProps["items"], (menuKey: string, nodeKey: string) => void];

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

@@ -0,0 +1,5 @@
+/**
+ * LayoutTabbar 组件
+ * 用于渲染和管理应用程序的标签页导航
+ */
+export default function LayoutTabbar(): import("#node_modules/@types/react").JSX.Element;

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

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

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

@@ -0,0 +1 @@
+export default function ParentLayout(): import("#node_modules/@types/react").JSX.Element;

package/dist/layout/widgets/breadcrumb-views/index.d.ts

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

package/dist/layout/widgets/global-search/components/search-footer.d.ts

@@ -0,0 +1,5 @@
+interface SearchFooterProps {
+    searchItems: number;
+}
+export declare function SearchFooter({ searchItems }: SearchFooterProps): import("#node_modules/@types/react").JSX.Element;
+export {};

package/dist/layout/widgets/global-search/components/search-panel.d.ts

@@ -0,0 +1,11 @@
+import type { MenuItemType } from "../../../layout-menu/types";
+interface SearchPanelProps {
+    menuItem: MenuItemType;
+    setActiveKey: (activeKey: string) => void;
+    enter: (isLink?: boolean) => void;
+    removeHistoryItem: (key: string) => void;
+    active: boolean;
+    showCloseButton: boolean;
+}
+export declare function SearchPanel({ menuItem, active, enter, setActiveKey, showCloseButton, removeHistoryItem }: SearchPanelProps): import("#node_modules/@types/react").JSX.Element;
+export {};

package/dist/layout/widgets/global-search/index.d.ts

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

package/dist/layout/widgets/logo/index.d.ts

@@ -0,0 +1,9 @@
+export interface LogoProps {
+    sidebarCollapsed: boolean;
+    className?: string;
+}
+/**
+ * @zh 高度 48px
+ * @en The height is 48px
+ */
+export declare function Logo({ sidebarCollapsed, className }: LogoProps): import("#node_modules/@types/react").JSX.Element;

package/dist/layout/widgets/notification/index.d.ts

@@ -0,0 +1,19 @@
+import type { ButtonProps } from "antd";
+import type { NotificationItem } from "./types";
+type NotificationEventType = "viewAll" | "makeAll" | "clear" | "read";
+interface Props extends ButtonProps {
+    /**
+     * 显示圆点
+     */
+    onEventChange?: (event: NotificationEventType, item?: NotificationItem) => void;
+    /**
+     * 显示圆点
+     */
+    dot?: boolean;
+    /**
+     * 消息列表
+     */
+    notifications?: NotificationItem[];
+}
+export declare const NotificationPopup: React.FC<Props>;
+export {};

package/dist/layout/widgets/notification/notification-container.d.ts

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

package/dist/layout/widgets/notification/types.d.ts

@@ -0,0 +1,7 @@
+export interface NotificationItem {
+    avatar: string;
+    date: string;
+    isRead?: boolean;
+    message: string;
+    title: string;
+}

package/dist/layout/widgets/preferences/blocks/animation/index.d.ts

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

package/dist/layout/widgets/preferences/blocks/footer/index.d.ts

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

package/dist/layout/widgets/preferences/blocks/general/index.d.ts

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

package/dist/layout/widgets/preferences/blocks/general/utils.d.ts

@@ -0,0 +1 @@
+export declare const getLanguageItems: () => any;

package/dist/layout/widgets/preferences/blocks/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./animation";
+export * from "./footer";
+export * from "./general";
+export * from "./layout";
+export * from "./sidebar";
+export * from "./tabbar";
+export * from "./theme";

package/dist/layout/widgets/preferences/blocks/layout/constants.d.ts

@@ -0,0 +1,4 @@
+export declare const SIDE_NAVIGATION = "side-navigation";
+export declare const TOP_NAVIGATION = "top-navigation";
+export declare const TWO_COLUMN_NAVIGATION = "two-column-navigation";
+export declare const MIXED_NAVIGATION = "mixed-navigation";

package/dist/layout/widgets/preferences/blocks/layout/index.d.ts

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

package/dist/layout/widgets/preferences/blocks/sidebar/index.d.ts

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

package/dist/layout/widgets/preferences/blocks/tabbar/index.d.ts

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

package/dist/layout/widgets/preferences/blocks/theme/builtin.d.ts

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

package/dist/layout/widgets/preferences/blocks/theme/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./builtin";
+export * from "./theme";

package/dist/layout/widgets/preferences/blocks/theme/theme.d.ts

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

package/dist/layout/widgets/preferences/index.d.ts

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

package/dist/layout/widgets/preferences/number-input-spinner.d.ts

@@ -0,0 +1,10 @@
+export interface NumberInputSpinnerProps {
+    children: React.ReactNode;
+    name: string;
+    min: number;
+    max: number;
+    value?: number;
+    disabled?: boolean;
+    onChange?: (a: string, b: number) => void;
+}
+export declare function NumberInputSpinner({ children, disabled, value, name, onChange, min, max, }: NumberInputSpinnerProps): import("#node_modules/@types/react").JSX.Element;

package/dist/layout/widgets/preferences/select-item.d.ts

@@ -0,0 +1,9 @@
+import type { SelectProps } from "antd";
+export interface SelectItemProps {
+    children: React.ReactNode;
+    name: string;
+    value?: string;
+    disabled?: boolean;
+    items: SelectProps["options"];
+}
+export declare function SelectItem({ children, items, disabled, value, name }: SelectItemProps): import("#node_modules/@types/react").JSX.Element;

package/dist/layout/widgets/preferences/switch-item.d.ts

@@ -0,0 +1,8 @@
+import type { SwitchProps } from "antd";
+export interface SwitchItemProps extends Omit<SwitchProps, "onChange"> {
+    children: React.ReactNode;
+    name: string;
+    onChange?: (a: string, b: unknown) => void;
+    tooltip?: React.ReactNode;
+}
+export declare function SwitchItem({ tooltip, children, disabled, checked, name, onChange, ...restProps }: SwitchItemProps): import("#node_modules/@types/react").JSX.Element;

package/dist/layout/widgets/preferences/text-input.d.ts

@@ -0,0 +1,8 @@
+export interface TextInputProps {
+    children: React.ReactNode;
+    name: string;
+    value?: string;
+    disabled?: boolean;
+    onChange?: (name: string, value: string) => void;
+}
+export declare function TextInput({ children, disabled, value, name, onChange, }: TextInputProps): import("#node_modules/@types/react").JSX.Element;

package/dist/layout/widgets/sider-trigger/index.d.ts

@@ -0,0 +1,5 @@
+interface SiderTriggerProps {
+    className?: string;
+}
+export declare function SiderTrigger({ className }: SiderTriggerProps): import("#node_modules/@types/react").JSX.Element;
+export {};

package/dist/locales/helper.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 通用的语言模块映射类型，表示可以嵌套的对象结构
+ *
+ * 导出供 i18nResources 的声明生成引用（P3.5 / TS4023：未导出类型会阻断 d.ts）
+ */
+export interface LanguageModule<T> {
+    [key: string]: T | any;
+}
+/**
+ * 语言文件的参数类型，用于描述导入的语言文件集合
+ */
+export type LanguageFileMap = Record<string, LanguageModule<LanguageFileMap>>;
+export declare function getZhCnLang(): LanguageModule<LanguageFileMap>;
+export declare function getEnUsLang(): LanguageModule<LanguageFileMap>;
+export declare function organizeLanguageFiles(files: LanguageFileMap): LanguageModule<LanguageFileMap>;

package/dist/locales/index.d.ts

@@ -0,0 +1,18 @@
+import type { InitOptions } from "i18next";
+export * from "./t";
+export type LanguageType = "zh-CN" | "en-US";
+export declare const ANT_DESIGN_LOCALE: {
+    "zh-CN": import("antd/lib/locale").Locale;
+    "en-US": import("antd/lib/locale").Locale;
+};
+export declare const i18nResources: {
+    "zh-CN": {
+        translation: import("./helper").LanguageModule<import("./helper").LanguageFileMap>;
+    };
+    "en-US": {
+        translation: import("./helper").LanguageModule<import("./helper").LanguageFileMap>;
+    };
+};
+export declare const i18nInitOptions: InitOptions;
+export declare const i18n: import("i18next").i18n;
+export declare function setupI18n(): void;

package/dist/locales/t.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @zh 此函数没有任何意义，仅用于对 lokalise.i18n-ally 插件获取更好良好的语言提示支持。
+ * @en This function has no practical meaning; it is only used to obtain better language prompt support for the lokalise.i18n-ally plugin.
+ *
+ * @link https://github.com/i18next/react-i18next/issues/1058
+ * @zh 官方不推荐在纯 JS 或者 TS 文件场景下如何使用 react-i18next，且目前没有较好的解决方案。
+ * @en The official recommendation does not cover how to use react-i18next in pure JS or TS file scenarios, and there is currently no good solution.
+ *
+ */
+export declare function $t(path: string): string;

package/dist/module-loader/define-module.d.ts

@@ -0,0 +1,11 @@
+import type { ModuleDefinition } from "./types";
+/**
+ * 声明一个模块。
+ *
+ * 目前只做类型收窄，但它是模块契约的**唯一入口**：
+ * - 编译期：收窄 entry.ts 的导出类型，字段名写错会直接报错
+ * - 构建期：CLI 用 esbuild bundle + 真实 import() 解析出 name / version
+ *   （packages/cli/src/build.ts 的 readModuleDefinition），
+ *   替代 `scripts/build-modules.ts` 里脆弱的正则（B10）
+ */
+export declare function defineModule(definition: ModuleDefinition): ModuleDefinition;

package/dist/module-loader/index.d.ts

@@ -0,0 +1,20 @@
+import type { AppRouteRecordRaw } from "../router/types";
+import type { Manifest, ModuleInstance } from "./types";
+export declare function loadAll(manifest: Manifest): Promise<ModuleInstance[]>;
+export declare function getModules(): ModuleInstance[];
+export declare function getModule(name: string): ModuleInstance | undefined;
+export declare function getRoutes(): AppRouteRecordRaw[];
+export declare function getRegisteredStore<T = unknown>(name: string): T | undefined;
+export declare function getRegisteredApiPrefix(moduleName: string): string | undefined;
+/**
+ * 卸载模块：执行 onDestroy 生命周期 → 清理其布局插槽（US-8）→ 移除实例。
+ * 供运维下线单个模块使用，其余模块不受影响。
+ */
+export declare function unloadModule(name: string): Promise<void>;
+/**
+ * KeepAlive exclude key：各模块路由中 `handle.keepAlive === false` 的路径集合。
+ * 由 module-loader 汇总，不再依赖 access store 的 flatRouteList（B13）。
+ */
+export declare function getKeepAliveExcludeKeys(): string[];
+/** 全部路由 key：关闭多 tab 时整体排除，仅保留切换动画 */
+export declare function getAllRoutePathKeys(): string[];

package/dist/module-loader/keep-alive.d.ts

@@ -0,0 +1,18 @@
+import type { AppRouteRecordRaw } from "../router/types";
+import type { ModuleDefinition } from "./types";
+/**
+ * 纯函数：从一组路由中收集 `handle.keepAlive === false` 的路由 key。
+ * key 与 `flattenRoutes` 产出的键一致，从而能和 KeepAlive 的 `activeCacheKey`
+ * （= pathname）精确匹配。
+ *
+ * 这是 P2.1 把 exclude 计算从 access store 的 `flatRouteList` 反转到
+ * module-loader 的核心：缓存是否排除只取决于「模块声明」，不再依赖某条路由
+ * 是否套了 ContainerLayout（见设计文档 B13 / R9）。
+ */
+export declare function collectKeepAliveExcludes(routes: AppRouteRecordRaw[]): string[];
+/** 纯函数：收集所有路由 key（关闭多 tab 时用于整体排除，仅保留切换动画） */
+export declare function collectAllRoutePaths(routes: AppRouteRecordRaw[]): string[];
+/** 基于一组模块定义计算 exclude key（供单元测试） */
+export declare function getKeepAliveExcludes(definitions: ModuleDefinition[]): string[];
+/** 基于一组模块定义计算全部路由 key（供单元测试） */
+export declare function getAllRoutePaths(definitions: ModuleDefinition[]): string[];

package/dist/module-loader/semver.d.ts

@@ -0,0 +1,8 @@
+/**
+ * P7.6：最小 semver 范围判定，覆盖 CLI 产出的 peerRuntime 形态子集：
+ * 精确版、"^x.y.z"、"~x.y.z"、">=a <b" 空格合取、"*"。
+ * 不追求完整 semver 规范——超纲形态一律返回 false（拒绝加载并显式报错，
+ * 比静默放行安全）。
+ */
+/** version 是否满足 range（空格分隔的多个比较符为合取） */
+export declare function satisfiesSemver(version: string, range: string): boolean;

package/dist/module-loader/slots.d.ts

@@ -0,0 +1,9 @@
+import type { ReactNode } from "react";
+/** 供模块上下文调用：注册/覆盖本模块在某插槽上的节点 */
+export declare function registerSlot(moduleName: string, slotName: string, node: ReactNode): void;
+/** 模块卸载时清理其注册的全部插槽节点 */
+export declare function removeModuleSlots(moduleName: string): void;
+/** 纯读：某插槽当前挂载的全部节点（注册顺序即 Object 值序） */
+export declare function getSlotNodes(slotName: string): ReactNode[];
+/** 布局组件订阅：插槽节点变化（注册/卸载）时触发重渲染 */
+export declare function useSlotNodes(slotName: string): ReactNode[];

package/dist/module-loader/types.d.ts

@@ -0,0 +1,91 @@
+import type { AppRouteRecordRaw } from "../router/types";
+import type { NotificationsApiProvider, SystemApiProvider, UploadApiProvider } from "../store/api-provider";
+import type { AuthProvider } from "../store/auth-provider";
+/** 模块上下文 — 主框架向模块注入的能力 */
+export interface ModuleContext {
+    /** 当前模块的元信息 */
+    module: {
+        name: string;
+        version: string;
+    };
+    /** 主框架工具 */
+    utils: {
+        request: typeof import("../utils/request/index").request;
+    };
+    /** 模块注册器 */
+    register: {
+        /** 注册额外的 Zustand store */
+        store: (name: string, store: unknown) => void;
+        /** 注册 API 路由前缀 */
+        apiPrefix: (prefix: string) => void;
+        /** 接管登录/登出/用户信息（P5）；先到先得，模块卸载时自动注销 */
+        authProvider: (provider: AuthProvider) => void;
+        /** 接管系统角色/菜单类 API（D9）；先到先得，模块卸载时自动注销 */
+        systemApi: (provider: SystemApiProvider) => void;
+        /** 接管通知拉取 API（D9）；先到先得，模块卸载时自动注销 */
+        notificationsApi: (provider: NotificationsApiProvider) => void;
+        /** 接管头像/附件上传端点（D9）；先到先得，模块卸载时自动注销 */
+        uploadApi: (provider: UploadApiProvider) => void;
+    };
+    /** 注册布局插槽节点（US-8 L2），卸载模块时自动清理 */
+    registerSlot: (slotName: string, node: React.ReactNode) => void;
+}
+/** 模块配置 */
+export interface ModuleConfig {
+    /** 模块级别要求的角色，用户须满足其一才能激活此模块 */
+    requiredRoles?: string[];
+    /** 模块级别要求的权限码，用户须全部满足才能激活此模块 */
+    requiredPermissions?: string[];
+    /** 依赖的其他模块 name 列表，须在 beforeInit 之前完成加载 */
+    dependencies?: string[];
+}
+/** 生命周期钩子 */
+export interface ModuleLifecycle {
+    beforeInit?: (ctx: ModuleContext) => Promise<void>;
+    onInit?: (ctx: ModuleContext) => Promise<void>;
+    onActivate?: (ctx: ModuleContext) => Promise<void>;
+    onDeactivate?: (ctx: ModuleContext) => Promise<void>;
+    onDestroy?: (ctx: ModuleContext) => Promise<void>;
+}
+/** i18n 资源声明 */
+export interface ModuleI18n {
+    [locale: string]: () => Promise<Record<string, unknown>>;
+}
+/** 模块定义 — entry.ts 的导出类型 */
+export interface ModuleDefinition {
+    name: string;
+    description: string;
+    version: string;
+    routes: AppRouteRecordRaw[];
+    lifecycle?: ModuleLifecycle;
+    i18n?: ModuleI18n;
+    config?: ModuleConfig;
+    /** 兼容的宿主 runtime 版本（semver 范围），宿主加载前校验，不兼容则拒绝加载并显式报错 */
+    peerRuntime?: string;
+}
+/** 运行时模块实例 */
+export interface ModuleInstance {
+    definition: ModuleDefinition;
+    /** missing-deps：声明的依赖模块缺失或加载失败，本模块未执行生命周期（US-9 禁止半加载） */
+    status: "pending" | "loading" | "loaded" | "active" | "error" | "missing-deps";
+    error?: Error;
+}
+/** manifest.json 中的模块条目 */
+export interface ManifestModuleEntry {
+    /** 模块名称，需与 entry.ts 中 name 一致 */
+    name: string;
+    /** 模块资源路径（本地相对路径或远程 URL） */
+    entry: string;
+    /** 是否启用 */
+    enabled?: boolean;
+    /** 依赖的其他模块 name 列表（清单层冗余声明，供运维观测） */
+    dependencies?: string[];
+    /** 兼容的宿主 runtime 版本（semver 范围），P7.6 起在加载后即刻校验 */
+    peerRuntime?: string;
+}
+/** manifest.json 格式 */
+export interface Manifest {
+    modules: ManifestModuleEntry[];
+    /** 宿主 runtime 实际版本（shell 侧取自 versions.json）；提供即启用 peerRuntime 校验（US-5） */
+    runtimeVersion?: string;
+}

package/dist/pages/login/index.d.ts

@@ -0,0 +1 @@
+export default function Login(): import("#node_modules/@types/react").JSX.Element;

package/dist/plugins/hide-loading.d.ts

@@ -0,0 +1 @@
+export declare function hideLoading(): void;

package/dist/plugins/loading.d.ts

@@ -0,0 +1,7 @@
+export declare const loadingId = "loading-e8a3a985";
+export declare const loadingContainerId = "loading-container-e8a3a985";
+/**
+ * Preview loading page.
+ * https://github.com/user-attachments/assets/110701a8-2cf4-4e5f-a07e-b832da4e1586
+ */
+export declare function setupLoading(): void;

package/dist/router/constants.d.ts

@@ -0,0 +1 @@
+export declare const ROOT_ROUTE_ID = "root-route";

package/dist/router/extra-info/index.d.ts

@@ -0,0 +1 @@
+export * from "./route-path";

package/dist/router/extra-info/route-path.d.ts

@@ -0,0 +1,22 @@
+/**
+ * 如果在其他地方用到了路由跳转，将路由的 path 抽离出来，在此方便维护
+ * 防止修改 path 时忘记修改其他地方的 path
+ */
+export declare const loginPath = "/login";
+export declare const privacyPolicyPath = "/privacy-policy";
+export declare const termsOfServicePath = "/terms-of-service";
+export declare const exceptionPath = "/exception";
+export declare const exception403Path = "/exception/403";
+export declare const exception404Path = "/exception/404";
+export declare const exception500Path = "/exception/500";
+export declare const exceptionUnknownComponentPath = "/exception/not-found-component";
+/**
+ * 判断 pathname 是否为登录页（basename 感知，P0）。
+ *
+ * 供 ky hooks 等 React 之外的场景使用：原始 `location.pathname` 含 BASE_URL，
+ * 子路径部署（/app/）下直接与 loginPath 比较恒为 false，401 时会重复 goLogin。
+ * React 组件内请用 `useLocation()`（react-router 已剥离 basename），无需本函数。
+ *
+ * @param base 部署 basename，Vite 保证以 `/` 结尾
+ */
+export declare function isLoginPathname(pathname: string, base?: string): boolean;

package/dist/router/guard/auth-guard.d.ts

@@ -0,0 +1,21 @@
+interface AuthGuardProps {
+    children?: React.ReactNode;
+}
+/**
+ * @zh AuthGuard 组件，用于权限验证，代码的顺序很重要，不要随意调整
+ * @en AuthGuard component, used for permission verification. The order of the code is important and should not be arbitrarily adjusted
+ */
+export declare function AuthGuard({ children }: AuthGuardProps): string | number | bigint | boolean | Iterable<import("#node_modules/@types/react").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<import("#node_modules/@types/react").ReactNode> | null | undefined> | import("#node_modules/@types/react").JSX.Element | null | undefined;
+export {};
+/**
+ * 验证路由跳转是否正确的步骤：
+ * 1. 未登录情况下，输入 login 路由
+ * 2. 未登录情况下，输入非 login 路由
+ * 3. 已登录情况下，使用系统的退出登录，然后再次登录
+ * 4. 任选一个非 home 页面，使用开发者工具清除 localStorage，刷新页面之后进行登录
+ * 5. 已登录情况下，输入 login 路由
+ * 6. 已登录情况下，输入非 login 路由
+ * 7. 已登录情况下，输入 http://localhost:3333 跳转到 /home 路由，用户接口发送一次
+ * 8. 已登录情况下，输入 http://localhost:3333/ 跳转到 /home 路由，用户接口发送一次
+ * 9. 已登录情况下，输入 http://localhost:3333/home 跳转到 /home 路由，用户接口发送一次
+ */

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

@@ -0,0 +1 @@
+export * from "./auth-guard";

package/dist/router/guard/utils.d.ts

@@ -0,0 +1,2 @@
+import type { AppRouteRecordRaw } from "../types";
+export declare function removeDuplicateRoutes(routes: AppRouteRecordRaw[]): AppRouteRecordRaw[];

package/dist/router/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 当前路由匹配逻辑：
+ * https://mermaid.live/edit#pako:eNqNVF1v0zAU_SuWH6uWD21PfUAqGhqVBqo6EBJJH6zETSySuHIcWDVNGh_TGFtZgW2i0yaK0AYPoAIPFLR1_JkmDU_7Czhx1mXrpi1SrGvfc-451048CzWqY5iHVYs-0UzEOLg3oTpAPNNczJR4rIBc7ga4SWeuKyr0t7772_NBezU8eOcv7Ax6b8RUhRXJikAxuuBxc9JDTFf8V-2w1wNILOSMaOUKd2dAsLHY3_uVsIbgmErcEuJm0blLp6hBnAcm4XiKuFzp_274KwvB8ldgRQkQdjuDtR-DzReZTBK2en6z4TfWM5nD_ZX-wbK_--xwf7PGyGOk1XM1ahGtntAS6fPEgLAC_OZu7KjoxkkleN8RS4PWnt9bvwxf4GP-LUeXaDnGyBIysBJHIAorafwk5vddzIpOlSrh666_ujFY-xK87Pb_fgyedoSyrJPYSjs9rj0CuXTxiHeb2jiqAmRVzcTaoxJmNnFdQhP5CwrFzDL1OGZlSrkStP_InQdXpcuTB3GMTJsdGjkLdNT0KXdK8Gk--LATbD__12oON-sU6IQIMRzKcEHTsOuej95a8r81kxZiWuRr_Nq4Il5Qi87wYqUytfCI0_Dz23Dp59CvbDSNSzcrRceE6FhaNN3CmZ_eaMUUBGahLXKI6OIumI0IKuQmtrEK8yLUcRV5FldhVqZsISKkC5ZQlQhGDFPkVWdOlBK_Op2uOxrMc-bhLGTUM0yYryLLFTOvpiOOJwgyGLKHq1gnnLI78jaKL6UsrCHnIaVHmLn_M6fdRw
+ * 1. 初次进入应用
+ * 2. 加载 auth-guard.tsx 文件
+ * 3. 不包括 login 路由的**路由白名单**，例如：privacy-policy 路由
+ * 4. ……
+ */
+import type { RouteObject } from "react-router";
+export declare const rootRoute: RouteObject[];
+export declare const router: import("react-router").DataRouter;
+export default router;

package/dist/router/routes/config.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 开启后端获取路由的情况下，是否发送路由请求获取路由数据
+ *
+ * 如果设置为 false，则不会单独发送一个请求获取路由数据，而是从用户详情接口中获取动态路由数据
+ * 如果设置为 true，则会单独发送一个请求获取路由数据
+ */
+export declare const isSendRoutingRequest = true;