@ibiz-template/core 0.0.1-beta.1 → 0.0.2-beta.0

package/src/command/command.ts

@@ -0,0 +1,79 @@
+import { ICommandHandler, ICommandOption, IDisposable } from './interface';
+import { CommandsRegistry } from './command-register';
+
+/**
+ * 指令控制器
+ *
+ * @author chitanda
+ * @date 2022-06-28 19:06:51
+ * @export
+ * @class CommandController
+ */
+export class CommandController {
+  private commandRegister = new CommandsRegistry();
+
+  /**
+   * 注册指令
+   *
+   * @author chitanda
+   * @date 2022-06-28 19:06:45
+   * @param {string} id
+   * @param {ICommandHandler} handler
+   * @param {ICommandOption} [opts]
+   * @return {*}  {IDisposable}
+   */
+  register(
+    id: string,
+    handler: ICommandHandler,
+    opts?: ICommandOption,
+  ): IDisposable {
+    return this.commandRegister.registerCommand(id, handler, opts);
+  }
+
+  /**
+   * 执行指令
+   *
+   * @author chitanda
+   * @date 2022-06-28 19:06:38
+   * @template T
+   * @param {string} id
+   * @param {...unknown[]} args
+   * @return {*}  {Promise<T>}
+   */
+  async execute<T = undefined>(id: string, ...args: unknown[]): Promise<T> {
+    const command = this.commandRegister.getCommand(id);
+    if (command) {
+      return command.handler(...args) as T | Promise<T>;
+    }
+    throw new Error(`未注册指令: ${id}，请先注册指令`);
+  }
+
+  /**
+   * 判断指令是否存在，可直接抛出异常
+   *
+   * @author chitanda
+   * @date 2022-06-28 19:06:11
+   * @param {string} id
+   * @param {boolean} [err]
+   * @return {*}  {boolean}
+   */
+  hasCommand(id: string, err?: boolean): boolean {
+    const bol = !!this.commandRegister.hasCommand(id);
+    if (err === true && bol === true) {
+      throw new Error(`未注册指令: ${id}，请先注册指令`);
+    }
+    return bol;
+  }
+
+  /**
+   * 获取指令配置参数
+   *
+   * @author chitanda
+   * @date 2022-07-21 17:07:11
+   * @param {string} id
+   * @return {*}  {(ICommandOption | undefined)}
+   */
+  getCommandOpts(id: string): ICommandOption | undefined {
+    return this.commandRegister.getCommandOpt(id);
+  }
+}

package/src/command/index.ts

@@ -0,0 +1,11 @@
+import { CommandController } from './command';
+
+export * from './interface';
+export * from './utils';
+export { CommandsRegistry } from './command-register';
+export { CommandController } from './command';
+
+/**
+ * 命令控制器
+ */
+export const commands = new CommandController();

package/src/command/interface/command/command-option.ts

@@ -0,0 +1,22 @@
+/**
+ * 指令参数, 主要用于在指令呈现时的展示参数
+ *
+ * @author chitanda
+ * @date 2022-06-28 17:06:47
+ * @export
+ * @interface ICommandOption
+ */
+export interface ICommandOption {
+  readonly id: string;
+  readonly title: string;
+  readonly tooltip?: string;
+  readonly description?: string;
+  /**
+   * 只支持 svg 图标
+   *
+   * @author chitanda
+   * @date 2022-06-29 14:06:42
+   * @type {string}
+   */
+  readonly icon?: string;
+}

package/src/command/interface/command/command.ts

