@dao42/d42paas-front 0.7.26 → 0.7.29

package/dist/editor.d.ts

@@ -8,19 +8,30 @@
  *  Copyright (c) Microsoft Corporation. All rights reserved.
  *  Licensed under the MIT License. See License.txt in the project root for license information.
  *--------------------------------------------------------------------------------------------*/
+type MessageType = {
+  PlaygroundStatus?: any;
+  dockerStatus?: any;
+  userList?: any;
+};
 
-export type TMode = 'tsdoc' | 'singleFile' | 'IDE';
+type ErrorType = {
+  PlaygroundStatus?: any;
+  dockerStatus?: any;
+  userList?: any;
+};
 
-export type T_PlaygroundStatus = 'EMPTY' | 'ACTIVE' | 'INACTIVE';
+export type Mode = 'tsdoc' | 'singleFile' | 'IDE';
 
-export type TReplay = 'stop' | 'disabled' | 'pause';
+export type PlaygroundStatus = 'EMPTY' | 'ACTIVE' | 'INACTIVE';
 
-export type T_DockerStatus = 'RUNNING' | 'STOP';
+export type Replay = 'stop' | 'disabled' | 'pause';
+
+export type DockerStatus = 'RUNNING' | 'STOP';
 
 /**
- * JS API
+ * Userinfo type
  */
