@xq-labs/data-ui-v2 0.1.0

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

@@ -0,0 +1,57 @@
+# BarLineChart 示例说明（对齐 Playground Demo 库）
+
+## 1. 路由与分组
+
+Playground 中 `BarLineChart` 按分组路由组织：
+
+- 基础用法：`/bar-line-chart/basic`
+- 圆柱样式：`/bar-line-chart/cylinder`
+- 方柱样式：`/bar-line-chart/cube`
+- 进阶配置：`/bar-line-chart/advanced`
+- customOption 与自定义：`/bar-line-chart/custom`
+- 实验室：`/bar-line-chart/lab`
+
+> 实验室边界：仅用于调试/验证，不作为推荐业务写法。
+
+## 2. 外部配置怎么传
+
+业务侧通过公开 props（推荐 `v-bind`）传入：
+
+```vue
+<BarLineChart
+  v-bind="{
+    data,
+    xAxisKey,
+    series,
+    variant,
+    preset,
+    barWidth,
+    barGap,
+    customOption
+  }"
+/>
+```
+
+关键字段：
+
+- `data`：原始业务数据。
+- `xAxisKey`：横轴字段名。
+- `series`：系列定义（字段映射、图形类型、轴、堆叠）。
+- `variant`：`flat` / `cylinder` / `cube`。
+- `preset`：展示预设。
+- `barWidth`、`barGap`：柱体宽度与间距。
+- `customOption`：ECharts 展示细节覆盖。
+
+## 3. 如何自定义（推荐顺序）
+
+1. **优先 `series` 表达业务语义**：先确定字段、柱线类型、双轴和堆叠关系。
+2. **用 `series.colors` 控制系列配色**：把业务色板放在系列层。
+3. **`customOption` 补充细节**：用于 tooltip、legend、grid、坐标轴样式等展示项。
+
+不建议用 `customOption` 直接整体替换关键业务结构。
+
+## 4. 可执行验收要点
+
+- 页面分组名称与路由一致：基础用法、圆柱样式、方柱样式、进阶配置、customOption 与自定义、实验室。
+- 文档示例包含 `series.colors` 与 `customOption`。
+- 文档明确实验室边界与推荐自定义顺序。

package/docs/examples/pie-chart.md

@@ -0,0 +1,72 @@
+# PieChart 示例说明（对齐 Playground Demo 库）
+
+## 1. 路由与分组
+
+Playground 中 `PieChart` 采用分组路由组织，按能力查阅：
+
+- 基础用法：`/pie-chart/basic`
+- 2D 形态：`/pie-chart/shape-2d`
+- 3D 能力：`/pie-chart/three-d`
+- 标签与引导线：`/pie-chart/label`
+- customOption 与自定义：`/pie-chart/custom`
+- 实验室：`/pie-chart/lab`
+
+> 实验室边界：仅用于调试/验证，不作为推荐业务写法。
+
+## 2. 外部配置怎么传
+
+业务侧统一通过公开 props（推荐 `v-bind`）传入配置，不直接拼内部实现细节。
+
+```vue
+<PieChart
+  v-bind="{
+    data,
+    variant,
+    dimension,
+    preset,
+    heightMode,
+    minHeight,
+    maxHeight,
+    hideZeroValueSlices,
+    labelOptions,
+    customOption
+  }"
+/>
+```
+
+常用字段说明：
+
+- `data`：图表数据源。
+- `variant`：`pie` / `ring` / `rose-pie` / `rose-ring`。
+- `dimension`：`2d` / `3d`。
+- `preset`：预设展示策略。
+- `heightMode`、`minHeight`、`maxHeight`：3D 高度映射策略。
+- `hideZeroValueSlices`：3D 下是否隐藏 0 值扇区。
+- `labelOptions`：标签与引导线细节（格式、线长、颜色等）。
+- `customOption`：ECharts 细节覆盖（标题、提示、图例等）。
+
+## 2.1 3D 依赖说明
+
+3D 饼图需要安装 echarts-gl，依赖包名为 `echarts-gl`。
+
+只使用 2D 饼图、环图、玫瑰图时不需要安装 `echarts-gl`。
+
+如果业务侧需要启用 3D 饼图，请额外安装：
+
+```bash
+npm install echarts-gl
+```
+
+## 3. 如何自定义（推荐顺序）
+
+1. **优先公开 props**：先用 `variant`、`dimension`、`preset`、高度参数表达业务语义。
+2. **其次 `labelOptions`**：标签文案、引导线样式优先在这里完成。
+3. **最后 `customOption`**：仅用于补充 ECharts 展示细节。
+
+不建议业务侧直接拼接或重写内部 `series`，避免覆盖组件内置能力与升级兼容性。
+
+## 4. 可执行验收要点
+
+- 页面分组名称与路由一致：基础用法、2D 形态、3D 能力、标签与引导线、customOption 与自定义、实验室。
+- 文档示例包含 `hideZeroValueSlices` 与 `customOption`。
+- 文档明确实验室边界与推荐自定义顺序。

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

