knight-web 2.0.3 → 2.0.5

package/frame/base/AbstractObject.d.ts

@@ -0,0 +1,36 @@
+import React from "react";
+import { Knight } from "../core";
+/** 抽象对象基类 */
+export declare abstract class AbstractObject<Props extends AbstractObjectProps = AbstractObjectProps> extends React.Component<Props, Props> {
+    /** 组件ID */
+    protected id: string;
+    /** Knight实例 */
+    protected get knight(): Knight;
+    /** 构造函数 */
+    constructor(props: Props);
+    /** 组件挂载 */
+    componentDidMount(): void;
+    /** 组件刷新 */
+    componentDidUpdate(prevProps: Readonly<Props>, prevState: Readonly<Props>, snapshot?: any): void;
+    /** 组件是否应该刷新 */
+    shouldComponentUpdate(nextProps: Readonly<Props>, nextState?: Readonly<Props>, nextContext?: any): boolean;
+    /** 组件卸载 */
+    componentWillUnmount(): void;
+    /** 组件捕获 */
+    componentDidCatch(error: any, errorInfo: any): boolean;
+    /** 组件渲染 */
+    render(): React.ReactElement;
+    /** 加载 */
+    protected abstract OnLoad(): void;
+    /** 卸载 */
+    protected abstract OnDestroy(): void;
+    /** 刷新 */
+    protected abstract OnUpdate(prevProps: Readonly<Props>, prevState: Readonly<Props>): void;
+    /** 提交渲染 */
+    protected abstract OnRender(): React.ReactElement;
+}
+/** 抽象属性接口 */
+export declare abstract class AbstractObjectProps implements React.HTMLAttributes<HTMLDivElement>, React.ClassAttributes<HTMLDivElement> {
+    /** 自定义属性 */
+    [key: string]: any;
+}

package/frame/base/AbstractPanel.d.ts

@@ -0,0 +1,4 @@
+import { AbstractObject } from "./AbstractObject";
+/** 抽象界面基类 */
+export declare abstract class AbstractPanel extends AbstractObject {
+}

package/frame/base/index.d.ts

@@ -0,0 +1,2 @@
+export * from './AbstractObject';
+export * from './AbstractPanel';

package/frame/core/Knight.d.ts

@@ -0,0 +1,42 @@
+import { BrowserUtility, InputUtility, NetworkUtility, ObjectUtility } from '../utility';
+import { AbstractObject } from '../base';
+export declare class Knight {
+    /** 全局单例 */
+    private static instance;
+    static get Instance(): Knight;
+    /** 根容器 */
+    private htmlRoot;
+    /** 渲染器 */
+    private renderer;
+    /** 配置 */
+    private config;
+    /** 全局对象池 */
+    get Objects(): ObjectUtility.MapPool<AbstractObject>;
+    private _objects;
+    /** 全局事件系统 */
+    get Event(): ObjectUtility.EventSystem;
+    private _event;
+    /** 路由历史数据 */
+    get History(): BrowserUtility.BrowserHistory;
+    private _history;
+    /** 本地路由数据 */
+    get Location(): BrowserUtility.BrowserLocation;
+    private _location;
+    /** 本地缓存数据 */
+    get Storage(): BrowserUtility.LocalStorage;
+    private _storage;
+    /** 本地Cookie数据 */
+    get Cookie(): BrowserUtility.BrowserCookie;
+    private _cookie;
+    /** 全局数据 */
+    get GlobalData(): ObjectUtility.MapPool<object>;
+    private _globalData;
+    /** 网络接口 */
+    get NetWork(): NetworkUtility.NetWork;
+    private _network;
+    /** 输入接口 */
+    get Input(): InputUtility.Input;
+    private _input;
+    /** 构造函数 */
+    private constructor();
+}

package/frame/core/Navgation.d.ts