@@ -0,0 +1,86 @@
+/* eslint-disable @typescript-eslint/no-explicit-any */
+import { IDisposable } from '../disposable/disposable';
+import { ICommandOption } from './command-option';
+
+/**
+ * 注册指令
+ *
+ * @author chitanda
+ * @date 2022-06-27 13:06:25
+ * @export
+ * @interface ICommand
+ */
+export interface ICommand {
+  id: string;
+  handler: ICommandHandler;
+  opts?: ICommandOption;
+}
+
+/**
+ * 触发指令声明
+ *
+ * @author chitanda
+ * @date 2022-06-28 17:06:10
+ * @export
+ * @interface Command
+ */
+export interface Command {
+  /**
+   * Title of the command, like `save`.
+   */
+  title: string;
+
+  /**
+   * The identifier of the actual command handler.
+   * @see {@link commands.registerCommand}
+   */
+  command: string;
+
+  /**
+   * A tooltip for the command, when represented in the UI.
+   */
+  tooltip?: string;
+
+  /**
+   * Arguments that the command handler should be
+   * invoked with.
+   */
+  arguments?: any[];
+}
+
+/**
+ * 指令处理回调
+ *
+ * @author chitanda
+ * @date 2022-06-27 13:06:33
+ * @export
+ * @interface ICommandHandler
+ */
+export interface ICommandHandler {
+  (...args: any[]): unknown | Promise<unknown>;
+}
+
+/**
+ * 指令控制器集
+ */
+export type ICommandsMap = Map<string, ICommand>;
+
+/**
+ * 注册服务
+ *
+ * @author chitanda
+ * @date 2022-06-27 13:06:16
+ * @export
+ * @interface ICommandRegistry
+ */
+export interface ICommandRegistry {
+  registerCommand(
+    id: string,
+    command: ICommandHandler,
+    opts: ICommandOption,
+  ): IDisposable;
+  registerCommand(id: string, command: ICommandHandler): IDisposable;
+  registerCommand(command: ICommand): IDisposable;
+  getCommand(id: string): ICommand | undefined;
+  getCommands(): ICommandsMap;
+}

package/src/command/interface/disposable/disposable.ts

@@ -0,0 +1,3 @@
+export interface IDisposable {
+  dispose(): void;
+}

package/src/command/interface/index.ts

@@ -0,0 +1,9 @@
+export {
+  ICommand,
+  Command,
+  ICommandHandler,
+  ICommandsMap,
+  ICommandRegistry,
+} from './command/command';
+export { ICommandOption } from './command/command-option';
+export { IDisposable } from './disposable/disposable';

package/src/command/utils/index.ts

@@ -0,0 +1,2 @@
+export { LinkedList } from './linked-list';
+export { toDisposable, debounce, throttle } from './util';

package/src/command/utils/linked-list.ts

@@ -0,0 +1,136 @@
+/* eslint-disable @typescript-eslint/no-non-null-assertion */
+/* eslint-disable no-underscore-dangle */
+/* eslint-disable max-classes-per-file */
+class Node<E> {
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  static readonly Undefined = new Node<any>(undefined);
+
+  element: E;
+
+  next: Node<E>;
+
+  prev: Node<E>;
+
+  constructor(element: E) {
+    this.element = element;
+    this.next = Node.Undefined;
+    this.prev = Node.Undefined;
+  }
+}
+
+export class LinkedList<E> {
+  private _first: Node<E> = Node.Undefined;
+
+  private _last: Node<E> = Node.Undefined;
+
+  private _size: number = 0;
+
+  get size(): number {
+    return this._size;
+  }
+
+  isEmpty(): boolean {
+    return this._first === Node.Undefined;
+  }
+
+  clear(): void {
+    let node = this._first;
+    while (node !== Node.Undefined) {
+      const { next } = node;
+      node.prev = Node.Undefined;
+      node.next = Node.Undefined;
+      node = next;
+    }
+
+    this._first = Node.Undefined;
+    this._last = Node.Undefined;
+    this._size = 0;
+  }
+
+  unshift(element: E): () => void {
+    return this._insert(element, false);
+  }
+
+  push(element: E): () => void {
+    return this._insert(element, true);
+  }
+
+  private _insert(element: E, atTheEnd: boolean): () => void {
+    const newNode = new Node(element);
+    if (this._first === Node.Undefined) {
+      this._first = newNode;
+      this._last = newNode;
+    } else if (atTheEnd) {
+      // push
+      const oldLast = this._last!;
+      this._last = newNode;
+      newNode.prev = oldLast;
+      oldLast.next = newNode;
+    } else {
+      // unshift
+      const oldFirst = this._first;
+      this._first = newNode;
+      newNode.next = oldFirst;
+      oldFirst.prev = newNode;
+    }
+    this._size += 1;
+
+    let didRemove = false;
+    return () => {
+      if (!didRemove) {
+        didRemove = true;
+        this._remove(newNode);
+      }
+    };
+  }
+
+  shift(): E | undefined {
+    if (this._first === Node.Undefined) {
+      return undefined;
+    }
+    const res = this._first.element;
+    this._remove(this._first);
+    return res;
+  }
+
+  pop(): E | undefined {
+    if (this._last === Node.Undefined) {
+      return undefined;
+    }
+    const res = this._last.element;
+    this._remove(this._last);
+    return res;
+  }
+
+  private _remove(node: Node<E>): void {
+    if (node.prev !== Node.Undefined && node.next !== Node.Undefined) {
+      // middle
+      const anchor = node.prev;
+      anchor.next = node.next;
+      node.next.prev = anchor;
+    } else if (node.prev === Node.Undefined && node.next === Node.Undefined) {
+      // only node
+      this._first = Node.Undefined;
+      this._last = Node.Undefined;
+    } else if (node.next === Node.Undefined) {
+      // last
+      this._last = this._last!.prev!;
+      this._last.next = Node.Undefined;
+    } else if (node.prev === Node.Undefined) {
+      // first
+      this._first = this._first!.next!;
+      this._first.prev = Node.Undefined;
+    }
+
+    // done
+    this._size -= 1;
+  }
+
+  *[Symbol.iterator](): Iterator<E> {
+    let node = this._first;
+    while (node !== Node.Undefined) {
+      yield node.element;
+      node = node.next;
+    }
+  }
+}

