@visactor/vseed 0.1.7 → 0.1.9

package/dist/esm/types/chartType/columnParallel/columnParallel.d.ts

@@ -0,0 +1,155 @@
+import type { Locale } from '../../i18n';
+import type { AnnotationArea, AnnotationHorizontalLine, AnnotationPoint, AnnotationVerticalLine, BackgroundColor, BarStyle, Color, CrosshairRect, Dataset, Dimensions, Label, Legend, StackCornerRadius, Theme, Tooltip, XBandAxis, YLinearAxis, MeasureTree, SortLegend, Sort } from '../../properties';
+/**
+ * @description 并列柱状图，适用于多指标并行对比场景，多个柱子并列排列展示不同指标值
+ * 适用场景:
+ * - 同一维度下多指标并行对比
+ * - 多维度数据的横向比较
+ * - 指标间关联性分析
+ * @encoding
+ * 并列柱状图支持以下视觉通道:
+ * `xAxis`  : x轴通道, 支持`多个维度`, 按维度值映射至x轴
+ * `yAxis`  : y轴通道, 支持`多个指标`, 按指标值映射至y轴
+ * `detail` : 细分通道, 支持`多个维度`, 在同一个颜色系列下展示更细粒度的数据时使用
+ * `color`  : 颜色通道, 支持`多个维度`或 `一个指标`, 维度颜色用于区分不同的数据系列, 指标颜色用于线性映射指标值到图形颜色
+ * `tooltip`: 提示通道, 支持`多个维度`与 `多个指标`, 会在鼠标悬停在数据点上时展示
+ * `label`  : 标签通道, 支持`多个维度`与 `多个指标`, 会在数据点上展示数据标签
+ * @warning
+ * 数据要求:
+ * - 至少1个指标字段（度量）
+ * - 第一个维度会放至X轴, 其余维度会与指标名称(存在多个指标时)合并, 作为图例项展示.
+ * - 所有指标会自动合并为一个指标
+ * 默认开启的功能:
+ * - 默认开启图例、坐标轴、数据标签、提示信息、指标排序
+ * @recommend
+ * - 推荐字段配置: `1`个指标, `2`个维度
+ * - 支持数据重塑: 至少`1`个指标, `0`个维度
+ */
+export interface ColumnParallel {
+    /**
+     * @description 并列柱状图，适用于多指标并行对比场景
+     * @example 'columnParallel'
+     */
+    chartType: 'columnParallel';
+    /**
+     * @description 数据集, 符合TidyData规范的且已经聚合的数据集，用于定义图表的数据来源和结构, 用户输入的数据集并不需要进行任何处理, VSeed带有强大的数据重塑功能, 会自行进行数据重塑, 并列柱状图的数据最终会被转换为2个维度, 1个指标.
+     * @example [{category:'A', value1:100, value2:200}, {category:'B', value1:150, value2:250}]
+     */
+    dataset: Dataset;
+    /**
+     * @description 维度, 第一个维度被映射到X轴, 其余维度会与指标名称(存在多个指标时)合并, 作为图例项展示.
+     * @type {Dimensions}
+     * @example [{id: 'category', alias: '类别'}]
+     */
+    dimensions?: Dimensions;
+    /**
+     * @description 指标, 并列柱状图的所有指标会自动合并为一个指标, 映射到Y轴, 存在多个指标时, 指标名称会与其余维度合并, 作为图例项展示.
+     * @type {DimensionTree}
+   Axis  * @example [{id: 'value1', alias: '指标1'}, {id: 'value2', alias: '指标2'}]
+     */
+    measures?: MeasureTree;
+    /**
+     * @description 图表的背景颜色, 背景颜色可以是颜色字符串, 例如'red', 'blue', 也可以是hex, rgb或rgba'#ff0000', 'rgba(255,0,0,0.5)'
+     * @default transparent 默认为透明背景
+     */
+    backgroundColor?: BackgroundColor;
+    /**
+     * @description 颜色配置, 用于定义图表的颜色方案, 包括颜色列表, 颜色映射, 颜色渐变等.
+     */
+    color?: Color;
+    /**
+     * @description 标签配置, 用于定义图表的数据标签, 包括数据标签的位置, 格式, 样式等.
+     */
+    label?: Label;
+    /**
+     * @description 图例配置, 用于定义图表的图例, 包括图例的位置, 格式, 样式等.
+     */
+    legend?: Legend;
+    /**
+     * @description 提示信息配置, 用于定义图表的提示信息, 包括提示信息的位置, 格式, 样式等.
+     */
+    tooltip?: Tooltip;
+    /**
+     * @description x轴, 类目轴, x轴配置, 用于定义图表的x轴, 包括x轴的位置, 格式, 样式等.
+     */
+    xAxis?: XBandAxis;
+    /**
+     * @description y轴, 数值轴, y轴配置, 用于定义图表的y轴, 包括y轴的位置, 格式, 样式等.
+     */
+    yAxis?: YLinearAxis;
+    /**
+     * @description 垂直提示框配置, 用于定义图表的垂直提示框, 包括垂直提示框的颜色、标签样式等.
+     */
+    crosshairRect?: CrosshairRect;
+    /**
+     * @description 柱状图 堆叠圆角
+     * @default 8
+     */
+    stackCornerRadius?: StackCornerRadius;
+    /**
+     * @description X轴排序配置, 支持根据维度或指标排序, 以及自定义排序顺序
+     * @example
+     * sort: {
+     *   orderBy: 'profit',
+     *   order: 'asc',
+     * }
+     * sort: {
+     *   customOrder:['2019', '2020', '2021']
+     * }
+     */
+    sort?: Sort;
+    /**
+     * @description 图例排序配置, 支持根据维度或指标排序, 以及自定义排序顺序
+     * @example
+     * sortLegend: {
+     *   orderBy: 'profit',
+     *   order: 'asc',
+     * }
+     * sortLegend: {
+     *   customOrder:['2019', '2020', '2021']
+     * }
+     */
+    sortLegend?: SortLegend;
+    /**
+     * @description 图表的主题, 主题是优先级较低的功能配置, 包含所有图表类型共用的通用配置, 与单类图表类型共用的图表配置, 内置light与dark两种主题, 用户可以通过Builder自定义主题
+     * @default light 默认为亮色主题
+     * @example 'dark'
+     * @example 'light'
+     * @example 'customThemeName'
+     */
+    theme?: Theme;
+    /**
+     * @description 矩形图元样式, 并列柱状图样式配置, 用于定义图表的并列柱状图样式, 包括并列柱状图的颜色, 边框, 圆角等.
+     * 支持全局样式或条件样式配置
+     * 数据筛选器
+     * 若配置selector, 提供数值 selector, 局部数据 selector, 条件维度 selector, 条件指标 selector 共四类数据匹配能力
+     * 若未配置selector, 则样式全局生效.
+     */
+    barStyle?: BarStyle | BarStyle[];
+    /**
+     * 标注点
+     * @description 标注点配置, 根据选择的数据, 定义图表的标注点, 包括标注点的位置, 格式, 样式等.
+     */
+    annotationPoint?: AnnotationPoint | AnnotationPoint[];
+    /**
+     * 标注垂直线
+     * @description 标注垂直线配置, 根据选择的数据, 定义图表的标注垂直线, 包括标注垂直线的位置, 样式等.
+     */
+    annotationVerticalLine?: AnnotationVerticalLine | AnnotationVerticalLine[];
+    /**
+     * 标注水平线
+     * @description 标注水平线配置, 根据选择的数据, 定义图表的标注水平线, 包括标注水平线的位置, 样式等.
+     */
+    annotationHorizontalLine?: AnnotationHorizontalLine | AnnotationHorizontalLine[];
+    /**
+     * 标注区域
+     * @description 标注区域配置, 根据选择的数据, 定义图表的标注区域, 包括标注区域的位置, 样式等.
+     */
+    annotationArea?: AnnotationArea | AnnotationArea[];
+    /**
+     * 语言
+     * @description 图表语言配置, 支持'zh-CN'与'en-US'两种语言, 另外可以调用 intl.setLocale('zh-CN') 方法设置语言
+     * @default 'zh-CN'
+     */
+    locale?: Locale;
+}