@@ -0,0 +1,26 @@
+import React from "react";
+import { AbstractObject } from "../base";
+import { InterfaceUtility } from "../utility";
+/** 导航工具 */
+export declare class Navgation {
+    /** 导航配置池 */
+    private static navgations;
+    /** 注册导航
+     * @param option 导航配置
+     */
+    static OnRegist(option: NavgationOption): Function;
+    /** 构建路由 */
+    static OnRender(): React.ReactElement;
+}
+/** 导航配置 */
+export interface NavgationOption {
+    /** 路径
+     *  格式:aaa/bbb/ccc
+     */
+    path?: string;
+}
+/** 导航配置 */
+export interface NavgationConfig extends NavgationOption {
+    /** 组件元素 */
+    type: InterfaceUtility.IType<AbstractObject>;
+}

package/frame/core/index.d.ts

@@ -1 +1,2 @@
-export * from './Core';
+export * from './Knight';
+export * from './Navgation';

package/frame/index.d.ts

@@ -1,2 +1,3 @@
-export * from './Main';
+export * as Base from './base';
 export * as Core from './core';
+export * as Utility from "./utility";

package/frame/utility/BrowserUtility.d.ts

@@ -0,0 +1,320 @@
+import PathToRegexp from "path-to-regexp";
+/** 浏览器工具 */
+export declare namespace BrowserUtility {
+    /** 标记 */
+    export const _mark: string;
+    /**
+    * 加载远端脚本
+    * @param _srcPath 远程脚本路径
+    * @param _name 所需返回的类实例名称
+    * @returns 加载脚本的实例
+    */
+    export function LoadScript<T extends object>(_srcPath: string, _name: string): Promise<T>;
+    /** 创建HTML元素 */
+    export function CreatHTMLElement(_type: string, _id: string, _name: string, _position: "relative" | "absolute", _activePointer?: boolean, _showMark?: boolean, _parent?: HTMLElement): HTMLElement;
+    /** 剪切板管理 */
+    export class Clipboard {
+        /** 读取剪切板 */
+        static read(): Promise<ClipboardItems>;
+        /** 读取剪切板文本 */
+        static readText(): Promise<string>;
+        /** 写入剪切板 */
+        static write(data: ClipboardItems): Promise<void>;
+        /** 写入剪切板文本 */
+        static writeText(data: string): Promise<void>;
+    }
+    /** 本地化接口 */
+    export interface ILocation extends Location {
+        /** 协议(exp:http) */
+        protocol: string;
+        /** 超链接(http://全路由地址) */
+        href: string;
+        /** 原始链接(http://IP:Port地址) */
+        readonly origin: string;
+        /** 主机地址(IP:Port地址) */
+        host: string;
+        /** 主机名(IP) */
+        hostname: string;
+        /** 端口号(Port) */
+        port: string;
+        /** 路径名(/aaa/bbb不包含参数) */
+        pathname: string;
+        /** 搜索参数(路由参数) */
+        search: string;
+        /** 哈希地址 */
+        hash: string;
+        /** 导航到URL */
+        assign(url: string | URL): void;
+        /** 重新加载当前页面 */
+        reload(): void;
+        /** 从会话历史中删除当前页面并导航到给定的URL */
+        replace(url: string | URL): void;
+    }
+    /** 历史接口 */
+    export interface IHistory extends History {
+        /** 长度 */
+        readonly length: number;
+        /** 滚动恢复 */
+        scrollRestoration: ScrollRestoration;
+        /** 状态 */
+        readonly state: any;
+        /** 返回函数 */
+        back(): void;
+        /** 前进函数 */
+        forward(): void;
+        /** 进入函数 */
+        go(delta?: number): void;
+        /** 设置状态 */
+        pushState(_state: any, _title: string, _url?: string | URL | null): void;
+        /** 替换状态 */
+        replaceState(_state: any, _title: string, _url?: string | URL | null): void;
+    }
+    /** 路由Search参数 */
+    export interface ISearchParams {
+        key: string;
+        value: string;
+    }
+    /** 历史事件池 */
+    export class HistoryEventsPool {
+        /** 处理函数 */
+        private _handlers;
+        constructor();
+        Push(_fn: Function): Function;
+        Call(_location: Location): void;
+    }
+    /** 历史记录刷新模式 */
+    export enum E_HistoryUpdateType {
+        /** 只要路由变更刷新 */
+        All = 0,
+        /** PathName变更刷新 */
+        PathName = 1,
+        /** PathName|Search变更刷新 */
+        PathNameOrSearch = 2,
+        /** PathName|Hash变更刷新 */
+        PathNameOrHash = 3
+    }
+    /** 浏览器历史记录设置 */
+    export class BrowserHistory {
+        /** 监听事件池 */
+        private _listeners;
+        /** 历史记录刷新模式 */
+        HistoryUpdateType: E_HistoryUpdateType;
+        /** 记录上一个路径 */
+        private _recordPath;
+        /** 构造函数 */
+        constructor();
+        /** 监听路由变化 */
+        Listen(_listener: Function): Function;
+        /** 刷新当前路由 */
+        Update(): void;
+        /** 前进 */
+        Forward(): void;
+        /** 后退 */
+        Back(): void;
+        /** 执行 */
+        Go(_delta?: number): void;
+        /**
+         * 设置路由
+         * @param _url 设置路由路径(注意:路径前+‘/’)
+         * @param _searchParams 路径透传参数(key:value数组形式)
+         * @returns 是否设置成功
+         */
+        SetState(_url: string, _searchParams?: Array<{
+            key: string;
+            value: any;
+        }>): boolean;
+        /** 路由鉴权 */
+        CheckAuthorityValid(_url: string, _authentications: Array<string>): boolean;
+        /**
+         * 设置路由并刷新
+         * @param _url 设置路由路径(注意:路径前+‘/’)
+         * @param _keepAlive 是否路径持久储存
+         * @param _searchParams 路径透传参数(key:value数组形式)
+         * @returns 是否设置并刷新成功
+         */
+        SetStateUpdate(_url: string, _searchParams?: Array<{
+            key: string;
+            value: any;
+        }>): boolean;
+        /** 获取当前路由路径名 */
+        GetCurPathName(): string;
+        /** 获取路由中的参数值 */
+        Search<T extends object = object>(): T;
+    }
+    /** 浏览器本地设置 */
+    export class BrowserLocation {
+        /** 本地记录 */
+        private _location;
+        /** 构造函数 */
+        constructor();
+        /** 整合路由 */
+        private concat;
+        /** 打开新窗口 */
+        open(_url?: string | URL, target?: string, features?: string): boolean;
+        /** 导航到URL */
+        assign(_url: string, ..._params: Array<ISearchParams>): void;
+        /** 重新加载当前页面 */
+        reload(): void;
+        /** 从会话历史中删除当前页面并导航到给定的URL */
+        replace(_url: string, ..._params: Array<ISearchParams>): void;
+    }
+    /** 路径参数接口 */
+    export interface IPathOptions {
+        /** 路径 */
+        path?: string | any[];
+        exact?: boolean;
+        strict?: boolean;
+        sensitive?: boolean;
+        end?: boolean;
+    }
+    /** 路径管理 */
+    export class PathHandle {
+        /** 路径缓存 */
+        private _cache;
+        /** 缓存限制 */
+        private _cacheLimit;
+        /** 缓存数量 */
+        private _cacheCount;
+        /** 构造函数 */
+        constructor();
+        /** 编译路径 */
+        CompilePath(_path: string, _options: IPathOptions): {
+            regexp: RegExp;
+            keys: PathToRegexp.Keys;
+        };
+        /** 匹配路径(将URL路径名与路径匹配) */
+        MatchPath(_pathname: string, _options?: IPathOptions): string | any[] | {
+            path: string;
+            url: string;
+            isExact: boolean;
+            params: {};
+        };
+    }
+    /** 浏览器Cookie缓存 */
+    export class BrowserCookie {
+        /** 设置Cookie */
+        SetCookie(_key: string, _value: string | number, _keepDays?: number): void;
+        /** 获取Cookie */
+        GetCookie(_key: string): string;
+        /** 清除Cookie */
+        RemoveCookie(_key: string): void;
+        /** 清除所有Cookie */
+        RemoveAllCookie(): void;
+    }
+    /** 本地缓存数据 */
+    export class LocalStorage {
+        private _key;
+        /** 缓存数据 */
+        protected _handle: ILocalStorageData;
+        /** 构造函数 */
+        constructor();
+        /** 设置数据 */
+        Set(_key: string, _value: any): void;
+        /** 获取数据 */
+        Get<T extends any = any>(_key: string): T;
+        /** 移除数据 */
+        Remove(_key: string): boolean;
+        /** 数据是否在存在 */
+        Exist(_key: string): boolean;
+        /** 移除所有数据 */
+        RemoveAll(): void;
+    }
+    /** 本地缓存数据接口 */
+    interface ILocalStorageData {
+        [key: string]: any;
+    }
+    /** WebGL类
+     * @params 着色器
+       着色器是使用 OpenGL ES 着色语言(GLSL) 编写的程序，它携带着绘制形状的顶点信息以及构造绘制在屏幕上像素的所需数据，换句话说，它负责记录着像素点的位置和颜色。
+       绘制 WebGL 时候有两种不同的着色器函数，顶点着色器和片段着色器。你需要通过用 GLSL 编写这些着色器，并将代码文本传递给 WebGL，使之在 GPU 执行时编译。顺便一提，顶点着色器和片段着色器的集合我们通常称之为着色器程序。
+     * @params 顶点着色器
+       每次渲染一个形状时，顶点着色器会在形状中的每个顶点运行。它的工作是将输入顶点从原始坐标系转换到 WebGL 使用的裁剪空间坐标系，其中每个轴的坐标范围从 -1.0 到 1.0，并且不考虑纵横比，实际尺寸或任何其他因素。
+       顶点着色器需要对顶点坐标进行必要的转换，在每个顶点基础上进行其他调整或计算，然后通过将其保存在由 GLSL 提供的特殊变量（我们称为 gl_Position）中来返回变换后的顶点
+       顶点着色器根据需要，也可以完成其他工作。例如，决定哪个包含 texel 面部纹理的坐标，可以应用于顶点；通过法线来确定应用到顶点的光照因子等。然后将这些信息存储在变量（varyings)或属性 (attributes)属性中，以便与片段着色器共享
+     * @params 片段着色器
+       片段着色器在顶点着色器处理完图形的顶点后，会被要绘制的每个图形的每个像素点调用一次。它的职责是确定像素的颜色，通过指定应用到像素的纹理元素（也就是图形纹理中的像素），获取纹理元素的颜色，然后将适当的光照应用于颜色。之后颜色存储在特殊变量 gl_FragColor 中，返回到 WebGL 层。该颜色将最终绘制到屏幕上图形对应像素的对应位置。
+     */
+    export class WebGLUtility {
+        /** WebGL检测 */
+        static Check(): void;
+        /** 是否支持WebGL */
+        static OnWebGLSupported(): boolean;
+        /** 是否支持WebGL2 */
+        static OnWebGL2Supported(): boolean;
+        /**
+         * 创建着色器
+         * @param _context 渲染上下文
+         * @param _type 着色器类型
+         * @param _source 着色器资源
+         * @returns WebGL着色器
+         */
+        static OnCreatShader(_context: WebGLRenderingContext, _type: number, _source: string): WebGLShader | null;
+        /**
+         * 创建程序
+         * @param _context 渲染上下文
+         * @param _vertexShader 顶点着色器
+         * @param _fragShader 片元着色器
+         * @returns 程序实例
+         */
+        static OnCreatProgram(_context: WebGLRenderingContext, _vertexShader: string, _fragShader: string): WebGLProgram | null;
+        /**
+         * 创建程序
+         * @param _context 渲染上下文
+         * @param _vertexShader 顶点着色器
+         * @param _fragShader 片元着色器
+         * @returns 程序实例
+         */
+        static OnCreatProgramAndUse(_context: WebGLRenderingContext, _vertexShader: string, _fragShader: string): WebGLProgram | null;
+        /** 创建数组缓冲区并绑定数据 */
+        static OnCreatArrayBufferAndBind(_context: WebGLRenderingContext, _data: ArrayBufferLike | null): WebGLBuffer | null;
+        /** 创建元素数组缓冲区并绑定数据 */
+        static OnCreatElementArrayBufferAndBind(_context: WebGLRenderingContext, _data: ArrayBufferLike | null): WebGLBuffer | null;
+    }
+    /** WebGL类 */
+    export class WebGL {
+        /** 渲染目标 */
+        private _context;
+        /** 程序实例 */
+        private _program;
+        constructor(_context: WebGLRenderingContext, _vertexShader: string, _fragShader: string);
+        /** 创建数组缓存区并绑定 */
+        OnCreatArrayBufferAndBind(_source: ArrayBufferLike | null): WebGLBuffer;
+        /** 创建元素数组缓存区并绑定 */
+        OnCreatElementArrayBufferAndBind(_source: ArrayBufferLike | null): WebGLBuffer;
+        /** 获取属性字段引用 */
+        OnGetAttribLocation(_name: string): GLint;
+        /** 属性字段绑定缓存并启用 */
+        OnVertexAttribPointerAndEnable(_index: GLint, _size: GLint, _type: E_VariableType, _normalized: GLboolean, _stride: GLsizei, _offset: GLintptr): void;
+        /** 获取属性字段并分配缓存区 */
+        OnGetAttributeAndBindBuffer(_name: string, _size: GLint, _type: E_VariableType, _normalized: GLboolean, _stride: GLsizei, _offset: GLintptr): GLint;
+        /** 获取Uniform矩阵 */
+        OnGetUniformLocation(_name: string): WebGLUniformLocation | null;
+        /** Uniform矩阵变换4fv */
+        OnUniformMatrix4fv(_location: WebGLUniformLocation | null, _transpose: GLboolean, _value: Float32List): void;
+        /** 渲染数组 */
+        OnDrawArray(_renderType: E_RenderType): boolean;
+        /** 渲染元素 */
+        OnDrawElements(_renderType: E_RenderType, _count: GLsizei, _type: E_VariableType, _offset: GLintptr): boolean;
+    }
+    /** 渲染类型 */
+    export enum E_RenderType {
+        POINTS = 0,
+        LINES = 1,
+        LINE_LOOP = 2,
+        LINE_STRIP = 3,
+        TRIANGLES = 4,
+        TRIANGLE_STRIP = 5,
+        TRIANGLE_FAN = 6
+    }
+    /** 变量类型 */
+    export enum E_VariableType {
+        BYTE = 5120,
+        UNSIGNED_BYTE = 5121,
+        SHORT = 5122,
+        UNSIGNED_SHORT = 5123,
+        INT = 5124,
+        UNSIGNED_INT = 5125,
+        FLOAT = 5126
+    }
+    export {};
+}

package/frame/utility/ConfigUtility.d.ts

@@ -0,0 +1,33 @@
+/** 配置工具 */
+export declare namespace ConfigUtility {
+    /** 配置数据接口 */
+    interface IConfig {
+        /** 主体名称 */
+        name?: string;
+        /** 主体网址 */
+        website?: string;
+        /** 版本号 */
+        version?: string;
+        /** 账号 */
+        account?: string;
+        /** 密码 */
+        password?: string;
+        /** 调试模式 */
+        debugMode?: boolean;
+        /** 时间戳 */
+        timeStamp?: number;
+    }
+    /** 配置类 */
+    class Config {
+        /** 私钥 */
+        private privateKey;
+        /** 配置数据 */
+        private configData;
+        /** 创建配置 */
+        OnCreatToken(config: IConfig): string;
+        /** 获取配置 */
+        OnGetConfig(token: string): IConfig;
+        /** 检测配置 */
+        OnMatch(token: string): boolean;
+    }
+}