-interface TUserInfo {
+interface UserInfo {
   playgroundId?: string;
   operation?: any;
   uuid?: string;
@@ -34,14 +45,24 @@ interface TUserInfo {
 }
 
 /**
- * the arguments of the Playground.
+ * Passing the values to init the playground.
  */
-interface TConstructor {
+interface Options {
   debug?: boolean;
 
+  /**
+   *
+   * Error listener to the aplication.
+   * @param error
+   */
   onError?: (error: any) => void;
 
-  onMessage?: (message: any) => void;
+  /**
+   *
+   * Message listener to the aplication.
+   * @param MessageType
+   */
+  onMessage?: (message: MessageType) => void;
 
   serviceWorkerOrigin?: string;
 
@@ -50,66 +71,65 @@ interface TConstructor {
    * init the playground with the mode.
    *
    */
-
-  mode?: TMode;
+  readonly mode?: Mode;
 
   /**
    *
-   * init the playground with the env.
+   * init the playground with the paasDomain.
    *
    */
-  paasDomain: string;
+  readonly paasDomain: string;
 
   /**
    *
    * init the playground ticket needed.
    *
    */
-  ticket: string;
+  readonly ticket: string;
 
   /**
    *
    * to init the playground with this id.
    *
    */
-  playgroundId: string;
+  readonly playgroundId: string;
 
   /**
    *
    * userId for the playground.
    *
    */
-  userId: string;
+  readonly userId: string;
 
   /**
    *
    * tenantId for the playground.
    *
    */
-  tenantId: string;
+  readonly tenantId: string;
 
   /**
    *
    * username for the playground.
    *
    */
-  username?: string;
+  readonly username?: string;
 
   /**
    *
    * avatarUrl for the playground but not necessarily.
    *
    */
-  avatarUrl?: string;
+  readonly avatarUrl?: string;
 
   /**
    *
    * this argument is to ingnore replaying patterns.
    *
    */
-  ignoreReplayers?: string[];
+  readonly ignoreReplayers?: string[];
 
-  components?: UserComponent[];
+  readonly components?: UserComponent[];
 
   /**
    * @deprecated to fix the issue of the playground.
@@ -118,22 +138,21 @@ interface TConstructor {
    */
 }
 
-export interface UserComponent extends TComponentArgs {
+export interface UserComponent extends ComponentArgs {
   item: string;
 }
 
 /**
  *
- * @interface TComponentArgs
+ * @interface ComponentArgs
  * @desc
  *
  */
-export interface TComponentArgs {
+export interface ComponentArgs {
   /**
    *
    * the DOM for the component.
    * @type {(string | HTMLElement | Element)}
-   * @memberof TComponentArgs
    *
    */
   container: string | HTMLElement | Element;
@@ -141,14 +160,17 @@ export interface TComponentArgs {
   props?: any;
 }
 
+/**
+ * This is the entry point for the application.
+ */
 export class DaoPaaS {
-  constructor(args: TConstructor);
+  constructor(options: Options);
 
-  get playgroundStatus(): T_PlaygroundStatus;
+  get playgroundStatus(): PlaygroundStatus;
 
-  get dockerStatus(): T_DockerStatus;
+  get dockerStatus(): DockerStatus;
 
-  get userList(): TUserInfo[];
+  get userList(): UserInfo[];
 
   /**
    *
@@ -165,7 +187,6 @@ export class DaoPaaS {
    * @param {followUser} args
    *
    */
-
   followUser(user: any, callback: () => void): void;
 
   /**
@@ -174,7 +195,7 @@ export class DaoPaaS {
    * @param {TReplay} args
    *
    */
-  replay(args: { userId: TUserInfo['userId']; timestamp: string }): void;
+  replay(args: { userId: UserInfo['userId']; timestamp: string }): void;
 
   /**
    *
@@ -203,7 +224,6 @@ export class DaoPaaS {
   /**
    *
    * Active the playground handler.
-   * @memberof DaoPaaS
    *
    */
   activePlayground(): void;
@@ -211,7 +231,6 @@ export class DaoPaaS {
   /**
    *
    * Run the playground handler.
-   * @memberof DaoPaaS
    *
    */
   runPlayground(): void;
@@ -219,7 +238,6 @@ export class DaoPaaS {
   /**
    *
    * Stop the playground.
-   * @memberof DaoPaaS
    *
    */
   stopPlayground(): void;
@@ -227,12 +245,12 @@ export class DaoPaaS {
   /**
    *
    * Editor component.
-   * @memberof DaoPaaS
+   * @param ComponentArgs
    * CSS.Properties<string | number>
    */
   Editor(
     args:
-      | TComponentArgs
+      | ComponentArgs
       | {
           containerStyle: any;
           editorStyle: any;
@@ -243,40 +261,332 @@ export class DaoPaaS {
   /**
    *
    * Page component.
-   * @memberof DaoPaaS
+   * @param ComponentArgs
    *
    */
-  Page(args: TComponentArgs): void;
+  Page(args: ComponentArgs): void;
 
   /**
    *
    * Tree component.
-   * @memberof DaoPaaS
+   * @param ComponentArgs
    *
    */
-  Tree(args: TComponentArgs): void;
+  Tree(args: ComponentArgs): void;
 
   /**
    *
    * Shell component.
-   * @memberof DaoPaaS
+   * @param ComponentArgs
    *
    */
-  Shell(args: TComponentArgs): void;
+  Shell(args: ComponentArgs): void;
 
   /**
    *
    * Browser component.
-   * @memberof DaoPaaS
+   * @param ComponentArgs
    *
    */
-  Browser(args: TComponentArgs): void;
+  Browser(args: ComponentArgs): void;
 
   /**
    *
    * Console component.
-   * @memberof DaoPaaS
+   * @param ComponentArgs
    *
    */
-  Console(args: TComponentArgs): void;
+  Console(args: ComponentArgs): void;
 }
+
+// /*!-----------------------------------------------------------
+//  * Copyright (c) dao42. All rights reserved.
+//  * Type definitions for @dao42/d42paas-front
+//  * Released under the MIT license
+//  *-----------------------------------------------------------*/
+
+// /*---------------------------------------------------------------------------------------------
+//  *  Copyright (c) Microsoft Corporation. All rights reserved.
+//  *  Licensed under the MIT License. See License.txt in the project root for license information.
+//  *--------------------------------------------------------------------------------------------*/
+// type MessageType = {
+//   dockerStatus?: any;
+//   userList: any;
+// };
+
+// export type Mode = 'tsdoc' | 'singleFile' | 'IDE';
+
+// export type PlaygroundStatus = 'EMPTY' | 'ACTIVE' | 'INACTIVE';
+
+// export type Replay = 'stop' | 'disabled' | 'pause';
+
+// export type DockerStatus = 'RUNNING' | 'STOP';
+
+// /**
+//  * JS API
+//  */
+// interface UserInfo {
+//   playgroundId?: string;
+//   operation?: any;
+//   uuid?: string;
+//   color?: string;
+//   name?: string;
+//   username?: string;
+//   userId?: string;
+//   role?: string;
+//   avatar?: string;
+//   onlineCount?: number;
+// }
+
+// /**
+//  * Passing the values to init the playground.
+//  */
+// interface Options {
+//   debug?: boolean;
+
+//   /**
+//    *
+//    * Error listener to the aplication.
+//    * @param error
+//    */
+//   onError?: (error: MessageType) => void;
+
+//   /**
+//    *
+//    * Message listener to the aplication.
+//    * @param error
+//    */
+//   onMessage?: (message: any) => void;
+
+//   serviceWorkerOrigin?: string;
+
+//   /**
+//    *
+//    * init the playground with the mode.
+//    *
+//    */
+//   readonly mode?: Mode;
+
+//   /**
+//    *
+//    * init the playground with the paasDomain.
+//    *
+//    */
+//   readonly paasDomain: string;
+
+//   /**
+//    *
+//    * init the playground ticket needed.
+//    *
+//    */
+//   readonly ticket: string;
+
+//   /**
+//    *
+//    * to init the playground with this id.
+//    *
+//    */
+//   readonly playgroundId: string;
+
+//   /**
+//    *
+//    * userId for the playground.
+//    *
+//    */
+//   readonly userId: string;
+
+//   /**
+//    *
+//    * tenantId for the playground.
+//    *
+//    */
+//   readonly tenantId: string;
+
+//   /**
+//    *
+//    * username for the playground.
+//    *
+//    */
+//   readonly username?: string;
+
+//   /**
+//    *
+//    * avatarUrl for the playground but not necessarily.
+//    *
+//    */
+//   readonly avatarUrl?: string;
+
+//   /**
+//    *
+//    * this argument is to ingnore replaying patterns.
+//    *
+//    */
+//   readonly ignoreReplayers?: string[];
+
+//   readonly components?: UserComponent[];
+
+//   /**
+//    * @deprecated to fix the issue of the playground.
+//    *
+//    * render?: () => TComponentArgs[]; keyof D42_FrontType['CRDT'][]
+//    */
+// }
+
+// export interface UserComponent extends ComponentArgs {
+//   item: string;
+// }
+
+// /**
+//  *
+//  * @interface ComponentArgs
+//  * @desc
+//  *
+//  */
+// export interface ComponentArgs {
+//   /**
+//    *
+//    * the DOM for the component.
+//    * @type {(string | HTMLElement | Element)}
+//    *
+//    */
+//   container: string | HTMLElement | Element;
+
+//   props?: any;
+// }
+
+// export class DaoPaaS {
+//   constructor(options: Options);
+
+//   get playgroundStatus(): PlaygroundStatus;
+
+//   get dockerStatus(): DockerStatus;
+
+//   get userList(): UserInfo[];
+
+//   /**
+//    *
+//    * Replaying method for global calling.
+//    * @param {unFollowUser} args
+//    *
+//    */
+
+//   unFollowUser(user: any, callback: () => void): void;
+
+//   /**
+//    *
+//    * Replaying method for global calling.
+//    * @param {followUser} args
+//    *
+//    */
+
+//   followUser(user: any, callback: () => void): void;
+
+//   /**
+//    *
+//    * Replaying method for global calling.
+//    * @param {TReplay} args
+//    *
+//    */
+//   replay(args: { userId: UserInfo['userId']; timestamp: string }): void;
+
+//   /**
+//    *
+//    * Recording method for global calling.
+//    * @param {boolean} arg
+//    *
+//    */
+//   record(arg: boolean): void;
+
+//   /**
+//    *
+//    * async method to set Replayers.
+//    * @param {keyof D42_FrontType['CRDT'][]} arg
+//    *
+//    */
+//   setReplayers(arg: string[]): void;
+
+//   /**
+//    *
+//    * Here you can switch language services by calling this method.
+//    * @param {boolean} arg
+//    *
+//    */
+//   switchLspServer(arg: boolean): void;
+
+//   /**
+//    *
+//    * Active the playground handler.
+//    *
+//    */
+//   activePlayground(): void;
+
+//   /**
+//    *
+//    * Run the playground handler.
+//    *
+//    */
+//   runPlayground(): void;
+
+//   /**
+//    *
+//    * Stop the playground.
+//    *
+//    */
+//   stopPlayground(): void;
+
+//   /**
+//    *
+//    * Editor component.
+//    * @param ComponentArgs
+//    * CSS.Properties<string | number>
+//    */
+//   Editor(
+//     args:
+//       | ComponentArgs
+//       | {
+//           containerStyle: any;
+//           editorStyle: any;
+//           menuStyle: any;
+//         },
+//   ): void;
+
+//   /**
+//    *
+//    * Page component.
+//    * @param ComponentArgs
+//    *
+//    */
+//   Page(args: ComponentArgs): void;
+
+//   /**
+//    *
+//    * Tree component.
+//    * @param ComponentArgs
+//    *
+//    */
+//   Tree(args: ComponentArgs): void;
+
+//   /**
+//    *
+//    * Shell component.
+//    * @param ComponentArgs
+//    *
+//    */
+//   Shell(args: ComponentArgs): void;
+
+//   /**
+//    *
+//    * Browser component.
+//    * @param ComponentArgs
+//    *
+//    */
+//   Browser(args: ComponentArgs): void;
+
+//   /**
+//    *
+//    * Console component.
+//    * @param ComponentArgs
+//    *
+//    */
+//   Console(args: ComponentArgs): void;
+// }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dao42/d42paas-front",
-  "version": "0.7.26",
+  "version": "0.7.29",
   "description": "> TODO: description",
   "author": "eric183 <kk297466058@gmail.com>",
   "homepage": "https://github.com/dao42/d42paas_frontend#readme",
@@ -26,7 +26,7 @@
   "scripts": {
     "prebuild": "rimraf dist",
     "webpack": "cross-env TS_NODE_PROJECT=\"tsconfig.dev.json\" webpack --config ./config/webpack.prod.config.ts",
-    "start:web": "yarn vite && yarn workNameSpaceToFix",
+    "start:web": "yarn vite && yarn workNameSpaceToFix && yarn typedoc",
     "storybook": "start-storybook -p 6006",
     "build-storybook": "build-storybook -o .storybook/dist",
     "dev:disble": "cross-env TS_NODE_PROJECT=\"tsconfig.dev.json\" webpack serve --open --config ./config/webpack.dev.config.ts",
@@ -34,6 +34,7 @@
     "dev": "vite serve --host --config ./config/vite.config.ts",
     "dev:patch": "vite serve --host --config ./config/vite.dev.config.ts",
     "vite": "cross-env NODE_ENV=production vite build --config ./config/vite.config.ts && yarn run copyTS",
+    "typedoc": "npx typedoc --tsconfig ./doc.tsconfig.json",
     "fix": "eslint --fix --ext .jsx src/**",
     "copyTS": "shx cp ./src/types/editor.d.ts ./dist",
     "np": "npm publish --access-public",
@@ -83,7 +84,6 @@
     "@types/react-dom": "^17.0.9",
     "@types/tailwindcss": "^2.2.4",
     "@types/uuid": "^8.3.1",
-    "@types/webpack": "^5.28.0",
     "@vitejs/plugin-react": "^1.0.7",
     "autoprefixer": "^10.0.2",
     "babel-core": "^6.26.3",