package/src/command/utils/util.ts

@@ -0,0 +1,95 @@
+/* eslint-disable func-names */
+/* eslint-disable prefer-rest-params */
+/* eslint-disable no-underscore-dangle */
+import { IDisposable } from '../interface';
+
+// eslint-disable-next-line @typescript-eslint/ban-types
+export function once<T extends Function>(this: unknown, fn: T): T {
+  // eslint-disable-next-line @typescript-eslint/no-this-alias
+  const _this = this;
+  let didCall = false;
+  let result: unknown;
+
+  return function () {
+    if (didCall) {
+      return result;
+    }
+
+    didCall = true;
+    result = fn.apply(_this, arguments);
+
+    return result;
+  } as unknown as T;
+}
+
+export function toDisposable(fn: () => void): IDisposable {
+  const self = {
+    dispose: once(() => {
+      fn();
+    }),
+  };
+  return self;
+}
+
+/**
+ * 函数防抖---“立即执行版本” 和 “非立即执行版本” 的组合版本
+ *
+ * @author chitanda
+ * @date 2022-06-29 19:06:15
+ * @export
+ * @param {((...args: unknown[]) => void | Promise<void>)} func 处理函数
+ * @param {number} wait 延迟执行时间（毫秒）
+ * @param {boolean} [immediate] 是否立即执行
+ * @return {*}  {(...args: unknown[]) => void}
+ */
+export function debounce(
+  func: (...args: unknown[]) => void | Promise<void>,
+  wait: number,
+  immediate?: boolean,
+): (...args: unknown[]) => void {
+  let timer: unknown;
+
+  return function (this: unknown, ...args: unknown[]): void {
+    if (timer) {
+      clearTimeout(timer as number);
+    }
+    if (immediate) {
+      const callNow = !timer;
+      timer = setTimeout(() => {
+        timer = null;
+      }, wait);
+      if (callNow) {
+        func.apply(this, args);
+      }
+    } else {
+      timer = setTimeout(() => {
+        func.apply(this, args);
+      }, wait);
+    }
+  };
+}
+
+/**
+ * 节流函数
+ *
+ * @author chitanda
+ * @date 2022-06-29 20:06:38
+ * @export
+ * @param {((...args: unknown[]) => void | Promise<void>)} fn
+ * @param {number} wait
+ * @return {*}  {(...args: unknown[]) => void}
+ */
+export function throttle(
+  fn: (...args: unknown[]) => void | Promise<void>,
+  wait: number,
+): (...args: unknown[]) => void {
+  let timer: unknown = null;
+  return function (this: unknown, ...args: unknown[]): void {
+    if (!timer) {
+      timer = setTimeout(() => {
+        fn.apply(this, args);
+        timer = null;
+      }, wait);
+    }
+  };
+}

