@epxing/dashboard 5.3.0-beta.2 → 5.3.0-beta.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (13) hide show
  1. package/API.md +80 -80
  2. package/README.md +42 -42
  3. package/dist/src/Dashboard.js +1 -1
  4. package/dist/src/Widget.js +1 -1
  5. package/dist/style.css +8 -8
  6. package/package.json +5 -5
  7. package/src/Dashboard.vue +459 -459
  8. package/src/Widget.vue +354 -354
  9. package/src/index.js +28 -28
  10. package/types/index.d.ts +7 -7
  11. package/types/tabs.d.ts +1 -1
  12. package/types/title.d.ts +1 -1
  13. package/types/widget.d.ts +1 -1
package/API.md CHANGED
@@ -1,80 +1,80 @@
1
- # @epxing/dashboard API
2
-
3
- 看板根容器、分组标签、标题、内容区和挂件组件。
4
-
5
- 本页对应包版本 `5.3.0-beta.2`。导出名、子路径和签名从当前源码、package.json 与类型声明生成。
6
-
7
- ## 安装与使用
8
-
9
-
10
- ```sh
11
- pnpm add @epxing/dashboard@5.3.0-beta.2
12
- ```
13
-
14
-
15
- ```js
16
- import DashboardPlugin, { Dashboard, DashboardWidget } from '@epxing/dashboard'
17
-
18
- // app 已初始化 core 和基础组件
19
- app.use(DashboardPlugin)
20
- app.component('ProductDashboard', Dashboard)
21
- ```
22
-
23
- ## 接入约定
24
-
25
- default 与具名 Dashboard 是同一根组件；其 install 会注册配套组件、预览和网格兼容组件。布局、请求与保存依赖平台运行环境。Tabs/Title/Div/Widget 稳定子路径均为 default 组件导出。
26
-
27
- 本版 JS 入口自动加载本包聚合样式，根导入和稳定子路径均无需手动 import style.css；保留显式样式入口以兼容旧代码。样式按包加载，产品覆盖样式放在框架导入之后。
28
-
29
- ## 根入口完整导出
30
-
31
- | 导出名 | 形态 | 用途 | 参数 / 配置 / 事件 |
32
- | --- | --- | --- | --- |
33
- | `default` | 默认导出 | Dashboard 组件，同时具有 install，可用作组件或 app.use 插件。 | [详细参考](../../docs/revision/dashboard/Dashboard.md) |
34
- | `Dashboard` | Vue 组件 | 看板根容器，组织布局、挂件和看板运行状态。 | [详细参考](../../docs/revision/dashboard/Dashboard.md) |
35
- | `DashboardTabs` | Vue 组件 | 看板标签页容器，按标签组织看板内容。 | [详细参考](../../docs/revision/dashboard/Tabs.md) |
36
- | `DashboardTitle` | Vue 组件 | 看板标题组件，展示标题和相关样式。 | [详细参考](../../docs/revision/dashboard/Title.md) |
37
- | `DashboardDiv` | Vue 组件 | 看板内容容器，承载嵌套内容和布局。 | [详细参考](../../docs/revision/dashboard/Div.md) |
38
- | `DashboardWidget` | Vue 组件 | 看板挂件容器，负责挂件内容与布局交互。 | [详细参考](../../docs/revision/dashboard/Widget.md) |
39
-
40
- ## 函数、类与工具对象
41
-
42
- 签名中的 any 表示现有声明未进一步限定结构；源代码方法签名保留默认参数。异步结果与泛型以声明为准。
43
-
44
- ## 稳定子路径
45
-
46
- 下表按实际 package.json 的公开入口列出。default 使用默认导入，其他名称使用具名导入；类型接口用 import type。
47
-
48
- | 导入路径 | 完整导出名 | 用途 / 详细说明 |
49
- | --- | --- | --- |
50
- | `@epxing/dashboard/tabs` | `default` | 看板标签页容器，按标签组织看板内容。 [详细参考](../../docs/revision/dashboard/Tabs.md) |
51
- | `@epxing/dashboard/title` | `default` | 看板标题组件，展示标题和相关样式。 [详细参考](../../docs/revision/dashboard/Title.md) |
52
- | `@epxing/dashboard/div` | `default` | 看板内容容器，承载嵌套内容和布局。 [详细参考](../../docs/revision/dashboard/Div.md) |
53
- | `@epxing/dashboard/widget` | `default` | 看板挂件容器，负责挂件内容与布局交互。 [详细参考](../../docs/revision/dashboard/Widget.md) |
54
- | `@epxing/dashboard/style.css` | 可选的显式样式入口 | JS 入口自动加载本包样式；保留此路径以兼容旧代码。 |
55
-
56
- ## 源码兼容与其他入口
57
-
58
- /src 路径保留给已有产品和源码级扩展，可能包含平台内部实现；新产品优先采用上方根导出与稳定子路径。通配符表示按实际文件名匹配，不代表所有源码都属于根入口。
59
-
60
- | 公开路径模式 | 实际目标 |
61
- | --- | --- |
62
- | `@epxing/dashboard/src` | `./dist/src/index.js` |
63
- | `@epxing/dashboard/src/*.css` | `./src/*.css` |
64
- | `@epxing/dashboard/src/*.scss` | `./src/*.scss` |
65
- | `@epxing/dashboard/src/*.png` | `./src/*.png` |
66
- | `@epxing/dashboard/src/*.svg` | `./src/*.svg` |
67
- | `@epxing/dashboard/src/*.jpg` | `./src/*.jpg` |
68
- | `@epxing/dashboard/src/*.gif` | `./src/*.gif` |
69
- | `@epxing/dashboard/src/*.woff` | `./src/*.woff` |
70
- | `@epxing/dashboard/src/*.woff2` | `./src/*.woff2` |
71
- | `@epxing/dashboard/src/*.ttf` | `./src/*.ttf` |
72
- | `@epxing/dashboard/src/*.js` | `./dist/src/*.js` |
73
- | `@epxing/dashboard/src/*.jsx` | `./dist/src/*.js` |
74
- | `@epxing/dashboard/src/*.vue` | `./dist/src/*.js` |
75
- | `@epxing/dashboard/src/*` | `./dist/src/*.js` |
76
- | `@epxing/dashboard/package.json` | `./package.json` |
77
-
78
- ## 文档维护
79
-
80
- 本页由 build/gen-package-api-docs.mjs 生成。修改公开入口并更新构建产物和类型声明后，在框架根运行 `pnpm docs:api`；`pnpm docs:api:check` 检查清单、类型、包内文档与站点镜像是否同步，同时验证页面编译和文档链接。用途和示例维护在 build/package-api-notes.mjs，组件和源码方法的详细参考位于 docs/revision。
1
+ # @epxing/dashboard API
2
+
3
+ 看板根容器、分组标签、标题、内容区和挂件组件。
4
+
5
+ 本页对应包版本 `5.3.0-beta.4`。导出名、子路径和签名从当前源码、package.json 与类型声明生成。
6
+
7
+ ## 安装与使用
8
+
9
+
10
+ ```sh
11
+ pnpm add @epxing/dashboard@5.3.0-beta.2
12
+ ```
13
+
14
+
15
+ ```js
16
+ import DashboardPlugin, { Dashboard, DashboardWidget } from '@epxing/dashboard'
17
+
18
+ // app 已初始化 core 和基础组件
19
+ app.use(DashboardPlugin)
20
+ app.component('ProductDashboard', Dashboard)
21
+ ```
22
+
23
+ ## 接入约定
24
+
25
+ default 与具名 Dashboard 是同一根组件；其 install 会注册配套组件、预览和网格兼容组件。布局、请求与保存依赖平台运行环境。Tabs/Title/Div/Widget 稳定子路径均为 default 组件导出。
26
+
27
+ 本版 JS 入口自动加载本包聚合样式，根导入和稳定子路径均无需手动 import style.css；保留显式样式入口以兼容旧代码。样式按包加载，产品覆盖样式放在框架导入之后。
28
+
29
+ ## 根入口完整导出
30
+
31
+ | 导出名 | 形态 | 用途 | 参数 / 配置 / 事件 |
32
+ | --- | --- | --- | --- |
33
+ | `default` | 默认导出 | Dashboard 组件，同时具有 install，可用作组件或 app.use 插件。 | [详细参考](../../docs/revision/dashboard/Dashboard.md) |
34
+ | `Dashboard` | Vue 组件 | 看板根容器，组织布局、挂件和看板运行状态。 | [详细参考](../../docs/revision/dashboard/Dashboard.md) |
35
+ | `DashboardTabs` | Vue 组件 | 看板标签页容器，按标签组织看板内容。 | [详细参考](../../docs/revision/dashboard/Tabs.md) |
36
+ | `DashboardTitle` | Vue 组件 | 看板标题组件，展示标题和相关样式。 | [详细参考](../../docs/revision/dashboard/Title.md) |
37
+ | `DashboardDiv` | Vue 组件 | 看板内容容器，承载嵌套内容和布局。 | [详细参考](../../docs/revision/dashboard/Div.md) |
38
+ | `DashboardWidget` | Vue 组件 | 看板挂件容器，负责挂件内容与布局交互。 | [详细参考](../../docs/revision/dashboard/Widget.md) |
39
+
40
+ ## 函数、类与工具对象
41
+
42
+ 签名中的 any 表示现有声明未进一步限定结构；源代码方法签名保留默认参数。异步结果与泛型以声明为准。
43
+
44
+ ## 稳定子路径
45
+
46
+ 下表按实际 package.json 的公开入口列出。default 使用默认导入，其他名称使用具名导入；类型接口用 import type。
47
+
48
+ | 导入路径 | 完整导出名 | 用途 / 详细说明 |
49
+ | --- | --- | --- |
50
+ | `@epxing/dashboard/tabs` | `default` | 看板标签页容器，按标签组织看板内容。 [详细参考](../../docs/revision/dashboard/Tabs.md) |
51
+ | `@epxing/dashboard/title` | `default` | 看板标题组件，展示标题和相关样式。 [详细参考](../../docs/revision/dashboard/Title.md) |
52
+ | `@epxing/dashboard/div` | `default` | 看板内容容器，承载嵌套内容和布局。 [详细参考](../../docs/revision/dashboard/Div.md) |
53
+ | `@epxing/dashboard/widget` | `default` | 看板挂件容器，负责挂件内容与布局交互。 [详细参考](../../docs/revision/dashboard/Widget.md) |
54
+ | `@epxing/dashboard/style.css` | 可选的显式样式入口 | JS 入口自动加载本包样式；保留此路径以兼容旧代码。 |
55
+
56
+ ## 源码兼容与其他入口
57
+
58
+ /src 路径保留给已有产品和源码级扩展，可能包含平台内部实现；新产品优先采用上方根导出与稳定子路径。通配符表示按实际文件名匹配，不代表所有源码都属于根入口。
59
+
60
+ | 公开路径模式 | 实际目标 |
61
+ | --- | --- |
62
+ | `@epxing/dashboard/src` | `./dist/src/index.js` |
63
+ | `@epxing/dashboard/src/*.css` | `./src/*.css` |
64
+ | `@epxing/dashboard/src/*.scss` | `./src/*.scss` |
65
+ | `@epxing/dashboard/src/*.png` | `./src/*.png` |
66
+ | `@epxing/dashboard/src/*.svg` | `./src/*.svg` |
67
+ | `@epxing/dashboard/src/*.jpg` | `./src/*.jpg` |
68
+ | `@epxing/dashboard/src/*.gif` | `./src/*.gif` |
69
+ | `@epxing/dashboard/src/*.woff` | `./src/*.woff` |
70
+ | `@epxing/dashboard/src/*.woff2` | `./src/*.woff2` |
71
+ | `@epxing/dashboard/src/*.ttf` | `./src/*.ttf` |
72
+ | `@epxing/dashboard/src/*.js` | `./dist/src/*.js` |
73
+ | `@epxing/dashboard/src/*.jsx` | `./dist/src/*.js` |
74
+ | `@epxing/dashboard/src/*.vue` | `./dist/src/*.js` |
75
+ | `@epxing/dashboard/src/*` | `./dist/src/*.js` |
76
+ | `@epxing/dashboard/package.json` | `./package.json` |
77
+
78
+ ## 文档维护
79
+
80
+ 本页由 build/gen-package-api-docs.mjs 生成。修改公开入口并更新构建产物和类型声明后，在框架根运行 `pnpm docs:api`；`pnpm docs:api:check` 检查清单、类型、包内文档与站点镜像是否同步，同时验证页面编译和文档链接。用途和示例维护在 build/package-api-notes.mjs，组件和源码方法的详细参考位于 docs/revision。
package/README.md CHANGED
@@ -1,42 +1,42 @@
1
- # @epxing/dashboard
2
-
3
- [完整公开 API、导入方式与示例](./API.md)
4
-
5
- 从 5.3.0-beta.2 起，导入本包 JS 时自动加载包级样式，根入口和稳定子路径均无需手动引入 style.css。显式样式入口继续兼容旧代码；产品覆盖样式放在框架导入之后。
6
-
7
- 数据看板包 - **可视化看板搭建，拖拽组件组成仪表盘大屏（按需加载）**。
8
-
9
- ## 范围
10
-
11
- - `src/frame/packages/dashboard/`（Dashboard.vue / Widget.vue / Tabs.vue / Div.vue / Header.vue）
12
- - `src/frame/packages/visual-config-page/Dashboard*.vue`
13
- - `src/frame/packages/visual-config-page/DashboardDesign.vue`
14
- - `src/frame/packages/visual-config-page/dashboard-theme-setting/`（Background / Border / Index）
15
-
16
- ## 依赖
17
-
18
- - `@epxing/utils`
19
- - `@epxing/theme`
20
- - `@epxing/core`
21
- - `@epxing/components`
22
- - echarts / d3（本包独占重依赖）
23
-
24
- ## 加载策略
25
-
26
- `apps/platform` 路由层 `() => import('@epxing/dashboard')` 懒加载。
27
-
28
- ## 状态
29
-
30
- 🟡 stub - 实际迁移在 T20。
31
-
32
-
33
- ## 独立包公共入口（2026-10-22）
34
-
35
- 根入口及稳定子路径提供类型声明。先安装 core 与需要的 component，再按需安装本包。
36
-
37
- ```js
38
- import plugin from '@epxing/dashboard'
39
- app.use(plugin)
40
- ```
41
-
42
- 工作区构建：`pnpm --filter @epxing/dashboard build`。pack/publish 的 prepack 会重建；版本由 Changesets 独立管理。旧 `/src/*` 入口保留。完整初始化、打包与远程共享流程见 docs/build-and-publish.md。
1
+ # @epxing/dashboard
2
+
3
+ [完整公开 API、导入方式与示例](./API.md)
4
+
5
+ 从 5.3.0-beta.2 起，导入本包 JS 时自动加载包级样式，根入口和稳定子路径均无需手动引入 style.css。显式样式入口继续兼容旧代码；产品覆盖样式放在框架导入之后。
6
+
7
+ 数据看板包 - **可视化看板搭建，拖拽组件组成仪表盘大屏（按需加载）**。
8
+
9
+ ## 范围
10
+
11
+ - `src/frame/packages/dashboard/`（Dashboard.vue / Widget.vue / Tabs.vue / Div.vue / Header.vue）
12
+ - `src/frame/packages/visual-config-page/Dashboard*.vue`
13
+ - `src/frame/packages/visual-config-page/DashboardDesign.vue`
14
+ - `src/frame/packages/visual-config-page/dashboard-theme-setting/`（Background / Border / Index）
15
+
16
+ ## 依赖
17
+
18
+ - `@epxing/utils`
19
+ - `@epxing/theme`
20
+ - `@epxing/core`
21
+ - `@epxing/components`
22
+ - echarts / d3（本包独占重依赖）
23
+
24
+ ## 加载策略
25
+
26
+ `apps/platform` 路由层 `() => import('@epxing/dashboard')` 懒加载。
27
+
28
+ ## 状态
29
+
30
+ 🟡 stub - 实际迁移在 T20。
31
+
32
+
33
+ ## 独立包公共入口（2026-10-22）
34
+
35
+ 根入口及稳定子路径提供类型声明。先安装 core 与需要的 component，再按需安装本包。
36
+
37
+ ```js
38
+ import plugin from '@epxing/dashboard'
39
+ app.use(plugin)
40
+ ```
41
+
42
+ 工作区构建：`pnpm --filter @epxing/dashboard build`。pack/publish 的 prepack 会重建；版本由 Changesets 独立管理。旧 `/src/*` 入口保留。完整初始化、打包与远程共享流程见 docs/build-and-publish.md。
package/dist/src/Dashboard.js CHANGED
@@ -327,7 +327,7 @@ function _sfc_render(_ctx, _cache, $props, $setup, $data, $options) {
327
327
  ], 6)
