xframelib 0.8.0 → 0.8.2

package/README.md

@@ -1,4 +1,5 @@
 # xframelib
+
 <p>
 <a href="https://www.npmjs.com/package/xframelib" target="_blank">
  <img src="https://img.shields.io/npm/v/xframelib?color=orange&logo=npm" />
@@ -7,9 +8,14 @@
  <img src="https://img.shields.io/npm/dt/xframelib?logo=npm"/>
 </a>
 </p>
-**基于 VUE3+Hprose+Typescript 的前端框架** 
 
-- v0.8.0   更新LayoutContainer各层的默认样式，默认空白区域鼠标可以穿越，各元素鼠标可点击;更新依赖库版本
+## XFramelib前端基础库
+
+> 基于 VUE3+Hprose+Typescript 的前端框架，与ElementUI、AntDesign VUE、Quasar等界面库无关，一直是来源于项目和服务于项目。
+
+- v0.8.2   修改VueWindow组件（VWindow）拖动定位错误;弃用DownloadByUrl方法;移除窗体同步库WSynchro.js;更新依赖库版本;
+- v0.8.1   修改RouterTransition组件，增加具有默认动画的RouterTransitionAnimate组件;widget组件配置对象（IWidgetConfig）启用layout属性（IWidgetLayout布局样式），增加cssClass外部配置样式类名；更新依赖库版本;
+- v0.8.0   更新LayoutContainer各层的默认样式，默认空白区域鼠标可以穿越，各元素鼠标可点击;更新依赖库版本;
 - *v0.7.9  给H5Tool增加常用DOM操作方法；为SysEvents增加LayoutContainerLoaded，每个LayoutManager对象自动加载到Global.LayoutMap里，为Global默认增加CesiumViewer对象；强化Widget链式排队加载，必须先afterid对应的widget加载成功，然后才加载当前widget。
 - v0.7.8 更新依赖库版本；增加SysConfig默认配置项；controls增加XWindow和XWindowManager取代VWindow；增加全局的Global.WidgetConfigList数组和getLayoutManager方法；删除VCollapsiblePanel、 VCollapsiblePanelGroup组件。
 - v0.7.7 增加hprose二进制序列化方法serialize和deserialize;修改Global默认自带LayoutMap和默认为console的Message;为LayoutManager增加静态方法getLayoutManager;增加RouterTransition控件,并应用于layoutcontainer中;更新依赖库版本。
@@ -70,29 +76,59 @@
 - v0.2.5 减小发布包大小,外部依赖 hprose
 - v0.2.4 正式应用于项目中,提供.d.ts 声明文件。
 
-## What Works:
+## 主要功能:
+
+- 网站系统配置Sysconfig.js对应的Global.Config
+- 公共事件总线Global.EventBus
+
+- Layout布局容器和Widget机制实现
+
+- Axios的Http请求封装实现Global.Axios、AxiosHelper{get, post, requestPost, requestGet, getData, requestPostBody} 
+
+- Hprose Proxy方式调用后台Hprose服务实现
+
+- 与用户系统后台服务适配的Token验证/刷新和角色权限过滤
+
+- 大文件下载BigFileDownload
+
+- 普通文件下载FileDownload封装{ Download, SaveAs, JsonDownload, HttpDownload, DownloadByUrl }
+
+- 大文件上传FileUpload
+
+- H5Tool常用小功能
+
+- SignalrClient
 
-- HproseClient 服务调用封装
-- 消息事件总线
-- Global 全局对象
-- Message 提示信息
-- SplitSpanes 封装
-- LayoutContainer 封装
-- XWindow 封装
-- 增加 utils 里的 Color、FileDownload、StorageHelper
+- JQuery工具 （hasClass 、addClass、removeClass、toggleClass、setCssProperty）
 
-## Installation
+- StorageHelper 本地缓存对象
 
-`yarn add xframelib`
+- IsTool类型判断工具（数字、字符串、对象、数组、函数等）
+
+- ValidateTool验证工具（身份证、手机号、IP地址、邮箱、密码强度判断、URL、车牌号等）
+
+- 与后端配合使用的加密解密算法XXTEA
+
+## 使用
+
+`pnpm add xframelib`
 
 or
 
 `npm i xframelib`
 
-## Usage
+全局引入库样式：
+
+import 'xframelib/dist/index.css';
+
+- **应用案例：前端开发模板 vue-widget-template**
 
-main.ts 文件
-In Typescript:
+https://github.com/zorrowm/vue-widget-template
+
+全面基于XFramelib和Widget思想的开发模板
+
+- **main.ts 文件**
+  In Typescript:
 
 ```js
 import { createApp } from 'vue';
@@ -141,6 +177,67 @@ app.mount('#app');
 
 ```
 