package/src/context/index.ts

@@ -10,8 +10,25 @@ export class IBizContext implements IContext {
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
   [key: string | symbol]: any;
 
+  /**
+   * 修改的父上下文
+   *
+   * @author lxm
+   * @date 2022-12-08 18:12:16
+   * @protected
+   * @type {IContext}
+   */
   protected _context!: IContext;
 
+  /**
+   * 父的上下文源对象
+   *
+   * @author lxm
+   * @date 2022-12-08 18:12:31
+   * @type {IBizContext}
+   */
+  declare _parent?: IBizContext;
+
   /**
    * Creates an instance of IBizContext.
    *
@@ -25,7 +42,13 @@ export class IBizContext implements IContext {
     if (parent) {
       // eslint-disable-next-line @typescript-eslint/no-this-alias
       const self = this;
-      // 定义私有变量，用于存储父已有上下文，方便覆盖
+      // 定义私有变量，存放父上下文源对象
+      Object.defineProperty(this, '_parent', {
+        enumerable: false,
+        value: parent,
+      });
+
+      // 定义私有变量，用于存储对父已有上下文的修改。
       Object.defineProperty(this, '_context', {
         enumerable: false,
         value: {},
@@ -56,4 +79,25 @@ export class IBizContext implements IContext {
     // 合并给入上下文
     Object.assign(this, context);
   }
+
+  /**
+   * 返回自身的上下文，独有的和与父有差异的。
+   *
+   * @author lxm
+   * @date 2022-12-08 17:12:26
+   * @returns {*}  {IContext}
+   */
+  getOwnContext(): IContext {
+    const result: IContext = {};
+    Object.keys(this).forEach(key => {
+      // 父没有的，或者修改了父的上下文
+      if (
+        !Object.prototype.hasOwnProperty.call(this._parent, key) ||
+        Object.prototype.hasOwnProperty.call(this._context, key)
+      ) {
+        result[key] = this[key];
+      }
+    });
+    return result;
+  }
 }

package/src/environment/environment.ts

