@xq-labs/data-ui-v2 0.4.0 → 0.5.0

package/docs/api/overview.md

@@ -201,7 +201,7 @@ const stateConfig = {
 | --- | --- | --- | --- |
 | `data` | `Array` | `[]` | 原始业务数据数组 |
 | `xAxisKey` | `String` | `'name'` | 横轴类目字段名 |
-| `series` | `Array` | `[]` | 系列定义数组，推荐包含 `key`、`name`、`kind` |
+| `series` | `Array` | `[]` | 系列定义数组，推荐包含 `key`、`name`、`kind`、`colors`，`cube` 方柱可额外传 `cubeGradientColors` |
 | `variant` | `String` | `'flat'` | 图形风格：`flat` / `cylinder` / `cube` |
 | `preset` | `String` | `'compare'` | 预设：`compare` / `trend` / `rank` |
 | `barWidth` | `Number` | `18` | 柱体宽度 |
@@ -210,6 +210,7 @@ const stateConfig = {
 | `xAxisScroll` | `Object` | `{}` | X 轴类目滚动配置，只作用于横轴 |
 | `customOption` | `Object` | `{}` | 对 ECharts option 的补充覆盖 |
 | `loading` | `Boolean` | `false` | 是否显示统一遮罩式 loading（非 ECharts 原生 loading） |
+| `showEmptyState` | `Boolean` | `true` | 数据为空时是否展示统一空状态；关闭后仍保留图表容器与坐标系渲染 |
 | `stateConfig` | `Object` | `{}` | 统一状态配置，原样透传给 `BaseChart` |
 | `height` | `String \| Number` | `320` | 容器高度 |
 
@@ -298,6 +299,13 @@ const series = [
     kind: 'bar',
     colors: ['#6B98F8']
   },
+  {
+    key: 'delivery',
+    name: '交付',
+    kind: 'bar',
+    colors: ['#6B8AF7', '#5B7CF0', '#8FA6FF'],
+    cubeGradientColors: ['#B8C8FF', '#8EA7FF', '#DCE5FF']
+  },
   {
     key: 'rate',
     name: '完成率',
@@ -337,6 +345,33 @@ const series = [
 - 传 `2` 个色值：按“左侧面 / 右侧面”解释，顶面自动提亮。
 - 传 `3` 个色值：按“左侧面 / 右侧面 / 顶面”解释。
 
+### 7.6 `cubeGradientColors` 配置规则
+
+`cubeGradientColors` 只在 `variant="cube"` 且当前系列是前景 `bar` 时生效，用来补充三面的渐变终点色。
+
+规则说明：
+
+- 类型要求是 `Array`，非数组会被忽略。
+- 最多读取前 `1~3 个色值`，顺序固定为“左侧面 / 右侧面 / 顶面”。
+- 未传某一面的终点色时，会回退到该面的主色。
+- 只影响前景方柱的 `fill` 渐变，不改变 `stroke / legend / tooltip` 的主色语义。
+- 背景方柱不读取 `cubeGradientColors`，继续保持纯色 + 透明度的柱槽视觉。
+- `flat / cylinder / line` 会忽略该字段。
+
+推荐示例：
+
+```js
+const series = [
+  {
+    key: 'delivery',
+    name: '交付',
+    kind: 'bar',
+    colors: ['#6B8AF7', '#5B7CF0', '#8FA6FF'],
+    cubeGradientColors: ['#B8C8FF', '#8EA7FF', '#DCE5FF']
+  }
+]
+```
+
 示例：
 
 ```js
@@ -345,7 +380,7 @@ colors: ['#A8BEFA', '#6B98F8']
 colors: ['#A8BEFA', '#6B98F8', '#3EE8FE']
 ```
 
-### 7.6 `xAxisScroll` 字段说明
+### 7.7 `xAxisScroll` 字段说明
 
 `xAxisScroll` 用于横轴类目较多的场景。
 它底层使用 ECharts `dataZoom`，只控制 X 轴，不会影响 Y 轴。
@@ -379,14 +414,14 @@ const xAxisScroll = {
 4. 开启底部滚动条时，组件默认把 `grid.bottom` 提升到 `56`，避免滚动条挤压坐标轴。
 5. `customOption.dataZoom` 与 `customOption.grid.bottom` 优先级最高，可覆盖组件生成结果。
 
-### 7.7 Events
+### 7.8 Events
 
 | 事件名 | 参数 | 说明 |
 | --- | --- | --- |
 | `ready` | `chart` | 底层 ECharts 实例 |
 | `chart-click` | `params` | 点击图形元素时触发 |
 
-### 7.8 常见场景
+### 7.9 常见场景
 
 1. **基础柱线组合**：销售额 + 完成率双轴。
 2. **圆柱视觉**：看板类数据强调“柱体感”。
@@ -430,6 +465,7 @@ const xAxisScroll = {
 | `hideZeroValueSlices` | `Boolean` | `true` | 3D 下是否过滤 0 值扇区 |
 | `customOption` | `Object` | `{}` | 对 ECharts option 的补充覆盖 |
 | `loading` | `Boolean` | `false` | 是否显示统一遮罩式 loading（非 ECharts 原生 loading） |
+| `showEmptyState` | `Boolean` | `true` | 是否在普通空数据场景展示统一空状态；不影响 3D 运行时失败等必须提示的错误场景 |
 | `stateConfig` | `Object` | `{}` | 统一状态配置；3D 运行时失败时内部错误文案优先级更高 |
 | `height` | `String \| Number` | `320` | 容器高度 |
 

package/docs/examples/bar-line-chart.md

@@ -30,6 +30,7 @@ Playground 中 `BarLineChart` 按分组路由组织：
     barBackground,
     xAxisScroll,
     customOption,
+    showEmptyState,
     stateConfig
   }"
 />
@@ -46,6 +47,7 @@ Playground 中 `BarLineChart` 按分组路由组织：
 - `barBackground`：柱形背景配置，用于为当前图中的柱系列补整列高度背景柱。
 - `xAxisScroll`：X 轴滚动配置，用于类目过多时默认展示最新数据窗口。
 - `customOption`：ECharts 展示细节覆盖。
+- `showEmptyState`：数据为空时是否展示统一空状态；关闭后保留图表容器与坐标系本身。
 - `stateConfig`：统一收拢空态文案、空态图和 loading 文案。
 
 推荐结构：
@@ -74,6 +76,8 @@ const stateConfig = {
     text: '柱线图加载中...'
   }
 }
+
+const showEmptyState = false
 ```
 
 `xAxisScroll` 字段说明：
@@ -91,6 +95,24 @@ const stateConfig = {
 - `colors`：可选背景色板，支持 1~3 个色值；建议传不带 alpha 的颜色值，不传时按当前柱形默认背景色推导。
 - `opacity`：背景柱透明度，推荐传 `0 ~ 1` 之间的小数。
 
+`cube` 方柱补充字段：
+
+- `series.colors`：继续按左/右/顶顺序提供三面的主色，兼容现有 1~3 个色值写法。
+- `cubeGradientColors`：仅 `cube` 前景柱生效，按左/右/顶顺序提供三面的渐变终点色；缺失某一面时会回退到该面的主色。
+- 背景方柱不读取 `cubeGradientColors`，继续保持纯色 + 透明度的柱槽视觉。
+
+```js
+const series = [
+  {
+    key: 'delivery',
+    name: '交付',
+    kind: 'bar',
+    colors: ['#6B8AF7', '#5B7CF0', '#8FA6FF'],
+    cubeGradientColors: ['#B8C8FF', '#8EA7FF', '#DCE5FF']
+  }
+]
+```
+
 背景高度语义：
 
 - `barBackground` 渲染的是当前坐标轴下的整列高度背景柱，不跟随单个数据值缩放。
@@ -99,10 +121,12 @@ const stateConfig = {
 
 1. **优先 `series` 表达业务语义**：先确定字段、柱线类型、双轴和堆叠关系。
 2. **用 `series.colors` 控制系列配色**：把业务色板放在系列层。
-3. **用 `barBackground` 强化柱槽轮廓**：需要整列高度背景时，再开启背景柱并调透明度。
-4. **用 `xAxisScroll` 控制横轴窗口**：类目较多时默认展示最新 `visibleCount` 个类目。
-5. **`stateConfig` 收拢状态文案**：空态图、空态文案、loading 文案统一从这里传。
-6. **`customOption` 补充细节**：用于 tooltip、legend、grid、坐标轴样式、dataZoom 等展示项。
+3. **`cube` 方柱可再传 `cubeGradientColors`**：只补前景三面的渐变终点色，不影响背景方柱。
+4. **用 `barBackground` 强化柱槽轮廓**：需要整列高度背景时，再开启背景柱并调透明度。
+5. **用 `xAxisScroll` 控制横轴窗口**：类目较多时默认展示最新 `visibleCount` 个类目。
+6. **按需关闭 `showEmptyState`**：需要保留空图表骨架时可传 `false`，否则默认展示统一空态。
+7. **`stateConfig` 收拢状态文案**：空态图、空态文案、loading 文案统一从这里传。
+8. **`customOption` 补充细节**：用于 tooltip、legend、grid、坐标轴样式、dataZoom 等展示项。
 
 不建议用 `customOption` 直接整体替换关键业务结构。
 如果必须完全自定义滚动条，可通过 `customOption.dataZoom` 覆盖 `xAxisScroll` 生成结果。
@@ -110,5 +134,5 @@ const stateConfig = {
 ## 4. 可执行验收要点
 
 - 页面分组名称与路由一致：基础用法、圆柱样式、方柱样式、进阶配置、customOption 与自定义、实验室。
-- 文档示例包含 `series.colors`、`barBackground`、`xAxisScroll`、`stateConfig` 与 `customOption`。
+- 文档示例包含 `series.colors`、`cubeGradientColors`、`barBackground`、`xAxisScroll`、`showEmptyState`、`stateConfig` 与 `customOption`。
 - 文档明确实验室边界与推荐自定义顺序。

package/docs/examples/pie-chart.md

@@ -30,6 +30,7 @@ Playground 中 `PieChart` 采用分组路由组织，按能力查阅：
     hideZeroValueSlices,
     labelOptions,
     customOption,
+    showEmptyState,
     stateConfig
   }"
 />
@@ -45,6 +46,7 @@ Playground 中 `PieChart` 采用分组路由组织，按能力查阅：
 - `hideZeroValueSlices`：3D 下是否隐藏 0 值扇区。
 - `labelOptions`：标签与引导线细节（格式、线长、颜色等）。
 - `customOption`：ECharts 细节覆盖（标题、提示、图例等）。
+- `showEmptyState`：普通空数据时是否展示统一空状态。
 - `stateConfig`：统一收拢空态文案、空态图和 loading 文案。
 
 推荐结构：
@@ -59,6 +61,8 @@ const stateConfig = {
     text: '饼图加载中...'
   }
 }
+
+const showEmptyState = false
 ```
 
 ## 2.1 3D 依赖说明
@@ -83,8 +87,9 @@ import '@xq-labs/data-ui-v2/pie-chart/3d-runtime'
 
 1. **优先公开 props**：先用 `variant`、`dimension`、`preset`、高度参数表达业务语义。
 2. **其次 `labelOptions`**：标签文案、引导线样式优先在这里完成。
-3. **状态文案统一交给 `stateConfig`**：空态图、空态文案、loading 文案不要分散到多个字段。
-4. **最后 `customOption`**：仅用于补充 ECharts 展示细节。
+3. **按需控制 `showEmptyState`**：需要保留空画布时传 `false`；默认继续展示统一空态。
+4. **状态文案统一交给 `stateConfig`**：空态图、空态文案、loading 文案不要分散到多个字段。
+5. **最后 `customOption`**：仅用于补充 ECharts 展示细节。
 
 不建议业务侧直接拼接或重写内部 `series`，避免覆盖组件内置能力与升级兼容性。
 
@@ -99,6 +104,7 @@ import '@xq-labs/data-ui-v2/pie-chart/3d-runtime'
 1. `PieChart` 会优先显示组件内部错误文案。
 2. `stateConfig.empty.image` 仍然生效。
 3. `stateConfig.loading.text` 仍然生效。
+4. `showEmptyState=false` 也不会关闭这类接入错误提示。
 
 也就是说，业务可以继续自定义空态图，但不能覆盖这类
 “请先在业务页面中执行 `import '@xq-labs/data-ui-v2/pie-chart/3d-runtime'`”提示。
@@ -106,5 +112,5 @@ import '@xq-labs/data-ui-v2/pie-chart/3d-runtime'
 ## 4. 可执行验收要点
 
 - 页面分组名称与路由一致：基础用法、2D 形态、3D 能力、标签与引导线、customOption 与自定义、实验室。
-- 文档示例包含 `hideZeroValueSlices`、`stateConfig` 与 `customOption`。
+- 文档示例包含 `hideZeroValueSlices`、`showEmptyState`、`stateConfig` 与 `customOption`。
 - 文档明确实验室边界与推荐自定义顺序。

package/es/bar-line-chart/index.js

@@ -1,5 +1,5 @@
 import '../../theme-chalk/index.css';
-import { B as BarLineChart } from '../index-914fbae3.js';
+import { B as BarLineChart } from '../index-1e113c13.js';
 import { w as withInstall } from '../with-install-e405b463.js';
 import 'echarts/core';
 import 'echarts/charts';

package/es/{index-914fbae3.js → index-1e113c13.js}

@@ -12,7 +12,8 @@ var DEFAULT_SERIES = {
   kind: 'bar',
   stack: '',
   yAxisIndex: 0,
-  colors: []
+  colors: [],
+  cubeGradientColors: []
 };
 
 /**
@@ -63,7 +64,8 @@ function normalizeBarLineInput(_ref) {
         kind: normalizeKind(item.kind),
         stack: typeof item.stack === 'string' ? item.stack : '',
         yAxisIndex: normalizeYAxisIndex(item.yAxisIndex),
-        colors: normalizeColors(item.colors)
+        colors: normalizeColors(item.colors),
+        cubeGradientColors: normalizeColors(item.cubeGradientColors)
       });
     }),
     rawData: rawData
@@ -958,6 +960,14 @@ function createFaceGradient(x0, y0, x1, y1, startColor, endColor) {
     color: endColor
   }]);
 }
+function resolveCubeGradientFaceColors(seriesItem, colorMap) {
+  var gradientColors = seriesItem && Array.isArray(seriesItem.cubeGradientColors) ? seriesItem.cubeGradientColors : [];
+  return {
+    left: gradientColors[0] || colorMap.left,
+    right: gradientColors[1] || colorMap.right,
+    top: gradientColors[2] || colorMap.top
+  };
+}
 
 /**
  * 创建方柱渲染器。
@@ -971,10 +981,10 @@ function createCubeRenderItem(layout, slotIndex, colorMap, seriesItem) {
     var centerX = centerPoint[0] + offsetX;
     var halfWidth = layout.barWidth / 2;
     var offsetY = Math.tan(Math.PI / 9) * halfWidth;
-    var leftFaceGradient = createFaceGradient(0, 0, 0, 1, colorMap.left, colorMap.left);
-    var rightFaceGradient = createFaceGradient(0, 0, 0, 1, colorMap.right, colorMap.right);
-    var topFaceGradient = createFaceGradient(0, 0, 1, 0, colorMap.top, colorMap.top);
     if (seriesItem && seriesItem.isBackground === true) {
+      var _leftFaceGradient = createFaceGradient(0, 0, 0, 1, colorMap.left, colorMap.left);
+      var _rightFaceGradient = createFaceGradient(0, 0, 0, 1, colorMap.right, colorMap.right);
+      var _topFaceGradient = createFaceGradient(0, 0, 1, 0, colorMap.top, colorMap.top);
       var coordSys = params.coordSys || {};
       var clipX = coordSys.x || 0;
       var _topY = coordSys.y || 0;
@@ -998,7 +1008,7 @@ function createCubeRenderItem(layout, slotIndex, colorMap, seriesItem) {
             points: [[centerX, _topSurfaceY + offsetY - 1], [centerX - halfWidth, _topSurfaceY], [centerX - halfWidth, _baseY - offsetY], [centerX, _baseY - 1]]
           },
           style: {
-            fill: leftFaceGradient
+            fill: _leftFaceGradient
           }
         }, {
           type: 'polygon',
@@ -1006,7 +1016,7 @@ function createCubeRenderItem(layout, slotIndex, colorMap, seriesItem) {
             points: [[centerX, _topSurfaceY + offsetY - 1], [centerX + halfWidth, _topSurfaceY], [centerX + halfWidth, _baseY - offsetY], [centerX, _baseY - 1]]
           },
           style: {
-            fill: rightFaceGradient
+            fill: _rightFaceGradient
           }
         }, {
           type: 'polygon',
@@ -1014,12 +1024,16 @@ function createCubeRenderItem(layout, slotIndex, colorMap, seriesItem) {
             points: [[centerX, _topSurfaceY + offsetY - 1], [centerX + halfWidth, _topSurfaceY], [centerX, _topSurfaceY - offsetY + 1], [centerX - halfWidth, _topSurfaceY]]
           },
           style: {
-            fill: topFaceGradient
+            fill: _topFaceGradient
           },
           z2: 2
         }]
       };
     }
+    var gradientFaceColors = resolveCubeGradientFaceColors(seriesItem, colorMap);
+    var leftFaceGradient = createFaceGradient(0, 0, 0, 1, colorMap.left, gradientFaceColors.left);
+    var rightFaceGradient = createFaceGradient(0, 0, 0, 1, colorMap.right, gradientFaceColors.right);
+    var topFaceGradient = createFaceGradient(0, 0, 1, 0, colorMap.top, gradientFaceColors.top);
     var endValue = api.value(1);
     var baseValue = api.value(2);
     var rawValue = api.value(3);
@@ -1577,6 +1591,7 @@ var script = {
      * - name: 系列名称
      * - kind: bar / line
      * - stack / yAxisIndex / colors: 可选增强配置
+     * - cubeGradientColors: 仅在 `variant="cube"` 时用于前景方柱三个面的渐变终点色
      */
     series: {
       type: Array,
@@ -1667,6 +1682,14 @@ var script = {
       type: Boolean,
       "default": false
     },
+    /**
+     * 是否在数据为空时展示统一空状态。
+     * 关闭后仍会保留图表容器与坐标系渲染，只是不再替换成 BaseEmpty。
+     */
+    showEmptyState: {
+      type: Boolean,
+      "default": true
+    },
     /**
      * 统一状态展示配置。
      * 组件层只负责原样透传给 BaseChart，不参与文案计算。
@@ -1693,6 +1716,12 @@ var script = {
     isEmpty: function isEmpty() {
       return isEmptyData(this.data);
     },
+    /**
+     * 对 BaseChart 的空态展示做一层显式开关控制。
+     */
+    chartEmpty: function chartEmpty() {
+      return this.showEmptyState && this.isEmpty;
+    },
     /**
      * 将公开 props 汇总为 builder 所需输入。
      * 组件层不做类型分发，只负责把标准公开参数交给构建层。
@@ -1715,7 +1744,7 @@ var script = {
   }
 };
 
-var css_248z = "\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n";
+var css_248z = "\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n";
 styleInject(css_248z);
 
 /* script */
@@ -1729,7 +1758,7 @@ var __vue_render__ = function __vue_render__() {
     attrs: {
       option: _vm.chartOption,
       loading: _vm.loading,
-      empty: _vm.isEmpty,
+      empty: _vm.chartEmpty,
       "state-config": _vm.stateConfig,
       height: _vm.height
     },
@@ -1749,7 +1778,7 @@ __vue_render__._withStripped = true;
 /* style */
 var __vue_inject_styles__ = undefined;
 /* scoped */
-var __vue_scope_id__ = "data-v-4e3be95d";
+var __vue_scope_id__ = "data-v-38c7a21f";
 /* module identifier */
 var __vue_module_identifier__ = undefined;
 /* functional template */

package/es/{index-78b6b881.js → index-bf133030.js}

@@ -1141,6 +1141,14 @@ var script = {
       type: Boolean,
       "default": false
     },
+    /**
+     * 是否在普通空数据场景展示统一空状态。
+     * 关闭后仅隐藏“暂无数据”空态，不影响 3D 运行时失败等必须显式提示的错误场景。
+     */
+    showEmptyState: {
+      type: Boolean,
+      "default": true
+    },
     /**
      * 统一状态展示配置。
      * 负责收拢空态文案、空态图片与 loading 文案。
@@ -1204,6 +1212,16 @@ var script = {
     chartEmpty: function chartEmpty() {
       return this.isEmpty || this.is3D && this.echartsGlStatus === 'failed';
     },
+    /**
+     * 传给 BaseChart 的最终空态展示开关。
+     * 普通空数据受 showEmptyState 控制，但 3D 运行时失败提示必须保留。
+     */
+    baseChartEmpty: function baseChartEmpty() {
+      if (this.is3D && this.echartsGlStatus === 'failed') {
+        return true;
+      }
+      return this.showEmptyState && this.chartEmpty;
+    },
     /**
      * 统一归一化传给 BaseChart 的状态配置。
      * 3D 运行时失败时，内部错误文案优先级最高，但仍保留业务自定义图片和 loading 文案。
@@ -1341,7 +1359,7 @@ var script = {
   }
 };
 
-var css_248z = "\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n";
+var css_248z = "\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n";
 styleInject(css_248z);
 
 /* script */
@@ -1355,7 +1373,7 @@ var __vue_render__ = function __vue_render__() {
     attrs: {
       option: _vm.chartOption,
       loading: _vm.chartLoading,
-      empty: _vm.chartEmpty,
+      empty: _vm.baseChartEmpty,
       "state-config": _vm.resolvedStateConfig,
       height: _vm.height
     },
@@ -1373,7 +1391,7 @@ __vue_render__._withStripped = true;
 /* style */
 var __vue_inject_styles__ = undefined;
 /* scoped */
-var __vue_scope_id__ = "data-v-7f129cbd";
+var __vue_scope_id__ = "data-v-18e1c374";
 /* module identifier */
 var __vue_module_identifier__ = undefined;
 /* functional template */

package/es/index.js

@@ -1,7 +1,7 @@
 import '../theme-chalk/index.css';
 import { w as withInstall, B as BaseChart } from './with-install-e405b463.js';
-import { B as BarLineChart } from './index-914fbae3.js';
-import { P as PieChart } from './index-78b6b881.js';
+import { B as BarLineChart } from './index-1e113c13.js';
+import { P as PieChart } from './index-bf133030.js';
 import { R as RadarChart } from './index-788e473f.js';
 import 'echarts/core';
 import 'echarts/charts';

package/es/pie-chart/index.js

@@ -1,5 +1,5 @@
 import '../../theme-chalk/index.css';
-import { P as PieChart } from '../index-78b6b881.js';
+import { P as PieChart } from '../index-bf133030.js';
 import { w as withInstall } from '../with-install-e405b463.js';
 import '../colors-ec0ad9ce.js';
 import 'echarts/core';

package/lib/bar-line-chart/index.js

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 require('../../theme-chalk/index.css');
-var index = require('../index-3d9f6fe7.js');
+var index = require('../index-3dcce54f.js');
 var withInstall = require('../with-install-4304a8ea.js');
 require('echarts/core');
 require('echarts/charts');

package/lib/{index-3d9f6fe7.js → index-3dcce54f.js}

@@ -32,7 +32,8 @@ var DEFAULT_SERIES = {
   kind: 'bar',
   stack: '',
   yAxisIndex: 0,
-  colors: []
+  colors: [],
+  cubeGradientColors: []
 };
 
 /**
@@ -83,7 +84,8 @@ function normalizeBarLineInput(_ref) {
         kind: normalizeKind(item.kind),
         stack: typeof item.stack === 'string' ? item.stack : '',
         yAxisIndex: normalizeYAxisIndex(item.yAxisIndex),
-        colors: normalizeColors(item.colors)
+        colors: normalizeColors(item.colors),
+        cubeGradientColors: normalizeColors(item.cubeGradientColors)
       });
     }),
     rawData: rawData
@@ -978,6 +980,14 @@ function createFaceGradient(x0, y0, x1, y1, startColor, endColor) {
     color: endColor
   }]);
 }
+function resolveCubeGradientFaceColors(seriesItem, colorMap) {
+  var gradientColors = seriesItem && Array.isArray(seriesItem.cubeGradientColors) ? seriesItem.cubeGradientColors : [];
+  return {
+    left: gradientColors[0] || colorMap.left,
+    right: gradientColors[1] || colorMap.right,
+    top: gradientColors[2] || colorMap.top
+  };
+}
 
 /**
  * 创建方柱渲染器。
@@ -991,10 +1001,10 @@ function createCubeRenderItem(layout, slotIndex, colorMap, seriesItem) {
     var centerX = centerPoint[0] + offsetX;
     var halfWidth = layout.barWidth / 2;
     var offsetY = Math.tan(Math.PI / 9) * halfWidth;
-    var leftFaceGradient = createFaceGradient(0, 0, 0, 1, colorMap.left, colorMap.left);
-    var rightFaceGradient = createFaceGradient(0, 0, 0, 1, colorMap.right, colorMap.right);
-    var topFaceGradient = createFaceGradient(0, 0, 1, 0, colorMap.top, colorMap.top);
     if (seriesItem && seriesItem.isBackground === true) {
+      var _leftFaceGradient = createFaceGradient(0, 0, 0, 1, colorMap.left, colorMap.left);
+      var _rightFaceGradient = createFaceGradient(0, 0, 0, 1, colorMap.right, colorMap.right);
+      var _topFaceGradient = createFaceGradient(0, 0, 1, 0, colorMap.top, colorMap.top);
       var coordSys = params.coordSys || {};
       var clipX = coordSys.x || 0;
       var _topY = coordSys.y || 0;
@@ -1018,7 +1028,7 @@ function createCubeRenderItem(layout, slotIndex, colorMap, seriesItem) {
             points: [[centerX, _topSurfaceY + offsetY - 1], [centerX - halfWidth, _topSurfaceY], [centerX - halfWidth, _baseY - offsetY], [centerX, _baseY - 1]]
           },
           style: {
-            fill: leftFaceGradient
+            fill: _leftFaceGradient
           }
         }, {
           type: 'polygon',
@@ -1026,7 +1036,7 @@ function createCubeRenderItem(layout, slotIndex, colorMap, seriesItem) {
             points: [[centerX, _topSurfaceY + offsetY - 1], [centerX + halfWidth, _topSurfaceY], [centerX + halfWidth, _baseY - offsetY], [centerX, _baseY - 1]]
           },
           style: {
-            fill: rightFaceGradient
+            fill: _rightFaceGradient
           }
         }, {
           type: 'polygon',
@@ -1034,12 +1044,16 @@ function createCubeRenderItem(layout, slotIndex, colorMap, seriesItem) {
             points: [[centerX, _topSurfaceY + offsetY - 1], [centerX + halfWidth, _topSurfaceY], [centerX, _topSurfaceY - offsetY + 1], [centerX - halfWidth, _topSurfaceY]]
           },
           style: {
-            fill: topFaceGradient
+            fill: _topFaceGradient
           },
           z2: 2
         }]
       };
     }
+    var gradientFaceColors = resolveCubeGradientFaceColors(seriesItem, colorMap);
+    var leftFaceGradient = createFaceGradient(0, 0, 0, 1, colorMap.left, gradientFaceColors.left);
+    var rightFaceGradient = createFaceGradient(0, 0, 0, 1, colorMap.right, gradientFaceColors.right);
+    var topFaceGradient = createFaceGradient(0, 0, 1, 0, colorMap.top, gradientFaceColors.top);
     var endValue = api.value(1);
     var baseValue = api.value(2);
     var rawValue = api.value(3);
@@ -1597,6 +1611,7 @@ var script = {
      * - name: 系列名称
      * - kind: bar / line
      * - stack / yAxisIndex / colors: 可选增强配置
+     * - cubeGradientColors: 仅在 `variant="cube"` 时用于前景方柱三个面的渐变终点色
      */
     series: {
       type: Array,
@@ -1687,6 +1702,14 @@ var script = {
       type: Boolean,
       "default": false
     },
+    /**
+     * 是否在数据为空时展示统一空状态。
+     * 关闭后仍会保留图表容器与坐标系渲染，只是不再替换成 BaseEmpty。
+     */
+    showEmptyState: {
+      type: Boolean,
+      "default": true
+    },
     /**
      * 统一状态展示配置。
      * 组件层只负责原样透传给 BaseChart，不参与文案计算。
@@ -1713,6 +1736,12 @@ var script = {
     isEmpty: function isEmpty() {
       return colors.isEmptyData(this.data);
     },
+    /**
+     * 对 BaseChart 的空态展示做一层显式开关控制。
+     */
+    chartEmpty: function chartEmpty() {
+      return this.showEmptyState && this.isEmpty;
+    },
     /**
      * 将公开 props 汇总为 builder 所需输入。
      * 组件层不做类型分发，只负责把标准公开参数交给构建层。
@@ -1735,7 +1764,7 @@ var script = {
   }
 };
 
-var css_248z = "\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n";
+var css_248z = "\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n";
 withInstall.styleInject(css_248z);
 
 /* script */
@@ -1749,7 +1778,7 @@ var __vue_render__ = function __vue_render__() {
     attrs: {
       option: _vm.chartOption,
       loading: _vm.loading,
-      empty: _vm.isEmpty,
+      empty: _vm.chartEmpty,
       "state-config": _vm.stateConfig,
       height: _vm.height
     },
@@ -1769,7 +1798,7 @@ __vue_render__._withStripped = true;
 /* style */
 var __vue_inject_styles__ = undefined;
 /* scoped */
-var __vue_scope_id__ = "data-v-4e3be95d";
+var __vue_scope_id__ = "data-v-38c7a21f";
 /* module identifier */
 var __vue_module_identifier__ = undefined;
 /* functional template */

package/lib/{index-a0ecafa1.js → index-812cae02.js}

@@ -1161,6 +1161,14 @@ var script = {
       type: Boolean,
       "default": false
     },
+    /**
+     * 是否在普通空数据场景展示统一空状态。
+     * 关闭后仅隐藏“暂无数据”空态，不影响 3D 运行时失败等必须显式提示的错误场景。
+     */
+    showEmptyState: {
+      type: Boolean,
+      "default": true
+    },
     /**
      * 统一状态展示配置。
      * 负责收拢空态文案、空态图片与 loading 文案。
@@ -1224,6 +1232,16 @@ var script = {
     chartEmpty: function chartEmpty() {
       return this.isEmpty || this.is3D && this.echartsGlStatus === 'failed';
     },
+    /**
+     * 传给 BaseChart 的最终空态展示开关。
+     * 普通空数据受 showEmptyState 控制，但 3D 运行时失败提示必须保留。
+     */
+    baseChartEmpty: function baseChartEmpty() {
+      if (this.is3D && this.echartsGlStatus === 'failed') {
+        return true;
+      }
+      return this.showEmptyState && this.chartEmpty;
+    },
     /**
      * 统一归一化传给 BaseChart 的状态配置。
      * 3D 运行时失败时，内部错误文案优先级最高，但仍保留业务自定义图片和 loading 文案。
@@ -1361,7 +1379,7 @@ var script = {
   }
 };
 
-var css_248z = "\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n";
+var css_248z = "\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n";
 withInstall.styleInject(css_248z);
 
 /* script */
@@ -1375,7 +1393,7 @@ var __vue_render__ = function __vue_render__() {
     attrs: {
       option: _vm.chartOption,
       loading: _vm.chartLoading,
-      empty: _vm.chartEmpty,
+      empty: _vm.baseChartEmpty,
       "state-config": _vm.resolvedStateConfig,
       height: _vm.height
     },
@@ -1393,7 +1411,7 @@ __vue_render__._withStripped = true;
 /* style */
 var __vue_inject_styles__ = undefined;
 /* scoped */
-var __vue_scope_id__ = "data-v-7f129cbd";
+var __vue_scope_id__ = "data-v-18e1c374";
 /* module identifier */
 var __vue_module_identifier__ = undefined;
 /* functional template */

package/lib/index.js

@@ -4,8 +4,8 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 require('../theme-chalk/index.css');
 var withInstall = require('./with-install-4304a8ea.js');
-var index$1 = require('./index-3d9f6fe7.js');
-var index$2 = require('./index-a0ecafa1.js');
+var index$1 = require('./index-3dcce54f.js');
+var index$2 = require('./index-812cae02.js');
 var index$3 = require('./index-6039f724.js');
 require('echarts/core');
 require('echarts/charts');

package/lib/pie-chart/index.js

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 require('../../theme-chalk/index.css');
-var index = require('../index-a0ecafa1.js');
+var index = require('../index-812cae02.js');
 var withInstall = require('../with-install-4304a8ea.js');
 require('../colors-19a7242d.js');
 require('echarts/core');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xq-labs/data-ui-v2",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "main": "lib/index.js",
   "module": "es/index.js",
   "style": "theme-chalk/index.css",