package/dist/esm/types/chartType/columnParallel/index.js

@@ -0,0 +1 @@
+export * from "./zColumnParallel.js";

package/dist/esm/types/chartType/columnParallel/zColumnParallel.js

@@ -0,0 +1,29 @@
+import { z } from "zod";
+import { zLocale } from "../../i18n/index.js";
+import { zAnnotationArea, zAnnotationHorizontalLine, zAnnotationPoint, zAnnotationVerticalLine, zBackgroundColor, zBarStyle, zColor, zCrosshairRect, zDataset, zDimensions, zEncoding, zLabel, zLegend, zMeasureTree, zStackCornerRadius, zTheme, zTooltip, zXBandAxis, zYLinearAxis } from "../../properties/index.js";
+const zColumnParallel = z.object({
+    chartType: z.literal('columnParallel'),
+    dataset: zDataset.nullish(),
+    encoding: zEncoding.nullish(),
+    dimensions: zDimensions.nullish(),
+    measures: zMeasureTree.nullish(),
+    backgroundColor: zBackgroundColor.nullish(),
+    color: zColor.nullish(),
+    label: zLabel.nullish(),
+    legend: zLegend.nullish(),
+    tooltip: zTooltip.nullish(),
+    xAxis: zXBandAxis.nullish(),
+    yAxis: zYLinearAxis.nullish(),
+    crosshairRect: zCrosshairRect.nullish(),
+    stackCornerRadius: zStackCornerRadius.nullish(),
+    theme: zTheme.nullish(),
+    barStyle: z.array(zBarStyle).or(zBarStyle).nullish(),
+    annotationPoint: z.array(zAnnotationPoint).or(zAnnotationPoint).nullish(),
+    annotationVerticalLine: z.array(zAnnotationVerticalLine).or(zAnnotationVerticalLine).nullish(),
+    annotationHorizontalLine: z.array(zAnnotationHorizontalLine).or(zAnnotationHorizontalLine).nullish(),
+    annotationArea: z.array(zAnnotationArea).or(zAnnotationArea).nullish(),
+    locale: zLocale.nullish()
+});
+export { zColumnParallel };
+
+//# sourceMappingURL=zColumnParallel.js.map