328
328
  ], 6);
329
329
  }
330
- const Dashboard = /* @__PURE__ */ _export_sfc(_sfc_main, [["render", _sfc_render], ["__scopeId", "data-v-2bc41af0"]]);
330
+ const Dashboard = /* @__PURE__ */ _export_sfc(_sfc_main, [["render", _sfc_render], ["__scopeId", "data-v-c85a2bef"]]);
331
331
  export {
332
332
  Dashboard as default
333
333
  };
package/dist/src/Widget.js CHANGED
@@ -261,7 +261,7 @@ function _sfc_render(_ctx, _cache, $props, $setup, $data, $options) {
261
261
  ], 4)
262
262
  ], 6);
263
263
  }
264
- const DashboardWidget = /* @__PURE__ */ _export_sfc(_sfc_main, [["render", _sfc_render], ["__scopeId", "data-v-d068f7d2"]]);
264
+ const DashboardWidget = /* @__PURE__ */ _export_sfc(_sfc_main, [["render", _sfc_render], ["__scopeId", "data-v-651dd5dc"]]);
265
265
  export {
266
266
  DashboardWidget as default
267
267
  };
package/dist/style.css CHANGED
@@ -971,7 +971,7 @@ div.container[data-v-503fe9af] {
971
971
  -------------------------- */
972
972
  /* BEM
973
973
  -------------------------- */
974
- .dashboard[data-v-d068f7d2] {
974
+ .dashboard[data-v-651dd5dc] {
975
975
  width: 100%;
976
976
  height: 100%;
977
977
  overflow: auto;
@@ -979,31 +979,31 @@ div.container[data-v-503fe9af] {
979
979
  display: flex;
980
980
  flex-direction: column;
981
981
  }
982
- .dashboard .base-page[data-v-d068f7d2] {
982
+ .dashboard .base-page[data-v-651dd5dc] {
983
983
  position: static;
984
984
  overflow-x: hidden;
985
985
  padding: 0;
986
986
  }
987
- .dashboard--hidden-scroll-bar .dashboard-container[data-v-d068f7d2]::-webkit-scrollbar-thumb {
987
+ .dashboard--hidden-scroll-bar .dashboard-container[data-v-651dd5dc]::-webkit-scrollbar-thumb {
988
988
  background: none;
989
989
  }
990
- .dashboard--hidden-scroll-bar .dashboard-container[data-v-d068f7d2]::-webkit-scrollbar-thumb:hover {
990
+ .dashboard--hidden-scroll-bar .dashboard-container[data-v-651dd5dc]::-webkit-scrollbar-thumb:hover {
991
991
  background-color: rgba(95, 95, 95, 0.3);
992
992
  }
993
- .dashboard-container[data-v-d068f7d2] {
993
+ .dashboard-container[data-v-651dd5dc] {
994
994
  width: 100%;
995
995
  flex: 1;
996
996
  overflow: auto;
997
997
  }
998
- .dashboard-component[data-v-d068f7d2] {
998
+ .dashboard-component[data-v-651dd5dc] {
999
999
  width: 100%;
1000
1000
  height: 100%;
1001
1001
  overflow: auto;
1002
1002
  }
1003
- .dashboard--dark .dashboard-container[data-v-d068f7d2] {
1003
+ .dashboard--dark .dashboard-container[data-v-651dd5dc] {
1004
1004
  background: #151C3D;
1005
1005
  }
1006
- .dashboard--technology .dashboard-container[data-v-d068f7d2] {
1006
+ .dashboard--technology .dashboard-container[data-v-651dd5dc] {
1007
1007
  background: url("./assets/technology_bg-oWIS2awO.jpg") no-repeat center;
1008
1008
  background-size: cover;
1009
1009
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@epxing/dashboard",
3
- "version": "5.3.0-beta.2",
3
+ "version": "5.3.0-beta.4",
4
4
  "description": "看板运行态渲染",
5
5
  "type": "module",
6
6
  "main": "./dist/src/index.js",
@@ -56,10 +56,10 @@
56
56
  ],
57
57
  "dependencies": {
58
58
  "gridstack": "13.3.0",
59
- "@epxing/components": "^5.3.0-beta.2",
60
- "@epxing/core": "^5.3.0-beta.2",
61
- "@epxing/theme": "^5.3.0-beta.2",
62
- "@epxing/utils": "^5.3.0-beta.2"
59
+ "@epxing/components": "^5.3.0-beta.4",
60
+ "@epxing/theme": "^5.3.0-beta.4",
61
+ "@epxing/core": "^5.3.0-beta.4",
62
+ "@epxing/utils": "^5.3.0-beta.4"
63
63
  },
64
64
  "peerDependencies": {
65
65
  "vue": "3.5.39",