@@ -6,9 +6,10 @@ import { IEnvironment } from '../interface';
  */
 export const Environment: IEnvironment = {
   dev: false,
+  hub: false,
   logLevel: 'ERROR',
-  jsCdn: 'https://cdn.jsdelivr.net',
   baseUrl: '',
+  appId: '',
   pluginBaseUrl: './plugins',
   remoteModelUrl: '/remotemodel',
   assetsUrl: './assets',

package/src/error/http-error/http-error.ts

@@ -1,5 +1,4 @@
 import { AxiosError, AxiosResponse } from 'axios';
-import { HttpStatusMessageConst } from '../../constant';
 
 /**
  * 请求异常
@@ -28,9 +27,6 @@ export class HttpError implements Error {
       } else {
         this.message = res.statusText;
       }
-      if (!this.message) {
-        this.message = HttpStatusMessageConst[res.status];
-      }
       if (!this.message) {
         this.message = '网络异常，请稍后重试!';
       }

package/src/ibizsys.ts

@@ -1,3 +1,4 @@
+import { CommandController } from './command';
 import { Environment } from './environment/environment';
 import { OrgData } from './interface';
 import { Logger, Net } from './utils';
@@ -36,6 +37,15 @@ export class IBizSys {
    */
   net: Net = new Net();
 
+  /**
+   * 指令集
+   *
+   * @author chitanda
+   * @date 2022-07-20 10:07:33
+   * @type {AuthService}
+   */
+  commands: CommandController = new CommandController();
+
   /**
    * sass 模式下的中心系统标识
    *

package/src/index.ts

@@ -1,5 +1,6 @@
 import './types';
 
+export * from './command';
 export * from './constant';
 export { IBizContext } from './context';
 export { Environment } from './environment/environment';

package/src/install.ts

@@ -1,6 +1,5 @@
 import { FactoryCenter } from './factory-center';
 import { IBizSys } from './ibizsys';
-import { CoreInterceptor } from './utils';
 
 /**
  * 初始化全局对象
@@ -15,5 +14,4 @@ export function install(): void {
   }
   window.ibiz = new IBizSys();
   window.___fc = new FactoryCenter();
-  ibiz.net.addInterceptor('CoreInterceptor', new CoreInterceptor());
 }

package/src/interface/i-environment/i-environment.ts

@@ -30,23 +30,31 @@ export interface IEnvironment {
   dev: boolean;
 
   /**
-   * 日志级别
+   * 是否为多应用 hub 基座模式
    *
    * @author chitanda
-   * @date 2022-10-25 20:10:55
-   * @type {LogLevelDesc}
+   * @date 2022-12-20 10:12:45
+   * @type {boolean}
    */
-  logLevel: LogLevelDesc;
+  hub: boolean;
 
   /**
-   * js 静态文件 cdn 地址
+   * 默认应用的应用标识
    *
-   * @default https://cdn.jsdelivr.net/
    * @author chitanda
-   * @date 2022-10-24 11:10:14
+   * @date 2022-12-22 15:12:35
    * @type {string}
    */
-  jsCdn: string;
+  appId: string;
+
+  /**
+   * 日志级别
+   *
+   * @author chitanda
+   * @date 2022-10-25 20:10:55
+   * @type {LogLevelDesc}
+   */
+  logLevel: LogLevelDesc;
 
   /**
    * 请求根路径

package/src/utils/download-file/download-file.ts

@@ -51,12 +51,33 @@ export function calcMimeByFileName(fileName: string) {
     case '.tar':
       mime = 'application/x-tar';
       break;
+    case '.xlsx':
+      mime = 'application/vnd.ms-excel';
+      break;
     default:
       mime = '';
   }
   return mime;
 }
 
+/**
+ * 判断是否是图片格式
+ *
+ * @author lxm
+ * @date 2022-11-21 13:11:23
+ * @export
+ * @param {string} fileName
+ * @returns {*}  {boolean}
+ */
+export function isImage(fileName: string): boolean {
+  const ext = fileName.split('.').pop();
+  if (!ext) {
+    return false;
+  }
+  const imageTypes = ['.jpeg', 'jpg', 'gif', 'png', 'bmp', 'svg'];
+  return imageTypes.includes(ext);
+}
+
 /**
  * 纯JS触发下载文件
  *

package/src/utils/index.ts

@@ -10,3 +10,6 @@ export * from './event/event';
 export * from './click-outside/click-outside';
 export * from './color/color';
 export * from './download-file/download-file';
+export * from './upload/select-file';
+export * from './upload/upload-file';
+export * from './sync';

package/src/utils/net/net.ts

@@ -10,6 +10,7 @@ import { merge } from 'lodash-es';
 import { stringify } from 'qs';
 import { notNilEmpty } from 'qx-util';
 import { HttpError } from '../../error';
+import { CoreInterceptor } from '../interceptor';
 import { Interceptor } from '../interceptor/interceptor';
 import { IHttpResponse } from './http-response';
 
@@ -40,6 +41,7 @@ export class Net {
    */
   constructor(config?: CreateAxiosDefaults) {
     this.instance = axios.create(config);
+    this.addInterceptor('Default', new CoreInterceptor());
   }
 
   /**
@@ -91,7 +93,9 @@ export class Net {
   protected get presetConfig(): AxiosRequestConfig {
     return {
       // 请求前缀路径
-      baseURL: this.instance.defaults.baseURL || ibiz.env.baseUrl,
+      baseURL:
+        this.instance.defaults.baseURL ||
+        `${ibiz.env.baseUrl}/${ibiz.env.appId}`,
       headers: {
         'Content-Type': 'application/json;charset=UTF-8',
         Accept: 'application/json',