package/dist/esm/types/chartType/columnParallel/zColumnParallel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types/chartType/columnParallel/zColumnParallel.js","sources":["webpack://@visactor/vseed/./src/types/chartType/columnParallel/zColumnParallel.ts"],"sourcesContent":["import { z } from 'zod'\nimport { zLocale } from '../../i18n'\nimport {\n  zAnnotationArea,\n  zAnnotationHorizontalLine,\n  zAnnotationPoint,\n  zAnnotationVerticalLine,\n  zBackgroundColor,\n  zBarStyle,\n  zColor,\n  zCrosshairRect,\n  zDataset,\n  zDimensions,\n  zEncoding,\n  zLabel,\n  zLegend,\n  zMeasureTree,\n  zStackCornerRadius,\n  zTheme,\n  zTooltip,\n  zXBandAxis,\n  zYLinearAxis,\n} from '../../properties'\n\nexport const zColumnParallel = z.object({\n  chartType: z.literal('columnParallel'),\n  dataset: zDataset.nullish(),\n  encoding: zEncoding.nullish(),\n  dimensions: zDimensions.nullish(),\n  measures: zMeasureTree.nullish(),\n  backgroundColor: zBackgroundColor.nullish(),\n  color: zColor.nullish(),\n  label: zLabel.nullish(),\n  legend: zLegend.nullish(),\n  tooltip: zTooltip.nullish(),\n  xAxis: zXBandAxis.nullish(),\n  yAxis: zYLinearAxis.nullish(),\n  crosshairRect: zCrosshairRect.nullish(),\n  stackCornerRadius: zStackCornerRadius.nullish(),\n  theme: zTheme.nullish(),\n  barStyle: z.array(zBarStyle).or(zBarStyle).nullish(),\n  annotationPoint: z.array(zAnnotationPoint).or(zAnnotationPoint).nullish(),\n  annotationVerticalLine: z.array(zAnnotationVerticalLine).or(zAnnotationVerticalLine).nullish(),\n  annotationHorizontalLine: z.array(zAnnotationHorizontalLine).or(zAnnotationHorizontalLine).nullish(),\n  annotationArea: z.array(zAnnotationArea).or(zAnnotationArea).nullish(),\n  locale: zLocale.nullish(),\n})\n"],"names":["zColumnParallel","z","zDataset","zEncoding","zDimensions","zMeasureTree","zBackgroundColor","zColor","zLabel","zLegend","zTooltip","zXBandAxis","zYLinearAxis","zCrosshairRect","zStackCornerRadius","zTheme","zBarStyle","zAnnotationPoint","zAnnotationVerticalLine","zAnnotationHorizontalLine","zAnnotationArea","zLocale"],"mappings":";;;AAwBO,MAAMA,kBAAkBC,EAAE,MAAM,CAAC;IACtC,WAAWA,EAAE,OAAO,CAAC;IACrB,SAASC,SAAS,OAAO;IACzB,UAAUC,UAAU,OAAO;IAC3B,YAAYC,YAAY,OAAO;IAC/B,UAAUC,aAAa,OAAO;IAC9B,iBAAiBC,iBAAiB,OAAO;IACzC,OAAOC,OAAO,OAAO;IACrB,OAAOC,OAAO,OAAO;IACrB,QAAQC,QAAQ,OAAO;IACvB,SAASC,SAAS,OAAO;IACzB,OAAOC,WAAW,OAAO;IACzB,OAAOC,aAAa,OAAO;IAC3B,eAAeC,eAAe,OAAO;IACrC,mBAAmBC,mBAAmB,OAAO;IAC7C,OAAOC,OAAO,OAAO;IACrB,UAAUd,EAAE,KAAK,CAACe,WAAW,EAAE,CAACA,WAAW,OAAO;IAClD,iBAAiBf,EAAE,KAAK,CAACgB,kBAAkB,EAAE,CAACA,kBAAkB,OAAO;IACvE,wBAAwBhB,EAAE,KAAK,CAACiB,yBAAyB,EAAE,CAACA,yBAAyB,OAAO;IAC5F,0BAA0BjB,EAAE,KAAK,CAACkB,2BAA2B,EAAE,CAACA,2BAA2B,OAAO;IAClG,gBAAgBlB,EAAE,KAAK,CAACmB,iBAAiB,EAAE,CAACA,iBAAiB,OAAO;IACpE,QAAQC,QAAQ,OAAO;AACzB"}

