@xq-labs/data-ui-v2 0.2.0 → 0.3.0

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

@@ -1,9 +1,10 @@
-import { _ as _objectSpread2, D as DEFAULT_COLORS, a as _toConsumableArray, m as mergeChartOption, i as isEmptyData } from './colors-ca059479.js';
+import { _ as _objectSpread2, D as DEFAULT_COLORS, a as _toConsumableArray, m as mergeChartOption, i as isEmptyData } from './colors-ec0ad9ce.js';
 import * as echarts from 'echarts/core';
+import { SeriesModel } from 'echarts/core';
 import { PieChart as PieChart$1 } from 'echarts/charts';
 import { TooltipComponent, LegendComponent, GridComponent, TitleComponent, GraphicComponent } from 'echarts/components';
 import { CanvasRenderer } from 'echarts/renderers';
-import { B as BaseChart, s as styleInject, n as normalizeComponent } from './with-install-befebea5.js';
+import { B as BaseChart, s as styleInject, n as normalizeComponent } from './with-install-e405b463.js';
 
 /**
  * 将输入值转换为安全数值。
@@ -69,10 +70,11 @@ var PIE_HEIGHT_MODE = {
   VALUE: 'value'
 };
 var DEFAULT_HEIGHT_RANGE = {
-  min: 20,
-  max: 80
+  min: 10,
+  max: 25
 };
-var DEFAULT_3D_VIEW_ALPHA = 28;
+var DEFAULT_3D_VIEW_DISTANCE = 120;
+var DEFAULT_3D_VIEW_ALPHA = 55;
 var DEFAULT_INTERNAL_DIAMETER_RATIO = 0.6;
 var DEFAULT_ROSE_RADIUS_RANGE = [0.75, 1.15];
 var DEFAULT_LABEL_OPTIONS = {
@@ -90,6 +92,17 @@ var DEFAULT_LABEL_OPTIONS = {
   verticalGap: 8,
   radialOffset: 0.12
 };
+var DEFAULT_TOOLTIP_STYLE = {
+  backgroundColor: '#fff',
+  borderColor: 'transparent',
+  borderWidth: 0,
+  padding: [8, 12],
+  textStyle: {
+    color: '#333',
+    fontSize: 12
+  },
+  extraCssText: 'box-shadow: 0 2px 8px rgba(0, 0, 0, 0.15); border-radius: 4px;'
+};
 
 /**
  * 将输入值转为安全数字。
@@ -196,6 +209,9 @@ function buildPieChartData(data) {
 function replaceLabelTemplate(template, params) {
   return template.replace(/\{b\}/g, params.name).replace(/\{c\}/g, params.value).replace(/\{d\}/g, params.percent);
 }
+function escapeTooltipHtml(value) {
+  return String(value).replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;').replace(/'/g, '&#39;');
+}
 function formatPieLabelText(formatter, params) {
   if (typeof formatter === 'function') {
     return formatter(params);
@@ -205,29 +221,65 @@ function formatPieLabelText(formatter, params) {
   }
   return "".concat(params.name, "\n").concat(params.percent, "%");
 }
+function createFallbackTooltipMarker(color) {
+  var markerColor = escapeTooltipHtml(color || '#6B98F8');
+  return "<span style=\"display:inline-block;margin-right:4px;border-radius:50%;width:10px;height:10px;background-color:".concat(markerColor, ";\"></span>");
+}
+function formatPieTooltipContent(_ref) {
+  var marker = _ref.marker,
+    name = _ref.name,
+    value = _ref.value,
+    color = _ref.color;
+  var safeMarker = marker || createFallbackTooltipMarker(color);
+  return "".concat(safeMarker).concat(escapeTooltipHtml(name), ":").concat(escapeTooltipHtml(value));
+}
+
+/**
+ * 创建饼图统一 hover tooltip 样式。
+ * 默认呈现为白底阴影卡片，内容为“彩色圆点 + 名称:值”，贴近业务看板常见展示形态。
+ */
+function createPieTooltipOption(formatter) {
+  return _objectSpread2(_objectSpread2({}, DEFAULT_TOOLTIP_STYLE), {}, {
+    formatter: formatter
+  });
+}
+function formatPie2DTooltip() {
+  var params = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
+  return formatPieTooltipContent({
+    marker: params.marker,
+    name: params.name === undefined ? '' : params.name,
+    value: params.value === undefined ? '' : params.value,
+    color: params.color
+  });
+}
 
 /**
  * 格式化 3D 饼图默认 tooltip 文案。
  * surface 系列 hover 时拿到的 `params.value` 实际是参数方程采样值，
  * 不能直接当业务值展示，因此统一回退到扇区自身的 `pieData`。
  */