-### Working with hprose
+- **Quasar boot 使用示例**
+
+```vue
+import { boot } from 'quasar/wrappers';
+import { addAPIProvider, Icon } from '@iconify/vue';
+import { Dropdown } from 'floating-vue';
+import { EmitLoadingInfo } from 'src/events/index';
+import { autoRefresh } from 'src/utils/autoUpdate';
+import { message } from 'src/utils/MessageNotify';
+//封装的消息提示
+import { getSystemID, getSystemPKG } from 'src/utils/sysTool';
+import { Global, init } from 'xframelib';
+function preInit() {
+  if (window.global === undefined) {
+    window.global = globalThis;
+  }
+  //系统ID,唯一标识
+  const sysID = getSystemID();
+  //分组名，工程名
+  const sysGroup = getSystemPKG().name;
+  init(message, sysID, sysGroup);
+  //挂载进度通知方法
+  Global.Loading = EmitLoadingInfo;
+  //注册自己的IconAPIProvider
+  if (Global.Config.ServiceURL.IconServiceURL)
+    addAPIProvider('', {
+      resources: [Global.Config.ServiceURL.IconServiceURL]
+    });
+  else {
+    //离线使用图标：生效，IconServiceURL配置为空
+    import('../components/IconOffline').then((it) => {
+      it.default();
+    });
+  }
+}
+export default boot(({ app }) => {
+  EmitLoadingInfo('XFramelib库');
+  //初始化Xframelib
+  preInit();
+  //启动热更新监测
+  if (!import.meta.env.DEV) autoRefresh();
+  // 创建pinia 实例——20240221这里不需要了，在src/stores/index.ts里挂接的
+  // const pinia = createPinia();
+  // app.use(pinia);
+  //注册全局组件
+  app.component('Icon', Icon);
+  app.component('VDropdown', Dropdown);
+  // app.component('VTooltip', Tooltip);
+  // app.component('VMenu', Menu);
+
+  //开发时,全局注册tiny组件
+  // if (import.meta.env.DEV) {
+  //   // import('@opentiny/vue').then((it) => {
+  //   //   const TinyVue = it.default;
+  //   //   app.use(TinyVue);
+  //   // });
+  // }
+  console.log('环境变量',process.env);
+  //保存网站根地址
+  app.config.globalProperties.$AppURL=process.env.APP_URL;
+});
+
+```
 
-暂无

package/dist/controls/layoutcontainer/layout.vue.d.ts

@@ -1,6 +1,6 @@
 import { PropType } from "vue";
 import { IWidgetConfig } from "../../model/Layout";
