knight-web 2.0.26 → 2.1.1

package/frame/base/AbstractPanel.d.ts

@@ -1,6 +1,110 @@
 import { AbstractObject, AbstractObjectProps } from "./AbstractObject";
-/** 抽象界面基类 */
 export declare abstract class AbstractPanel<Props extends AbstractPanelProps = AbstractPanelProps> extends AbstractObject<Props> {
+    private _timers;
+    private _listeners;
+    private _rafIds;
+    componentWillUnmount(): void;
+    /** 释放所有自动追踪的资源（卸载时自动调用，也可手动调用） */
+    protected Release(): void;
+    /**
+     * 创建响应式数据。对返回对象的任何属性进行赋值（深层嵌套也有效），
+     * 或调用数组的变异方法（push/pop/splice 等），都会自动触发界面重新渲染。
+     *
+     * **必须作为类字段初始化**（非 OnLoad），因为首次 render 在 OnLoad 之前执行。
+     *
+     * @example
+     *   private $data = this.Reactive({ count: 0, list: [] as string[] });
+     *
+     *   // 任意位置修改，界面自动刷新
+     *   this.$data.count++;
+     *   this.$data.list.push('new item');
+     *
+     *   // 在 OnRender 中直接读取
+     *   return <div>{this.$data.count}</div>;
+     */
+    protected Reactive<T extends object>(initial: T): T;
+    /** 导航到指定路径 */
+    protected Navigate(path: string, search?: string): void;
+    /** 浏览器后退 */
+    protected Back(): void;
+    /** 浏览器前进 */
+    protected Forward(): void;
+    /** 跳转历史记录 (delta 为负数后退, 正数前进) */
+    protected Go(delta: number): void;
+    /** 刷新当前页面 */
+    protected Reload(): void;
+    /** 替换当前历史记录并导航到指定 URL */
+    protected Replace(url: string, search?: string): void;
+    /** 打开新窗口 */
+    protected OpenWindow(url: string, target?: string, features?: string): void;
+    /** 当前路径名 */
+    protected get PathName(): string;
+    /** 获取 URL 查询参数 */
+    protected SearchParams<T extends object = Record<string, string>>(): T;
+    /**
+     * setTimeout — 组件卸载时自动 clearTimeout
+     * @returns 定时器 ID (可用于提前 ClearTimer)
+     */
+    protected Timeout(fn: () => void, delay: number): number;
+    /**
+     * setInterval — 组件卸载时自动 clearInterval
+     * @returns 定时器 ID (可用于提前 ClearTimer)
+     */
+    protected Interval(fn: () => void, delay: number): number;
+    /** 手动清除定时器 (同时匹配 setTimeout 和 setInterval) */
+    protected ClearTimer(id: number): void;
+    /** Promise 封装的延迟 — await this.Delay(1000) */
+    protected Delay(ms: number): Promise<void>;
+    /**
+     * 防抖 — 返回一个防抖后的函数。
+     * 连续调用只会在最后一次调用的 delay 毫秒后执行一次。
+     * 组件卸载时自动取消 pending 中的调用。
+     */
+    protected Debounce<T extends (...args: any[]) => void>(fn: T, delay: number): T;
+    /**
+     * 节流 — 返回一个节流后的函数。
+     * 在 delay 毫秒内最多执行一次。
+     * 组件卸载时自动取消 pending 中的调用。
+     */
+    protected Throttle<T extends (...args: any[]) => void>(fn: T, delay: number): T;
+    /**
+     * requestAnimationFrame — 组件卸载时自动 cancelAnimationFrame
+     * @returns RAF 句柄 (可用于提前 CancelRAF)
+     */
+    protected AnimationFrame(fn: FrameRequestCallback): number;
+    /** 取消动画帧 */
+    protected CancelRAF(id: number): void;
+    /** 等待下一帧 — await this.NextFrame() */
+    protected NextFrame(): Promise<number>;
+    /**
+     * addEventListener — 组件卸载时自动 removeEventListener。
+     * 适用于 window / document / 任意 DOM 元素 / WebSocket 等 EventTarget。
+     */
+    protected Listen(target: EventTarget, type: string, handler: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+    /** querySelector 快捷方式 */
+    protected Query<E extends Element = Element>(selector: string): E | null;
+    /** querySelectorAll 快捷方式 */
+    protected QueryAll<E extends Element = Element>(selector: string): NodeListOf<E>;
+    /** 复制文本到剪贴板，返回是否成功 */
+    protected Copy(text: string): Promise<boolean>;
+    /** 读取剪贴板文本 */
+    protected ReadClipboard(): Promise<string>;
+    /** 部分更新组件状态 (等同于 setState 的类型安全封装) */
+    protected SetPanelState(state: Partial<Props>): void;
+    /** 获取当前状态 */
+    protected GetPanelState(): Readonly<Props>;
+    /** HTTP GET 请求，自动解析 JSON */
+    protected HttpGet<T = any>(url: string, params?: Record<string, string>): Promise<T>;
+    /** HTTP POST 请求，自动解析 JSON */
+    protected HttpPost<T = any>(url: string, body?: any, params?: Record<string, string>): Promise<T>;
+    /** 本地存储 (LocalStorage) */
+    protected get Storage(): import("../utility").BrowserUtility.LocalStorage;
+    /** 全局数据池 (跨组件共享) */
+    protected get GlobalData(): import("../utility").ObjectUtility.MapPool<object>;
+    /** Cookie 操作 */
+    protected get Cookie(): import("../utility").BrowserUtility.BrowserCookie;
+    /** 全局事件系统 */
+    protected get EventBus(): import("../utility").ObjectUtility.EventSystem;
 }
 /** 抽象属性接口 */
 export declare abstract class AbstractPanelProps implements AbstractObjectProps {

package/frame/core/Knight.d.ts

@@ -1,6 +1,6 @@
 import { BrowserUtility, InputUtility, NetworkUtility, ObjectUtility } from '../utility';
 import { AbstractObject } from '../base';
-import { Navgation } from '.';
+import { Navgation } from './Navgation';
 export declare class Knight {
     /** 全局单例 */
     private static instance;

package/frame/core/Navgation.d.ts

@@ -1,13 +1,44 @@
+import React from "react";
 import { AbstractObject } from "../base";
 import { InterfaceUtility } from "../utility";
 /** 导航工具 */
 export declare class Navgation {
-    /** 导航配置池 */
+    /** 导航配置池（平铺存储所有路由） */
     private static navgations;
-    /** 注册导航
-     * @param option 导航配置
+    /**
+     * 嵌套路由出口组件。在父组件的 OnRender 中放置 <Navgation.Outlet />，
+     * 子路由匹配的组件将渲染在此处。
+     * @example
+     * protected OnRender(props): React.ReactElement {
+     *     return <div>
+     *         <h1>Admin Layout</h1>
+     *         <Navgation.Outlet />
+     *     </div>;
+     * }
+     */
+    static Outlet: React.FC;
+    /** 注册导航（装饰器）
+     * @param path 路由路径，格式: /main/login
+     * @param authority 是否启用鉴权
      */
     static OnRegist(path: string, authority?: boolean): Function;
+    /** 为已注册的父路由添加子路由
+     * @param parentPath 父路由的完整路径 (如 "/admin")
+     * @param children 子路由配置数组，path 为相对路径 (如 "users", "users/:id")
+     * @example
+     * Navgation.OnRegistChildren("/admin", [
+     *     { path: "users",    authority: false, type: AdminUsers },
+     *     { path: "users/:id", authority: false, type: UserDetail },
+     *     { path: "settings", authority: false, type: AdminSettings },
+     * ]);
+     */
+    static OnRegistChildren(parentPath: string, children: NavgationOption[]): void;
+    /** 创建路由配置（工厂方法，用于 OnRegistChildren 的 children 数组）
+     * @param path 相对路径 (如 "users/:id")
+     * @param type 组件类型
+     * @param authority 鉴权开关
+     */
+    static OnRoute(path: string, type: InterfaceUtility.IType<AbstractObject>, authority?: boolean): NavgationOption;
     /** 根容器 */
     private htmlRoot;
     /** 渲染器 */
@@ -20,13 +51,29 @@ export declare class Navgation {
     private OnGetDefaultOption;
     /** 设置鉴权函数 */
     OnSetAuthority(authorityFunction: () => Promise<boolean>): void;
-    /** 导航变更 */
+    /** 导航变更（读取当前 URL 并渲染，不操作浏览器历史） */
     private OnChange;
+    /**
+     * 从 URL 路径解析出嵌套路由链
+     * 例如 /admin/users/123 → [AdminLayout, UsersList, UserDetail]
+     */
+    private ResolveRouteChain;
+    /** 在子路由数组中匹配路径段 */
+    private MatchChildRoute;
+    /**
+     * 将路由链构建为嵌套的 React 组件树。
+     * 每一层组件被独立的 OutletContext.Provider 包裹，叶节点的 Outlet 读到 null。
+     *
+     * 例: [AdminLayout, AdminUsers, UserDetail1] 构建为:
+     *   Provider(value=Provider(value=Provider(value=null, UserDetail1), AdminUsers))
+     *     └─ AdminLayout → Outlet → 上一级 Provider → AdminUsers → Outlet → UserDetail1 → Outlet=null
+     */
+    private BuildNestedTree;
     /** 性能分析 */
     private OnProfilerRender;
     /** 整合路由 */
     private OnConcat;
-    /** 导航 */
+    /** 导航（程序化跳转 — 推入浏览器历史记录并渲染） */
     OnNavigate(pathName: string, search?: string): void;
     /** 前进 */
     OnForward(): void;
@@ -61,4 +108,8 @@ export interface NavgationOption {
     authority: boolean;
     /** 组件类型 */
     type?: InterfaceUtility.IType<AbstractObject>;
+    /** 子路由（相对路径，仅需最后的路径段） */
+    children?: NavgationOption[];
+    /** 路由参数（内部使用，匹配 :param 时填充） */
+    params?: Record<string, string>;
 }

package/frame/utility/ConfigUtility.d.ts

@@ -17,7 +17,11 @@ export declare namespace ConfigUtility {
         /** 时间戳 */
         timeStamp?: number;
     }
-    /** 配置类 */
+    /**
+     * 配置类
+     * 注意: 此License校验仅为客户端层面的版权声明输出，不提供真实的安全保护。
+     * 加密密钥和校验逻辑均存在于客户端代码中，无法防止逆向破解。
+     */
     class Config {
         /** 私钥 */
         private privateKey;

package/frame/utility/CryptoUtility.d.ts

@@ -15,7 +15,7 @@ export declare namespace CryptoUtility {
          * @param _cipherText
          * @param _key
          */
-        static CheckToken(_cipherText: string, _key?: string): ICheckResult;
+        static CheckToken(_cipherText: string, _key: string): ICheckResult;
         /**
          * 解析Base64URL
          * @param _message

package/frame/utility/MathUtility.d.ts

@@ -451,7 +451,6 @@ export declare namespace MathUtility {
         private _x;
         private _y;
         private _z;
-        private _isDirty;
         get x(): number;
         set x(value: number);
         get y(): number;

package/frame/utility/NetworkUtility.d.ts

@@ -9,7 +9,7 @@ export declare namespace NetworkUtility {
         /** WebSocket网络协议 */
         private _webSokcet;
         /** WebSocket网络协议 */
-        get WebSokcet(): WebSocketNetWork;
+        get WebSocket(): WebSocketNetWork;
         /** 构造函数 */
         constructor();
     }
@@ -43,8 +43,8 @@ export declare namespace NetworkUtility {
         private _heartbeatResponseCounter;
         /** 心跳超时次数 */
         private _heartbeatTimeoutCount;
-        /** 心跳开关 */
-        private _heartbeatSwitch;
+        /** 心跳定时器 */
+        private _heartbeatTimer;
         /** 打开回调事件 */
         Evt_OnOpen: (_ws: WebSocketNetWork, _event?: Event) => void;
         /** 关闭回调事件 */
@@ -63,8 +63,6 @@ export declare namespace NetworkUtility {
         OnDisConnect(): void;
         /** 启动心跳 */
         private OnStartHeartbeat;
-        /** 心跳逻辑 */
-        private OnHeartbeat;
         /** 客户端打开连接 */
         private OnOpen;
         /** 客户端断开连接 */

package/frame/utility/ObjectUtility.d.ts

@@ -166,7 +166,7 @@ export declare namespace ObjectUtility {
         /** 注册事件 */
         Register(_pipeline: ((_params: T) => Promise<T>) | PipeLine<T>): boolean;
         /** 注销事件 */
-        Degister(_pipeline: ((_params: T) => Promise<T>) | PipeLine<T>): boolean;
+        Deregister(_pipeline: ((_params: T) => Promise<T>) | PipeLine<T>): boolean;
         /** 启动事件 */
         Start(_params: T): Promise<T>;
         /** 停止事件 */
@@ -177,7 +177,7 @@ export declare namespace ObjectUtility {
         /** 注册 */
         Register(_key: string, _callback: InterfaceUtility.IEvent, _target: any, _times: number): boolean;
         /** 注销 */
-        Degister(_key: string, _callback: InterfaceUtility.IEvent, _target: any): boolean;
+        Deregister(_key: string, _callback: InterfaceUtility.IEvent, _target: any): boolean;
         /** 通知 */
         Invoke(_key: string, ...params: Array<any>): Promise<void>;
         /** 清除 */
@@ -203,7 +203,7 @@ export declare namespace ObjectUtility {
         * @param _event 回调函数
         * @param _target 绑定对象
         */
-        Degister(_key: string, _event: InterfaceUtility.IEvent): boolean;
+        Deregister(_key: string, _event: InterfaceUtility.IEvent): boolean;
         /**
         * 派发监听事件
         * @param _key 事件名称
@@ -233,7 +233,7 @@ export declare namespace ObjectUtility {
         * @param _target 绑定对象
         * @param _event 回调函数
         */
-        Degister(_key: string, _event: InterfaceUtility.IEvent, _target: any): boolean;
+        Deregister(_key: string, _event: InterfaceUtility.IEvent, _target: any): boolean;
         /**
         * 派发监听事件
         * @param _key 事件名称