package/dist/esm/types/chartType/columnPercent/columnPercent.d.ts

@@ -0,0 +1,154 @@
+import type { Locale } from '../../i18n';
+import type { AnnotationArea, AnnotationHorizontalLine, AnnotationPoint, AnnotationVerticalLine, BackgroundColor, BarStyle, Color, CrosshairRect, Dataset, Dimensions, Label, Legend, StackCornerRadius, Theme, Tooltip, XBandAxis, YLinearAxis, MeasureTree, Sort, SortLegend } from '../../properties';
+/**
+ * @description 百分比柱状图，适用于展示各类别占比关系的场景，Y轴以百分比形式展示数据占比
+ * 适用场景:
+ * - 不同类别数据的占比对比
+ * - 多维度数据的构成分析
+ * - 时间序列的占比变化趋势
+ * @encoding
+ * 百分比柱状图支持以下视觉通道:
+ * `xAxis`  : x轴通道, 支持`多个维度`, 按维度值映射至x轴
+ * `yAxis`  : y轴通道, 支持`多个指标`, 按指标值映射至y轴
+ * `detail` : 细分通道, 支持`多个维度`, 在同一个颜色系列下展示更细粒度的数据时使用
+ * `color`  : 颜色通道, 支持`多个维度`或 `一个指标`, 维度颜色用于区分不同的数据系列, 指标颜色用于线性映射指标值到图形颜色
+ * `tooltip`: 提示通道, 支持`多个维度`与 `多个指标`, 会在鼠标悬停在数据点上时展示
+ * `label`  : 标签通道, 支持`多个维度`与 `多个指标`, 会在数据点上展示数据标签
+ * @warning
+ * 数据要求:
+ * - 至少1个指标字段（度量）
+ * - 第一个维度会放至X轴, 其余维度会与指标名称(存在多个指标时)合并, 作为图例项展示.
+ * - 所有指标会自动合并为一个指标
+ * 默认开启的功能:
+ * - 默认开启图例、坐标轴、百分比标签、提示信息、占比计算
+ * @recommend
+ * - 推荐字段配置: `1`个指标, `2`个维度
+ * - 支持数据重塑: 至少`1`个指标, `0`个维度
+ */
+export interface ColumnPercent {
+    /**
+     * 百分比柱状图
+     * @description 百分比柱状图，以百分比形式展示各类别数据占比关系
+     * @type {'columnPercent'}
+     * @example 'columnPercent'
+     */
+    chartType: 'columnPercent';
+    /**
+     * 数据集
+     * @description 符合TidyData规范的且已经聚合的数据集，用于定义图表的数据来源和结构, 用户输入的数据集并不需要进行任何处理, VSeed带有强大的数据重塑功能, 会自行进行数据重塑, 百分比柱状图的数据最终会被转换为2个维度, 1个指标.
+     * @type {Array<Record<string|number, any>>}
+     * @example [{category:'A', value:30}, {category:'B', value:70}]
+     */
+    dataset: Dataset;
+    /**
+     * 维度
+     * @description 第一个维度被映射到X轴, 其余维度会与指标名称(存在多个指标时)合并, 作为图例项展示.
+     * @type {Dimensions}
+     * @example [{id: 'category', alias: '类别'}]
+     */
+    dimensions?: Dimensions;
+    /**
+     * 指标
+     * @description 百分比柱状图指标会自动合并为一个指标, 映射到Y轴, 存在多个指标时, 指标名称会与其余维度合并, 作为图例项展示.
+     * @type {DimensionTree}
+     * @example [{id: 'value', alias: '数值占比', format: 'percent'}]
+     */
+    measures?: MeasureTree;
+    /**
+     * @description 图表的背景颜色, 默认为透明背景, 背景颜色可以是颜色字符串, 例如'red', 'blue', 也可以是hex, rgb或rgba'#ff0000', 'rgba(255,0,0,0.5)'
+     */
+    backgroundColor?: BackgroundColor;
+    /**
+     * @description 颜色配置, 用于定义图表的颜色方案, 包括颜色列表, 颜色映射, 颜色渐变等.
+     */
+    color?: Color;
+    /**
+     * @description 标签配置, 用于定义图表的数据标签, 包括数据标签的位置, 格式, 样式等.
+     */
+    label?: Label;
+    /**
+     * @description 图例配置, 用于定义图表的图例, 包括图例的位置, 格式, 样式等.
+     */
+    legend?: Legend;
+    /**
+     * @description 提示信息配置, 用于定义图表的提示信息, 包括提示信息的位置, 格式, 样式等.
+     */
+    tooltip?: Tooltip;
+    /**
+     * @description x轴, 类目轴, x轴配置, 用于定义图表的x轴, 包括x轴的位置, 格式, 样式等.
+     */
+    xAxis?: XBandAxis;
+    /**
+     * @description y轴, 数值轴, y轴配置, 用于定义图表的y轴, 包括y轴的位置, 格式, 样式等.
+     */
+    yAxis?: YLinearAxis;
+    /**
+     * @description 垂直提示框配置, 用于定义图表的垂直提示框, 包括垂直提示框的颜色、标签样式等.
+     */
+    crosshairRect?: CrosshairRect;
+    /**
+     * @description 并列柱状图 堆叠圆角
+     */
+    stackCornerRadius?: StackCornerRadius;
+    /**
+     * @description X轴排序配置, 支持根据维度或指标排序, 以及自定义排序顺序
+     * @example
+     * sort: {
+     *   orderBy: 'profit',
+     *   order: 'asc',
+     * }
+     * sort: {
+     *   customOrder:['2019', '2020', '2021']
+     * }
+     */
+    sort?: Sort;
+    /**
+     * @description 图例排序配置, 支持根据维度或指标排序, 以及自定义排序顺序
+     * @example
+     * sortLegend: {
+     *   orderBy: 'profit',
+     *   order: 'asc',
+     * }
+     * sortLegend: {
+     *   customOrder:['2019', '2020', '2021']
+     * }
+     */
+    sortLegend?: SortLegend;
+    /**
+     * @description  图表的主题, 主题是优先级较低的功能配置, 包含所有图表类型共用的通用配置, 与单类图表类型共用的图表配置, 内置light与dark两种主题, 用户可以通过Builder自定义主题
+     * @default light 默认为亮色主题
+     * @example 'dark'
+     * @example 'light'
+     * @example 'customThemeName'
+     */
+    theme?: Theme;
+    /**
+     * @description 矩形图元样式, 用于定义图表的矩形图元样式, 包括矩形图元的颜色, 边框, 圆角等.
+     * 支持全局样式或条件样式配置
+     * 数据筛选器
+     * 若配置selector, 提供数值 selector, 局部数据 selector, 条件维度 selector, 条件指标 selector 共四类数据匹配能力
+     * 若未配置selector, 则样式全局生效.
+     */
+    barStyle?: BarStyle | BarStyle[];
+    /**
+     * @description 标注点配置, 根据选择的数据, 定义图表的标注点, 包括标注点的位置, 格式, 样式等.
+     */
+    annotationPoint?: AnnotationPoint | AnnotationPoint[];
+    /**
+     * @description 标注垂直线配置, 根据选择的数据, 定义图表的标注垂直线, 包括标注垂直线的位置, 样式等.
+     */
+    annotationVerticalLine?: AnnotationVerticalLine | AnnotationVerticalLine[];
+    /**
+     * @description 标注水平线配置, 根据选择的数据, 定义图表的标注水平线, 包括标注水平线的位置, 样式等.
+     */
+    annotationHorizontalLine?: AnnotationHorizontalLine | AnnotationHorizontalLine[];
+    /**
+     * @description 标注区域配置, 根据选择的数据, 定义图表的标注区域, 包括标注区域的位置, 样式等.
+     */
+    annotationArea?: AnnotationArea | AnnotationArea[];
+    /**
+     * @description 图表语言配置, 支持'zh-CN'与'en-US'两种语言, 另外可以调用 intl.setLocale('zh-CN') 方法设置语言
+     * @default 'zh-CN'
+     */
+    locale?: Locale;
+}