-declare const _default: import("vue").DefineComponent<{
+declare const _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
     widgetConfig: {
         type: PropType<IWidgetConfig[]>;
         required: true;
@@ -17,24 +17,24 @@ declare const _default: import("vue").DefineComponent<{
         type: BooleanConstructor;
         default: boolean;
     };
-}, {
-    topContainerComponents: import("vue").Ref<Map<string, Object>>;
-    centerbackComponents: import("vue").Ref<Map<string, Object>>;
-    centerfrontComponents: import("vue").Ref<Map<string, Object>>;
-    leftContainerComponents: import("vue").Ref<Map<string, Object>>;
-    rightContainerComponents: import("vue").Ref<Map<string, Object>>;
-    bottomContainerComponents: import("vue").Ref<Map<string, Object>>;
+}>, {
+    topContainerComponents: import("vue").Ref<Map<string, Object>, Map<string, Object>>;
+    centerbackComponents: import("vue").Ref<Map<string, Object>, Map<string, Object>>;
+    centerfrontComponents: import("vue").Ref<Map<string, Object>, Map<string, Object>>;
+    leftContainerComponents: import("vue").Ref<Map<string, Object>, Map<string, Object>>;
+    rightContainerComponents: import("vue").Ref<Map<string, Object>, Map<string, Object>>;
+    bottomContainerComponents: import("vue").Ref<Map<string, Object>, Map<string, Object>>;
     containerStyle: import("vue").ComputedRef<Record<string, any> | undefined>;
-    isEnableRouterView: import("vue").Ref<boolean>;
+    isEnableRouterView: import("vue").Ref<boolean, boolean>;
     setItemRef: (el: any, key: string) => void;
-    topContainer?: import("vue").Ref<HTMLElement | undefined> | undefined;
-    centerBackContainer?: import("vue").Ref<HTMLElement | undefined> | undefined;
-    centerMainContainer?: import("vue").Ref<HTMLElement | undefined> | undefined;
-    centerFrontContainer?: import("vue").Ref<HTMLElement | undefined> | undefined;
-    bottomContainer?: import("vue").Ref<HTMLElement | undefined> | undefined;
-    leftContainer?: import("vue").Ref<HTMLElement | undefined> | undefined;
-    rightContainer?: import("vue").Ref<HTMLElement | undefined> | undefined;
-}, unknown, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, "containerLoaded"[], "containerLoaded", import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    topContainer?: import("vue").Ref<HTMLElement | undefined, HTMLElement | undefined> | undefined;
+    centerBackContainer?: import("vue").Ref<HTMLElement | undefined, HTMLElement | undefined> | undefined;
+    centerMainContainer?: import("vue").Ref<HTMLElement | undefined, HTMLElement | undefined> | undefined;
+    centerFrontContainer?: import("vue").Ref<HTMLElement | undefined, HTMLElement | undefined> | undefined;
+    bottomContainer?: import("vue").Ref<HTMLElement | undefined, HTMLElement | undefined> | undefined;
+    leftContainer?: import("vue").Ref<HTMLElement | undefined, HTMLElement | undefined> | undefined;
+    rightContainer?: import("vue").Ref<HTMLElement | undefined, HTMLElement | undefined> | undefined;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, "containerLoaded"[], "containerLoaded", import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
     widgetConfig: {
         type: PropType<IWidgetConfig[]>;
         required: true;
@@ -51,11 +51,13 @@ declare const _default: import("vue").DefineComponent<{
         type: BooleanConstructor;
         default: boolean;
     };
-}>> & {
+}>> & Readonly<{
     onContainerLoaded?: ((...args: any[]) => any) | undefined;
-}, {
+}>, {
     widgetConfig: IWidgetConfig[];
     layoutID: string;
     enableRouterView: boolean;
-}, {}>;
+}, {}, {
+    RouterTransition: import("vue").DefineComponent<{}, {}, any>;
+}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 export default _default;

package/dist/controls/routertransition/RouterTransition.vue.d.ts

@@ -1,4 +1,4 @@
 declare const _default: import("vue").DefineComponent<{}, (_ctx: any, _cache: any) => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
     [key: string]: any;
-}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{}>>, {}, {}>;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 export default _default;

package/dist/controls/routertransition/RouterTransitionAnimate.vue.d.ts