@@ -0,0 +1,13 @@
+import '../../theme-chalk/index.css';
+import { B as BarLineChart } from '../index-6128787e.js';
+import { w as withInstall } from '../with-install-befebea5.js';
+import 'echarts/core';
+import 'echarts/charts';
+import 'echarts/components';
+import 'echarts/renderers';
+import '../colors-ca059479.js';
+
+var BarLineChartComponent = withInstall(BarLineChart);
+var install = BarLineChartComponent.install;
+
+export { BarLineChartComponent as BarLineChart, BarLineChartComponent as default, install };

package/es/base-chart/index.js

@@ -0,0 +1,8 @@
+import '../../theme-chalk/index.css';
+import { w as withInstall, B as BaseChart } from '../with-install-befebea5.js';
+import 'echarts/core';
+
+var BaseChartComponent = withInstall(BaseChart);
+var install = BaseChartComponent.install;
+
+export { BaseChartComponent as BaseChart, BaseChartComponent as default, install };

package/es/colors-ca059479.js

@@ -0,0 +1,115 @@
+function isEmptyData(data) {
+  return !Array.isArray(data) || data.length === 0;
+}
+
+function _arrayLikeToArray(r, a) {
+  (null == a || a > r.length) && (a = r.length);
+  for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e];
+  return n;
+}
+function _arrayWithoutHoles(r) {
+  if (Array.isArray(r)) return _arrayLikeToArray(r);
+}
+function _defineProperty(e, r, t) {
+  return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, {
+    value: t,
+    enumerable: !0,
+    configurable: !0,
+    writable: !0
+  }) : e[r] = t, e;
+}
+function _iterableToArray(r) {
+  if ("undefined" != typeof Symbol && null != r[Symbol.iterator] || null != r["@@iterator"]) return Array.from(r);
+}
+function _nonIterableSpread() {
+  throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
+}
+function ownKeys(e, r) {
+  var t = Object.keys(e);
+  if (Object.getOwnPropertySymbols) {
+    var o = Object.getOwnPropertySymbols(e);
+    r && (o = o.filter(function (r) {
+      return Object.getOwnPropertyDescriptor(e, r).enumerable;
+    })), t.push.apply(t, o);
+  }
+  return t;
+}
+function _objectSpread2(e) {
+  for (var r = 1; r < arguments.length; r++) {
+    var t = null != arguments[r] ? arguments[r] : {};
+    r % 2 ? ownKeys(Object(t), !0).forEach(function (r) {
+      _defineProperty(e, r, t[r]);
+    }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) {
+      Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r));
+    });
+  }
+  return e;
+}
+function _toConsumableArray(r) {
+  return _arrayWithoutHoles(r) || _iterableToArray(r) || _unsupportedIterableToArray(r) || _nonIterableSpread();
+}
+function _toPrimitive(t, r) {
+  if ("object" != typeof t || !t) return t;
+  var e = t[Symbol.toPrimitive];
+  if (void 0 !== e) {
+    var i = e.call(t, r || "default");
+    if ("object" != typeof i) return i;
+    throw new TypeError("@@toPrimitive must return a primitive value.");
+  }
+  return ("string" === r ? String : Number)(t);
+}
+function _toPropertyKey(t) {
+  var i = _toPrimitive(t, "string");
+  return "symbol" == typeof i ? i : i + "";
+}
+function _unsupportedIterableToArray(r, a) {
+  if (r) {
+    if ("string" == typeof r) return _arrayLikeToArray(r, a);
+    var t = {}.toString.call(r).slice(8, -1);
+    return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0;
+  }
+}
+
+function isPlainObject(value) {
+  return Object.prototype.toString.call(value) === '[object Object]';
+}
+function cloneValue(value) {
+  if (Array.isArray(value)) {
+    return value.map(function (item) {
+      return cloneValue(item);
+    });
+  }
+  if (isPlainObject(value)) {
+    return Object.keys(value).reduce(function (result, key) {
+      result[key] = cloneValue(value[key]);
+      return result;
+    }, {});
+  }
+  return value;
+}
+function mergeValue(targetValue, sourceValue) {
+  if (Array.isArray(sourceValue)) {
+    return cloneValue(sourceValue);
+  }
+  if (!isPlainObject(sourceValue)) {
+    return cloneValue(sourceValue);
+  }
+  var baseObject = isPlainObject(targetValue) ? targetValue : {};
+  var mergedObject = _objectSpread2({}, baseObject);
+  Object.keys(sourceValue).forEach(function (key) {
+    mergedObject[key] = mergeValue(baseObject[key], sourceValue[key]);
+  });
+  return mergedObject;
+}
+function mergeChartOption(baseOption, presetOption, customOption) {
+  return [baseOption, presetOption, customOption].reduce(function (result, option) {
+    if (!isPlainObject(option)) {
+      return result;
+    }
+    return mergeValue(result, option);
+  }, {});
+}
+
+var DEFAULT_COLORS = ['#8979ff', '#ff928a', '#3cc3df', '#ffae4c', '#5c7cfa', '#5dd39e', '#8064d8', '#26b7d8', '#238ff2', '#f6c93d', '#59c5b5', '#5a7cc4', '#f2953f', '#82c65b', '#cf7a78', '#63c5d2', '#cfb291', '#2fa0bf', '#50a579', '#7869bd'];
+
+export { DEFAULT_COLORS as D, _objectSpread2 as _, _toConsumableArray as a, isEmptyData as i, mergeChartOption as m };