package/dist/esm/types/chartType/columnPercent/index.js

@@ -0,0 +1 @@
+export * from "./zColumnPercent.js";

package/dist/esm/types/chartType/columnPercent/zColumnPercent.js

@@ -0,0 +1,29 @@
+import { zLocale } from "../../i18n/index.js";
+import { zAnnotationArea, zAnnotationHorizontalLine, zAnnotationPoint, zAnnotationVerticalLine, zBackgroundColor, zBarStyle, zColor, zCrosshairRect, zDataset, zDimensions, zEncoding, zLabel, zLegend, zMeasureTree, zStackCornerRadius, zTheme, zTooltip, zXBandAxis, zYLinearAxis } from "../../properties/index.js";
+import { z } from "zod";
+const zColumnPercent = z.object({
+    chartType: z.literal('columnPercent'),
+    dataset: zDataset.nullish(),
+    encoding: zEncoding.nullish(),
+    dimensions: zDimensions.nullish(),
+    measures: zMeasureTree.nullish(),
+    backgroundColor: zBackgroundColor.nullish(),
+    color: zColor.nullish(),
+    label: zLabel.nullish(),
+    legend: zLegend.nullish(),
+    tooltip: zTooltip.nullish(),
+    xAxis: zXBandAxis.nullish(),
+    yAxis: zYLinearAxis.nullish(),
+    crosshairRect: zCrosshairRect.nullish(),
+    stackCornerRadius: zStackCornerRadius.nullish(),
+    theme: zTheme.nullish(),
+    barStyle: z.array(zBarStyle).or(zBarStyle).nullish(),
+    annotationPoint: z.array(zAnnotationPoint).or(zAnnotationPoint).nullish(),
+    annotationVerticalLine: z.array(zAnnotationVerticalLine).or(zAnnotationVerticalLine).nullish(),
+    annotationHorizontalLine: z.array(zAnnotationHorizontalLine).or(zAnnotationHorizontalLine).nullish(),
+    annotationArea: z.array(zAnnotationArea).or(zAnnotationArea).nullish(),
+    locale: zLocale.nullish()
+});
+export { zColumnPercent };
+
+//# sourceMappingURL=zColumnPercent.js.map