@@ -0,0 +1,29 @@
+declare const _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    enterActive: {
+        type: StringConstructor;
+        required: false;
+        default: string;
+    };
+    leaveActive: {
+        type: StringConstructor;
+        required: false;
+        default: string;
+    };
+}>, (_ctx: any, _cache: any) => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+    [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    enterActive: {
+        type: StringConstructor;
+        required: false;
+        default: string;
+    };
+    leaveActive: {
+        type: StringConstructor;
+        required: false;
+        default: string;
+    };
+}>> & Readonly<{}>, {
+    enterActive: string;
+    leaveActive: string;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export default _default;

package/dist/controls/routertransition/SuspenseWithError.vue.d.ts

@@ -1,4 +1,4 @@
 declare const _default: import("vue").DefineComponent<{}, {
-    error: import("vue").Ref<any>;
-}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{}>>, {}, {}>;
+    error: import("vue").Ref<any, any>;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 export default _default;

package/dist/controls/routertransition/index.d.ts

@@ -1,3 +1,4 @@
 import RouterTransition from './RouterTransition.vue';
 import SuspenseWithError from './SuspenseWithError.vue';
-export { RouterTransition, SuspenseWithError };
+import RouterTransitionAnimate from './RouterTransitionAnimate.vue';
+export { RouterTransition, SuspenseWithError, RouterTransitionAnimate };

package/dist/controls/vuewindow/window/Button.vue.d.ts

@@ -1,5 +1,5 @@
 import { PropType } from 'vue';
-declare const _default: import("vue").DefineComponent<{
+declare const _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
     disabled: {
         type: PropType<boolean>;
         default: boolean;
@@ -8,13 +8,13 @@ declare const _default: import("vue").DefineComponent<{
         type: ObjectConstructor;
         required: true;
     };
-}, {
-    hover: import("vue").Ref<boolean>;
-    active: import("vue").Ref<boolean>;
+}>, {
+    hover: import("vue").Ref<boolean, boolean>;
+    active: import("vue").Ref<boolean, boolean>;
     style: () => any;
     mouseup: (e: MouseEvent & TouchEvent) => void;
     mousedown: (e: MouseEvent & TouchEvent) => void;
-}, unknown, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
     disabled: {
         type: PropType<boolean>;
         default: boolean;
@@ -23,7 +23,7 @@ declare const _default: import("vue").DefineComponent<{
         type: ObjectConstructor;
         required: true;
     };
-}>>, {
+}>> & Readonly<{}>, {
     disabled: boolean;
-}, {}>;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 export default _default;

package/dist/controls/vuewindow/window/index.vue.d.ts

@@ -1,5 +1,5 @@
 import { PropType } from 'vue';
-declare const _default: import("vue").DefineComponent<{
+declare const _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
     windowStyle: {
         type: ObjectConstructor;
         required: true;
@@ -90,18 +90,18 @@ declare const _default: import("vue").DefineComponent<{
         type: PropType<number>;
         required: false;
     };
-}, {
-    isOpen: import("vue").Ref<boolean>;
-    windowEl: import("vue").Ref<any>;
-    titlebar: import("vue").Ref<any>;
-    content: import("vue").Ref<any>;
+}>, {
+    isOpen: import("vue").Ref<boolean, boolean>;
+    windowEl: import("vue").Ref<any, any>;
+    titlebar: import("vue").Ref<any, any>;
+    content: import("vue").Ref<any, any>;
     activate: () => void;
-    styleWindow: import("vue").Ref<any>;
+    styleWindow: import("vue").Ref<any, any>;
     styleTitlebar: import("vue").ComputedRef<any>;
     styleContent: import("vue").ComputedRef<any>;
     closeButtonClick: () => void;
     fixPosition: () => void;
-} | undefined, unknown, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+} | undefined, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
     windowStyle: {
         type: ObjectConstructor;
         required: true;
@@ -192,7 +192,7 @@ declare const _default: import("vue").DefineComponent<{
         type: PropType<number>;
         required: false;
     };
-}>>, {
+}>> & Readonly<{}>, {
     isOpen: boolean;
     title: string;
     closeButton: boolean;
@@ -207,5 +207,7 @@ declare const _default: import("vue").DefineComponent<{
     minHeight: number;
     maxWidth: number;
     maxHeight: number;
-}, {}>;
+}, {}, {
+    myButton: import("vue").DefineComponent<{}, {}, any>;
+}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 export default _default;

package/dist/controls/xwindow/XWindow.vue.d.ts

@@ -1,4 +1,4 @@
-declare const _default: import("vue").DefineComponent<{
+declare const _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
     top: {
         type: (StringConstructor | NumberConstructor)[];
         default: number;
@@ -51,9 +51,9 @@ declare const _default: import("vue").DefineComponent<{
         type: (StringConstructor | NumberConstructor | ArrayConstructor | ObjectConstructor)[];
         default: string;
     };
-}, (_ctx: any, _cache: any) => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+}>, (_ctx: any, _cache: any) => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
     [key: string]: any;
-}>, unknown, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, ("close" | "open" | "loaded" | "minimize")[], "close" | "open" | "loaded" | "minimize", import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, ("close" | "open" | "loaded" | "minimize")[], "close" | "open" | "loaded" | "minimize", import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
     top: {
         type: (StringConstructor | NumberConstructor)[];
         default: number;
@@ -106,12 +106,12 @@ declare const _default: import("vue").DefineComponent<{
         type: (StringConstructor | NumberConstructor | ArrayConstructor | ObjectConstructor)[];
         default: string;
     };
-}>> & {
+}>> & Readonly<{
     onClose?: ((...args: any[]) => any) | undefined;
     onOpen?: ((...args: any[]) => any) | undefined;
     onLoaded?: ((...args: any[]) => any) | undefined;
     onMinimize?: ((...args: any[]) => any) | undefined;
-}, {
+}>, {
     top: string | number;
     left: string | number;
     nWidth: string | number;
@@ -125,5 +125,5 @@ declare const _default: import("vue").DefineComponent<{
     isDark: boolean;
     pid: string;
     tag: string | number | Record<string, any> | unknown[];
-}, {}>;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 export default _default;

package/dist/controls/xwindow/XWindowManager.d.ts

@@ -15,7 +15,7 @@ export declare const WindowsMap: Map<string, IPanelData>;
 /**
  * 最小化窗体Map集合
  */
-export declare const MinWindowMap: import("vue").Ref<Map<string, number> & Omit<Map<string, number>, keyof Map<any, any>>>;
+export declare const MinWindowMap: import("vue").Ref<Map<string, number> & Omit<Map<string, number>, keyof Map<any, any>>, Map<string, number> | (Map<string, number> & Omit<Map<string, number>, keyof Map<any, any>>)>;
 declare class XWindowManager {
     /**
    * 注册添加窗体对象