-function formatPieTooltipText(name, value, percent) {
-  return "".concat(name, ": ").concat(value, " (").concat(percent, "%)");
+function formatPie3DTooltip(params, pieData) {
+  return formatPieTooltipContent({
+    marker: params && params.marker,
+    name: pieData && pieData.name !== undefined ? pieData.name : '',
+    value: pieData && pieData.value !== undefined ? pieData.value : 0,
+    color: pieData && pieData.itemStyle && pieData.itemStyle.color
+  });
 }
 
 /**
  * 为单个 3D 扇区生成专用 tooltip。
  * 这样即使鼠标落在 surface 网格采样点上，展示的仍然是业务名称、原始值与百分比。
  */
-function createPie3DTooltip(pieData, totalValue) {
+function createPie3DTooltip(pieData) {
   var value = toNumber(pieData && pieData.value, 0);
-  var percent = totalValue > 0 ? Number((value / totalValue * 100).toFixed(2)) : 0;
   var name = pieData && pieData.name !== undefined ? pieData.name : '';
-  return {
-    formatter: function formatter() {
-      return formatPieTooltipText(name, value, percent);
-    }
-  };
+  return createPieTooltipOption(function (params) {
+    return formatPie3DTooltip(params, _objectSpread2(_objectSpread2({}, pieData), {}, {
+      name: name,
+      value: value
+    }));
+  });
 }
 function multiplyMat4Vec4(matrix, vector) {
   return [matrix[0] * vector[0] + matrix[4] * vector[1] + matrix[8] * vector[2] + matrix[12] * vector[3], matrix[1] * vector[0] + matrix[5] * vector[1] + matrix[9] * vector[2] + matrix[13] * vector[3], matrix[2] * vector[0] + matrix[6] * vector[1] + matrix[10] * vector[2] + matrix[14] * vector[3], matrix[3] * vector[0] + matrix[7] * vector[1] + matrix[11] * vector[2] + matrix[15] * vector[3]];
@@ -436,11 +488,9 @@ function createHeightValues(values, mode, minHeight, maxHeight) {
   }
   return mapValueToRange(values, safeMinHeight, safeMaxHeight);
 }
-function createAdaptiveViewControl(showLabelLine, maxHeight) {
-  var baseDistance = showLabelLine ? 175 : 180;
-  var extraDistance = Math.max(0, maxHeight - 200) * 0.18;
+function createDefaultViewControl() {
   return {
-    distance: baseDistance + extraDistance,
+    distance: DEFAULT_3D_VIEW_DISTANCE,
     alpha: DEFAULT_3D_VIEW_ALPHA
   };
 }
@@ -577,9 +627,6 @@ function buildPie3DSeries(pieData) {
   var valueList = renderPieData.map(function (item) {
     return Math.max(0, toNumber(item.value, 0));
   });
-  var totalValue = valueList.reduce(function (sum, value) {
-    return sum + value;
-  }, 0);
   var angleValueList = getAngleValueList(valueList);
   var totalAngleValue = angleValueList.reduce(function (sum, value) {
     return sum + value;
@@ -613,7 +660,7 @@ function buildPie3DSeries(pieData) {
         selected: false,
         hovered: false
       },
-      tooltip: createPie3DTooltip(item, totalValue),
+      tooltip: createPie3DTooltip(item),
       itemStyle: _objectSpread2({}, item.itemStyle),
       parametricEquation: getParametricEquation(startRatio, endRatio, false, false, geometry)
     };
@@ -708,7 +755,7 @@ function createPie3DOption(input, variant) {
     hideZeroValueSlices: input.hideZeroValueSlices !== false
   };
   var pie3D = buildPie3DSeries(data, chartConfig);
-  var viewControl = createAdaptiveViewControl(chartConfig.showLabelLine, safeMaxHeight);
+  var viewControl = createDefaultViewControl();
   return {
     xAxis3D: {
       min: -pie3D.axisLimit,
@@ -895,10 +942,9 @@ function buildPieOption() {
   });
   var baseOption = {
     color: DEFAULT_COLORS,
-    tooltip: {
-      trigger: 'item',
-      formatter: '{b}: {c} ({d}%)'
-    },
+    tooltip: _objectSpread2({
+      trigger: 'item'
+    }, createPieTooltipOption(formatPie2DTooltip)),
     legend: {
       data: normalizedData.map(function (item) {
         return item.name;
@@ -927,33 +973,26 @@ function buildPieOption() {
   return mergeChartOption(mergeChartOption(baseOption, presetOption, variantOption), customOption);
 }
 
-var runtimePromise = null;
-var ECHARTS_GL_PACKAGE_NAME = 'echarts-gl';
-var MISSING_RUNTIME_MESSAGE = '使用 PieChart 3D 能力需要安装 echarts-gl，请执行 npm install echarts-gl。';
-var createMissingRuntimeError = function createMissingRuntimeError(error) {
-  var runtimeError = new Error(MISSING_RUNTIME_MESSAGE);
-  runtimeError.cause = error;
-  return runtimeError;
-};
-var importRuntime = function importRuntime() {
-  var dynamicImport = new Function('packageName', 'return import(packageName)');
-  return dynamicImport(ECHARTS_GL_PACKAGE_NAME);
+var SURFACE_SERIES_TYPE = 'series.surface';
+var MISSING_RUNTIME_MESSAGE = "使用 PieChart 3D 能力前，请先在业务页面中执行 import '@xq-labs/data-ui-v2/pie-chart/3d-runtime'。";
+var hasSurfaceSeriesRuntime = function hasSurfaceSeriesRuntime() {
+  return SeriesModel && (typeof SeriesModel.getClass === 'function' && !!SeriesModel.getClass('series', 'surface') || typeof SeriesModel.getClassesByMainType === 'function' && SeriesModel.getClassesByMainType('series').some(function (seriesClass) {
+    return seriesClass && seriesClass.type === SURFACE_SERIES_TYPE;
+  }));
 };
 
 /**
- * 按需加载 echarts-gl 运行时。
+ * 检测 PieChart 3D 运行时是否已经由业务项目接入。
  *
- * 这里不能在模块顶层静态加载 echarts-gl，否则只使用 2D 饼图的业务方也会被迫安装。
- * 加载结果会被缓存，避免同一个页面内多个 3D 饼图重复触发运行时加载。
+ * 方案 B 修订版下，组件库不再负责动态加载 `echarts-gl`，
+ * 而是要求业务项目在使用 3D PieChart 的页面中显式执行桥接入口：
+ * `import '@xq-labs/data-ui-v2/pie-chart/3d-runtime'`
  */
 function ensureEchartsGlRuntime() {
-  if (!runtimePromise) {
-    runtimePromise = importRuntime()["catch"](function (error) {
-      runtimePromise = null;
-      throw createMissingRuntimeError(error);
-    });
+  if (hasSurfaceSeriesRuntime()) {
+    return Promise.resolve();
   }
-  return runtimePromise;
+  return Promise.reject(new Error(MISSING_RUNTIME_MESSAGE));
 }
 
 echarts.use([PieChart$1, TooltipComponent, LegendComponent, GridComponent, TitleComponent, GraphicComponent, CanvasRenderer]);
@@ -1028,7 +1067,7 @@ var script = {
      */
     minHeight: {
       type: Number,
-      "default": 20
+      "default": 10
     },
     /**
      * 3D 模式下的最大扇区高度。
@@ -1036,7 +1075,7 @@ var script = {
      */
     maxHeight: {
       type: Number,
-      "default": 80
+      "default": 25
     },
     /**
      * 环图内径比例。
@@ -1096,12 +1135,22 @@ var script = {
     },
     /**
      * 图表 loading 状态。
-     * 由底层 BaseChart 统一负责 showLoading / hideLoading。
+     * 由底层 BaseChart 统一负责组件层遮罩式 loading UI。
      */
     loading: {
       type: Boolean,
       "default": false
     },
+    /**
+     * 统一状态展示配置。
+     * 负责收拢空态文案、空态图片与 loading 文案。
+     */
+    stateConfig: {
+      type: Object,
+      "default": function _default() {
+        return {};
+      }
+    },
     /**
      * 图表容器高度。
      * 支持数字（按 px 处理）或原样透传的字符串高度值。
@@ -1129,13 +1178,13 @@ var script = {
     },
     /**
      * 判断当前是否进入 3D 饼图能力。
-     * 只有 3D 才需要加载 echarts-gl，2D 场景不应触发任何 3D 运行时依赖。
+     * 只有 3D 才需要 echarts-gl 桥接入口，2D 场景不应触发任何 3D 运行时依赖。
      */
     is3D: function is3D() {
       return this.dimension === '3d';
     },
     /**
-     * 标识 echarts-gl 是否已经加载完成。
+     * 标识 echarts-gl 运行时是否已经注册完成。
      * 3D option 只有在运行时就绪后才会生成 surface 序列。
      */
     isEchartsGlReady: function isEchartsGlReady() {
@@ -1143,27 +1192,38 @@ var script = {
     },
     /**
      * 汇总外部 loading 与 3D 运行时加载状态。
-     * 这样 3D 首次加载 echarts-gl 时，底层 BaseChart 能保持 loading 态。
+     * 这样 3D 首次检测运行时期间，底层 BaseChart 能保持 loading 态。
      */
     chartLoading: function chartLoading() {
       return this.loading || this.is3D && this.echartsGlStatus === 'loading';
     },
     /**
      * 汇总数据空态与 3D 运行时失败状态。
-     * 缺少 echarts-gl 时不让 BaseChart 继续渲染空 surface option。
+     * 缺少 3D 桥接运行时时不让 BaseChart 继续渲染空 surface option。
      */
     chartEmpty: function chartEmpty() {
       return this.isEmpty || this.is3D && this.echartsGlStatus === 'failed';
     },
     /**
-     * 统一传给 BaseChart 的空态文案。
-     * 3D 缺少运行时时给出可执行的安装提示，普通空态仍保留默认文案。
+     * 统一归一化传给 BaseChart 的状态配置。
+     * 3D 运行时失败时，内部错误文案优先级最高，但仍保留业务自定义图片和 loading 文案。
      */
-    chartEmptyText: function chartEmptyText() {
+    resolvedStateConfig: function resolvedStateConfig() {
+      var stateConfig = this.stateConfig || {};
+      var emptyConfig = stateConfig.empty || {};
+      var loadingConfig = stateConfig.loading || {};
       if (this.is3D && this.echartsGlStatus === 'failed') {
-        return this.echartsGlErrorMessage || '使用 3D 饼图需要安装 echarts-gl';
+        return {
+          empty: _objectSpread2(_objectSpread2({}, emptyConfig), {}, {
+            text: this.echartsGlErrorMessage || "使用 PieChart 3D 能力前，请先在业务页面中执行 import '@xq-labs/data-ui-v2/pie-chart/3d-runtime'。"
+          }),
+          loading: _objectSpread2({}, loadingConfig)
+        };
       }
-      return '暂无数据';
+      return {
+        empty: _objectSpread2({}, emptyConfig),
+        loading: _objectSpread2({}, loadingConfig)
+      };
     },
     /**
      * 将组件公开 props 统一汇总后交给 builder。
@@ -1195,7 +1255,7 @@ var script = {
   watch: {
     /**
      * dimension 是 2D/3D 分发的公开开关。
-     * 只有切到 3D 时才按需加载 echarts-gl，避免 2D 使用方被迫安装 3D 运行时。
+     * 只有切到 3D 时才检测 3D 运行时，避免 2D 使用方被迫安装 3D 运行时。
      */
     dimension: {
       immediate: true,
@@ -1227,7 +1287,7 @@ var script = {
       this.$emit('ready', chart);
     },
     /**
-     * 在真正进入 3D 能力时按需加载 echarts-gl。
+     * 在真正进入 3D 能力时检测 echarts-gl 桥接入口是否已经注册。
      *
      * 返回 Promise 是为了让单测和后续业务扩展能准确等待状态变化；
      * 2D、已就绪、加载中三种场景会直接返回 resolved Promise。
@@ -1243,7 +1303,7 @@ var script = {
         _this.echartsGlStatus = 'ready';
       })["catch"](function (error) {
         _this.echartsGlStatus = 'failed';
-        _this.echartsGlErrorMessage = error && error.message ? error.message : '使用 3D 饼图需要安装 echarts-gl';
+        _this.echartsGlErrorMessage = error && error.message ? error.message : "使用 PieChart 3D 能力前，请先在业务页面中执行 import '@xq-labs/data-ui-v2/pie-chart/3d-runtime'。";
         _this.$emit('runtime-error', error);
       });
     },
@@ -1281,7 +1341,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";
+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";
 styleInject(css_248z);
 
 /* script */
@@ -1296,7 +1356,7 @@ var __vue_render__ = function __vue_render__() {
       option: _vm.chartOption,
       loading: _vm.chartLoading,
       empty: _vm.chartEmpty,
-      "empty-text": _vm.chartEmptyText,
+      "state-config": _vm.resolvedStateConfig,
       height: _vm.height
     },
     on: {
@@ -1313,7 +1373,7 @@ __vue_render__._withStripped = true;
 /* style */
 var __vue_inject_styles__ = undefined;
 /* scoped */
-var __vue_scope_id__ = "data-v-815905b6";
+var __vue_scope_id__ = "data-v-7f129cbd";
 /* module identifier */
 var __vue_module_identifier__ = undefined;
 /* functional template */

package/es/{index-6128787e.js → index-d01ce220.js}

@@ -1,10 +1,10 @@
 import * as echarts from 'echarts/core';
 import { graphic } from 'echarts/core';
 import { BarChart, LineChart, CustomChart } from 'echarts/charts';
-import { TooltipComponent, LegendComponent, GridComponent, TitleComponent } from 'echarts/components';
+import { TooltipComponent, LegendComponent, GridComponent, TitleComponent, DataZoomComponent } from 'echarts/components';
 import { CanvasRenderer } from 'echarts/renderers';
-import { B as BaseChart, s as styleInject, n as normalizeComponent } from './with-install-befebea5.js';
-import { _ as _objectSpread2, D as DEFAULT_COLORS, a as _toConsumableArray, m as mergeChartOption, i as isEmptyData } from './colors-ca059479.js';
+import { B as BaseChart, s as styleInject, n as normalizeComponent } from './with-install-e405b463.js';
+import { _ as _objectSpread2, D as DEFAULT_COLORS, a as _toConsumableArray, m as mergeChartOption, b as _typeof, i as isEmptyData } from './colors-ec0ad9ce.js';
 
 var DEFAULT_SERIES = {
   key: 'value',
@@ -1059,6 +1059,8 @@ function createCylinderBarLineOption(normalizedInput) {
 }
 
 var DEFAULT_VARIANT = 'flat';
+var DEFAULT_X_AXIS_SCROLL_VISIBLE_COUNT = 8;
+var DEFAULT_X_AXIS_SCROLL_GRID_BOTTOM = 56;
 var BAR_LINE_PUBLIC_VARIANTS = ['flat', 'cylinder', 'cube'];
 
 // 公开 variant 能力在此处收口：只允许 flat / cylinder / cube。
@@ -1104,6 +1106,93 @@ function createBaseOption(normalizedInput) {
     }
   };
 }
+function isValidNumber(value) {
+  return Number.isFinite(Number(value));
+}
+function normalizePositiveInteger(value, fallback) {
+  var normalizedValue = Number(value);
+  if (!Number.isFinite(normalizedValue) || normalizedValue <= 0) {
+    return fallback;
+  }
+  return Math.floor(normalizedValue);
+}
+function normalizeStartIndex(startIndex) {
+  if (!isValidNumber(startIndex)) {
+    return null;
+  }
+  var normalizedStartIndex = Math.floor(Number(startIndex));
+  return normalizedStartIndex >= 0 ? normalizedStartIndex : null;
+}
+function toPercent(value, total) {
+  return Number((value / total * 100).toFixed(2));
+}
+
+/**
+ * 归一化横轴滚动配置。
+ * 该配置只服务 X 轴类目过多的场景，不扩展 Y 轴滚动，避免 API 语义变复杂。
+ */
+function normalizeXAxisScrollConfig() {
+  var xAxisScroll = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
+  var scrollConfig = xAxisScroll && _typeof(xAxisScroll) === 'object' ? xAxisScroll : {};
+  return {
+    enabled: scrollConfig.enabled === true,
+    visibleCount: normalizePositiveInteger(scrollConfig.visibleCount, DEFAULT_X_AXIS_SCROLL_VISIBLE_COUNT),
+    startPosition: scrollConfig.startPosition === 'start' ? 'start' : 'end',
+    startIndex: normalizeStartIndex(scrollConfig.startIndex),
+    showSlider: scrollConfig.showSlider !== false,
+    inside: scrollConfig.inside !== false
+  };
+}
+
+/**
+ * 根据横轴类目数量生成 ECharts dataZoom。
+ * 默认从末尾向前取 `visibleCount` 个类目，满足“最新数据优先展示”的看板诉求。
+ */
+function createXAxisScrollOption() {
+  var categories = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : [];
+  var xAxisScroll = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+  var scrollConfig = normalizeXAxisScrollConfig(xAxisScroll);
+  var totalCount = Array.isArray(categories) ? categories.length : 0;
+  if (!scrollConfig.enabled || totalCount <= scrollConfig.visibleCount) {
+    return {};
+  }
+  var windowSize = Math.min(scrollConfig.visibleCount, totalCount);
+  var maxStartIndex = totalCount - windowSize;
+  var resolvedStartIndex = scrollConfig.startIndex !== null ? Math.min(scrollConfig.startIndex, maxStartIndex) : scrollConfig.startPosition === 'start' ? 0 : maxStartIndex;
+  var start = toPercent(resolvedStartIndex, totalCount);
+  var end = toPercent(resolvedStartIndex + windowSize, totalCount);
+  var dataZoom = [];
+  if (scrollConfig.showSlider) {
+    dataZoom.push({
+      type: 'slider',
+      xAxisIndex: 0,
+      start: start,
+      end: end,
+      height: 14,
+      bottom: 8,
+      brushSelect: false
+    });
+  }
+  if (scrollConfig.inside) {
+    dataZoom.push({
+      type: 'inside',
+      xAxisIndex: 0,
+      start: start,
+      end: end,
+      zoomLock: true
+    });
+  }
+  if (dataZoom.length === 0) {
+    return {};
+  }
+  return _objectSpread2(_objectSpread2({}, scrollConfig.showSlider ? {
+    grid: {
+      bottom: DEFAULT_X_AXIS_SCROLL_GRID_BOTTOM
+    }
+  } : {}), {}, {
+    dataZoom: dataZoom
+  });
+}
 
 /**
  * 构建 `BarLineChart` 最终 option。
@@ -1111,7 +1200,8 @@ function createBaseOption(normalizedInput) {
  * 1. 输入归一化
  * 2. preset 合并
  * 3. 变体分发
- * 4. customOption 覆盖
+ * 4. X 轴滚动配置合并
+ * 5. customOption 覆盖
  */
 function buildBarLineOption() {
   var _ref = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {},
@@ -1124,6 +1214,7 @@ function buildBarLineOption() {
     variant = _ref$variant === void 0 ? 'flat' : _ref$variant,
     barWidth = _ref.barWidth,
     barGap = _ref.barGap,
+    xAxisScroll = _ref.xAxisScroll,
     customOption = _ref.customOption;
   var normalizedInput = normalizeBarLineInput({
     data: data,
@@ -1139,7 +1230,8 @@ function buildBarLineOption() {
     barWidth: barWidth,
     barGap: barGap
   }));
-  return mergeChartOption(mergeChartOption(baseOption, presetOption, variantOption), customOption);
+  var xAxisScrollOption = createXAxisScrollOption(normalizedInput.categories, xAxisScroll);
+  return mergeChartOption(mergeChartOption(mergeChartOption(baseOption, presetOption, variantOption), xAxisScrollOption), customOption);
 }
 
 //
@@ -1153,6 +1245,7 @@ function buildBarLineOption() {
 //
 //
 //
+//
 
 
 /**
@@ -1160,7 +1253,7 @@ function buildBarLineOption() {
  * 这里显式注册柱图、折线图、自定义系列以及笛卡尔坐标系常用组件，
  * 否则运行时虽然能生成 option，但对应主类型不会真正参与渲染。
  */
-echarts.use([BarChart, LineChart, CustomChart, TooltipComponent, LegendComponent, GridComponent, TitleComponent, CanvasRenderer]);
+echarts.use([BarChart, LineChart, CustomChart, TooltipComponent, LegendComponent, GridComponent, TitleComponent, DataZoomComponent, CanvasRenderer]);
 var script = {
   name: 'BarLineChart',
   components: {
@@ -1247,14 +1340,40 @@ var script = {
         return {};
       }
     },
+    /**
+     * X 轴类目滚动配置。
+     * 仅控制横轴，不扩展 Y 轴；适合月份、日期、地区等类目数量较多的看板场景。
+     * 常用字段：
+     * - enabled: 是否开启 X 轴滚动
+     * - visibleCount: 初始窗口内展示的类目数量，默认按 8 个处理
+     * - startPosition: 初始窗口位置，默认 end，即展示最新一段数据
+     * - startIndex: 指定窗口起始索引；传入合法数字时优先级高于 startPosition
+     * - showSlider / inside: 分别控制底部滚动条与图表内部滚轮/触控滚动
+     */
+    xAxisScroll: {
+      type: Object,
+      "default": function _default() {
+        return {};
+      }
+    },
     /**
      * 图表 loading 状态。
-     * 由 BaseChart 统一接管具体的 loading UI。
+     * 由 BaseChart 统一接管组件层遮罩式 loading UI。
      */
     loading: {
       type: Boolean,
       "default": false
     },
+    /**
+     * 统一状态展示配置。
+     * 组件层只负责原样透传给 BaseChart，不参与文案计算。
+     */
+    stateConfig: {
+      type: Object,
+      "default": function _default() {
+        return {};
+      }
+    },
     /**
      * 图表容器高度。
      * 支持数字像素值或原样透传的 CSS 高度字符串。
@@ -1285,13 +1404,14 @@ var script = {
         preset: this.preset,
         barWidth: this.barWidth,
         barGap: this.barGap,
+        xAxisScroll: this.xAxisScroll,
         customOption: this.customOption
       });
     }
   }
 };
 
-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";
+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";
 styleInject(css_248z);
 
 /* script */
@@ -1306,6 +1426,7 @@ var __vue_render__ = function __vue_render__() {
       option: _vm.chartOption,
       loading: _vm.loading,
       empty: _vm.isEmpty,
+      "state-config": _vm.stateConfig,
       height: _vm.height
     },
     on: {
@@ -1324,7 +1445,7 @@ __vue_render__._withStripped = true;
 /* style */
 var __vue_inject_styles__ = undefined;
 /* scoped */
-var __vue_scope_id__ = "data-v-e33b855e";
+var __vue_scope_id__ = "data-v-0c9a6292";
 /* module identifier */
 var __vue_module_identifier__ = undefined;
 /* functional template */

package/es/index.js

@@ -1,17 +1,19 @@
 import '../theme-chalk/index.css';
-import { w as withInstall, B as BaseChart } from './with-install-befebea5.js';
-import { B as BarLineChart } from './index-6128787e.js';
-import { P as PieChart } from './index-6af2ada7.js';
+import { w as withInstall, B as BaseChart } from './with-install-e405b463.js';
+import { B as BarLineChart } from './index-d01ce220.js';
+import { P as PieChart } from './index-78b6b881.js';
+import { R as RadarChart } from './index-788e473f.js';
 import 'echarts/core';
 import 'echarts/charts';
 import 'echarts/components';
 import 'echarts/renderers';
-import './colors-ca059479.js';
+import './colors-ec0ad9ce.js';
 
 withInstall(BaseChart);
 withInstall(BarLineChart);
 withInstall(PieChart);
-var components = [BaseChart, BarLineChart, PieChart];
+withInstall(RadarChart);
+var components = [BaseChart, BarLineChart, PieChart, RadarChart];
 
 // 发布根入口复用组件清单，确保与 src/index.js 行为一致。
 var install = function install(Vue) {
@@ -23,4 +25,4 @@ var index = {
   install: install
 };
 
-export { BarLineChart, BaseChart, PieChart, index as default, install };
+export { BarLineChart, BaseChart, PieChart, RadarChart, index as default, install };

package/es/pie-chart/3d-runtime.js

@@ -0,0 +1,6 @@
+import * as echarts from 'echarts/core';
+import { SurfaceChart } from 'echarts-gl/charts';
+import { Grid3DComponent } from 'echarts-gl/components';
+
+// PieChart 3D 只需要 surface 序列与 grid3D 坐标系，显式注册到组件库同一个 echarts/core 实例。
+echarts.use([SurfaceChart, Grid3DComponent]);

package/es/pie-chart/index.js

@@ -1,7 +1,7 @@
 import '../../theme-chalk/index.css';
-import { P as PieChart } from '../index-6af2ada7.js';
-import { w as withInstall } from '../with-install-befebea5.js';
-import '../colors-ca059479.js';
+import { P as PieChart } from '../index-78b6b881.js';
+import { w as withInstall } from '../with-install-e405b463.js';
+import '../colors-ec0ad9ce.js';
 import 'echarts/core';
 import 'echarts/charts';
 import 'echarts/components';