package/dist/esm/types/chartType/columnPercent/zColumnPercent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types/chartType/columnPercent/zColumnPercent.js","sources":["webpack://@visactor/vseed/./src/types/chartType/columnPercent/zColumnPercent.ts"],"sourcesContent":["import { zLocale } from '../../i18n'\nimport {\n  zAnnotationArea,\n  zAnnotationHorizontalLine,\n  zAnnotationPoint,\n  zAnnotationVerticalLine,\n  zBackgroundColor,\n  zBarStyle,\n  zColor,\n  zCrosshairRect,\n  zDataset,\n  zDimensions,\n  zEncoding,\n  zLabel,\n  zLegend,\n  zMeasureTree,\n  zStackCornerRadius,\n  zTheme,\n  zTooltip,\n  zXBandAxis,\n  zYLinearAxis,\n} from '../../properties'\n\nimport { z } from 'zod'\n\nexport const zColumnPercent = z.object({\n  chartType: z.literal('columnPercent'),\n  dataset: zDataset.nullish(),\n  encoding: zEncoding.nullish(),\n  dimensions: zDimensions.nullish(),\n  measures: zMeasureTree.nullish(),\n  backgroundColor: zBackgroundColor.nullish(),\n  color: zColor.nullish(),\n  label: zLabel.nullish(),\n  legend: zLegend.nullish(),\n  tooltip: zTooltip.nullish(),\n  xAxis: zXBandAxis.nullish(),\n  yAxis: zYLinearAxis.nullish(),\n  crosshairRect: zCrosshairRect.nullish(),\n  stackCornerRadius: zStackCornerRadius.nullish(),\n  theme: zTheme.nullish(),\n  barStyle: z.array(zBarStyle).or(zBarStyle).nullish(),\n  annotationPoint: z.array(zAnnotationPoint).or(zAnnotationPoint).nullish(),\n  annotationVerticalLine: z.array(zAnnotationVerticalLine).or(zAnnotationVerticalLine).nullish(),\n  annotationHorizontalLine: z.array(zAnnotationHorizontalLine).or(zAnnotationHorizontalLine).nullish(),\n  annotationArea: z.array(zAnnotationArea).or(zAnnotationArea).nullish(),\n  locale: zLocale.nullish(),\n})\n"],"names":["zColumnPercent","z","zDataset","zEncoding","zDimensions","zMeasureTree","zBackgroundColor","zColor","zLabel","zLegend","zTooltip","zXBandAxis","zYLinearAxis","zCrosshairRect","zStackCornerRadius","zTheme","zBarStyle","zAnnotationPoint","zAnnotationVerticalLine","zAnnotationHorizontalLine","zAnnotationArea","zLocale"],"mappings":";;;AAyBO,MAAMA,iBAAiBC,EAAE,MAAM,CAAC;IACrC,WAAWA,EAAE,OAAO,CAAC;IACrB,SAASC,SAAS,OAAO;IACzB,UAAUC,UAAU,OAAO;IAC3B,YAAYC,YAAY,OAAO;IAC/B,UAAUC,aAAa,OAAO;IAC9B,iBAAiBC,iBAAiB,OAAO;IACzC,OAAOC,OAAO,OAAO;IACrB,OAAOC,OAAO,OAAO;IACrB,QAAQC,QAAQ,OAAO;IACvB,SAASC,SAAS,OAAO;IACzB,OAAOC,WAAW,OAAO;IACzB,OAAOC,aAAa,OAAO;IAC3B,eAAeC,eAAe,OAAO;IACrC,mBAAmBC,mBAAmB,OAAO;IAC7C,OAAOC,OAAO,OAAO;IACrB,UAAUd,EAAE,KAAK,CAACe,WAAW,EAAE,CAACA,WAAW,OAAO;IAClD,iBAAiBf,EAAE,KAAK,CAACgB,kBAAkB,EAAE,CAACA,kBAAkB,OAAO;IACvE,wBAAwBhB,EAAE,KAAK,CAACiB,yBAAyB,EAAE,CAACA,yBAAyB,OAAO;IAC5F,0BAA0BjB,EAAE,KAAK,CAACkB,2BAA2B,EAAE,CAACA,2BAA2B,OAAO;IAClG,gBAAgBlB,EAAE,KAAK,CAACmB,iBAAiB,EAAE,CAACA,iBAAiB,OAAO;IACpE,QAAQC,QAAQ,OAAO;AACzB"}

package/dist/esm/types/chartType/donut/donut.d.ts

@@ -0,0 +1,97 @@
+import { type Locale } from '../../i18n';
+import type { BackgroundColor, Color, Dataset, Dimensions, Label, Legend, MeasureTree, Theme, Tooltip } from '../../properties';
+/**
+ * @description 环形图，适用于展示单一维度数据的占比关系，中心留有空白区域可展示汇总信息
+ * 适用场景:
+ * - 需要同时展示整体数据和各部分占比
+ * - 强调数据的整体与部分关系
+ * - 中心区域需要展示关键指标或标题
+ * @encoding
+ * 环形图支持以下视觉通道:
+ * `angle`  : 角度通道, 支持`多个指标`, 按指标值映射至扇形角度
+ * `detail` : 细分通道, 支持`多个维度`, 在同一个颜色系列下展示更细粒度的数据时使用
+ * `color`  : 颜色通道, 支持`多个维度`或 `一个指标`, 维度颜色用于区分不同的数据系列, 指标颜色用于线性映射指标值到图形颜色
+ * `tooltip`: 提示通道, 支持`多个维度`与 `多个指标`, 会在鼠标悬停在数据点上时展示
+ * `label`  : 标签通道, 支持`多个维度`与 `多个指标`, 会在数据点上展示数据标签
+ * @warning
+ * 数据要求:
+ * - 至少1个指标字段（度量）
+ * - 所有维度会与指标名称(存在多个指标时)合并, 作为图例项展示.
+ * - 所有指标会自动合并为一个指标
+ * 默认开启的功能:
+ * - 默认开启图例、数据标签、提示信息、占比计算、中心文本
+ * @recommend
+ * - 推荐字段配置: `1`个指标, `2`个维度
+ * - 支持数据重塑: 至少`1`个指标, `0`个维度
+ */
+export interface Donut {
+    /**
+     * 环形图
+     * @description 环形图，中心留有空白区域的饼图变体
+     * @type {'donut'}
+     * @example 'donut'
+     */
+    chartType: 'donut';
+    /**
+     * 数据集
+     * @description 符合TidyData规范的且已经聚合的数据集，用于定义图表的数据来源和结构, 用户输入的数据集并不需要进行任何处理, VSeed带有强大的数据重塑功能, 会自行进行数据重塑, 环形图的数据最终会被转换为1个维度, 1个指标.
+     * @type {Array<Record<string|number, any>>}
+     * @example [{category:'A', value:30}, {category:'B', value:70}]
+     */
+    dataset: Dataset;
+    /**
+     * 维度
+     * @description 环形图的所有维度会与指标名称(存在多个指标时)合并成1个维度, 映射到饼图的角度, 并作为图例项展示.
+     * @type {Dimensions}
+     * @example [{id: 'category', alias: '类别'}]
+     */
+    dimensions?: Dimensions;
+    /**
+     * 指标
+     * @description 环形图的所有指标会自动合并为一个指标, 映射到饼图的半径, 存在多个指标时, 指标名称会与其余维度合并, 并作为图例项展示.
+     * @type {DimensionTree}
+     * @example [{id: 'value', alias: '数值占比', format: 'percent'}]
+     */
+    measures?: MeasureTree;
+    /**
+     * 图表的背景颜色
+     * @default transparent 默认为透明背景
+     * @description 背景颜色可以是颜色字符串, 例如'red', 'blue', 也可以是hex, rgb或rgba'#ff0000', 'rgba(255,0,0,0.5)'
+     */
+    backgroundColor?: BackgroundColor;
+    /**
+     * 颜色
+     * @description 颜色配置, 用于定义图表的颜色方案, 包括颜色列表, 颜色映射, 颜色渐变等.
+     */
+    color?: Color;
+    /**
+     * 标签
+     * @description 标签配置, 用于定义图表的数据标签, 包括数据标签的位置, 格式, 样式等.
+     */
+    label?: Label;
+    /**
+     * 图例
+     * @description 图例配置, 用于定义图表的图例, 包括图例的位置, 格式, 样式等.
+     */
+    legend?: Legend;
+    /**
+     * 提示信息
+     * @description 提示信息配置, 用于定义图表的提示信息, 包括提示信息的位置, 格式, 样式等.
+     */
+    tooltip?: Tooltip;
+    /**
+     * 图表的主题, 主题是优先级较低的功能配置, 包含所有图表类型共用的通用配置, 与单类图表类型共用的图表配置
+     * @default light 默认为亮色主题
+     * @description 内置light与dark两种主题, 用户可以通过Builder自定义主题
+     * @example 'dark'
+     * @example 'light'
+     * @example 'customThemeName'
+     */
+    theme?: Theme;
+    /**
+     * 语言
+     * @description 图表语言配置, 支持'zh-CN'与'en-US'两种语言, 另外可以调用 intl.setLocale('zh-CN') 方法设置语言
+     * @default 'zh-CN'
+     */
+    locale?: Locale;
+}

package/dist/esm/types/chartType/donut/index.js

@@ -0,0 +1 @@
+export * from "./zDonut.js";

package/dist/esm/types/chartType/donut/zDonut.js

@@ -0,0 +1,20 @@
+import { z } from "zod";
+import { zLocale } from "../../i18n/index.js";
+import { zBackgroundColor, zColor, zDataset, zDimensions, zEncoding, zLabel, zLegend, zMeasureTree, zTheme, zTooltip } from "../../properties/index.js";
+const zDonut = z.object({
+    chartType: z.literal('donut'),
+    dataset: zDataset.nullish(),
+    encoding: zEncoding.nullish(),
+    dimensions: zDimensions.nullish(),
+    measures: zMeasureTree.nullish(),
+    backgroundColor: zBackgroundColor.nullish(),
+    color: zColor.nullish(),
+    label: zLabel.nullish(),
+    legend: zLegend.nullish(),
+    tooltip: zTooltip.nullish(),
+    theme: zTheme.nullish(),
+    locale: zLocale.nullish()
+});
+export { zDonut };
+
+//# sourceMappingURL=zDonut.js.map

package/dist/esm/types/chartType/donut/zDonut.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types/chartType/donut/zDonut.js","sources":["webpack://@visactor/vseed/./src/types/chartType/donut/zDonut.ts"],"sourcesContent":["import { z } from 'zod'\nimport { zLocale } from '../../i18n'\n\nimport {\n  zBackgroundColor,\n  zColor,\n  zDataset,\n  zDimensions,\n  zEncoding,\n  zLabel,\n  zLegend,\n  zMeasureTree,\n  zTheme,\n  zTooltip,\n} from '../../properties'\n\nexport const zDonut = z.object({\n  chartType: z.literal('donut'),\n  dataset: zDataset.nullish(),\n  encoding: zEncoding.nullish(),\n  dimensions: zDimensions.nullish(),\n  measures: zMeasureTree.nullish(),\n  backgroundColor: zBackgroundColor.nullish(),\n  color: zColor.nullish(),\n  label: zLabel.nullish(),\n  legend: zLegend.nullish(),\n  tooltip: zTooltip.nullish(),\n  theme: zTheme.nullish(),\n  locale: zLocale.nullish(),\n})\n"],"names":["zDonut","z","zDataset","zEncoding","zDimensions","zMeasureTree","zBackgroundColor","zColor","zLabel","zLegend","zTooltip","zTheme","zLocale"],"mappings":";;;AAgBO,MAAMA,SAASC,EAAE,MAAM,CAAC;IAC7B,WAAWA,EAAE,OAAO,CAAC;IACrB,SAASC,SAAS,OAAO;IACzB,UAAUC,UAAU,OAAO;IAC3B,YAAYC,YAAY,OAAO;IAC/B,UAAUC,aAAa,OAAO;IAC9B,iBAAiBC,iBAAiB,OAAO;IACzC,OAAOC,OAAO,OAAO;IACrB,OAAOC,OAAO,OAAO;IACrB,QAAQC,QAAQ,OAAO;IACvB,SAASC,SAAS,OAAO;IACzB,OAAOC,OAAO,OAAO;IACrB,QAAQC,QAAQ,OAAO;AACzB"}