@visactor/vchart 1.15.5-alpha.8 → 2.0.0-alpha.0

package/cjs/typings/spec/common.d.ts

@@ -1,10 +1,9 @@
 import type { IVChart } from './../../core/interface';
 import type { IImageMarkSpec } from '../visual';
 import type { LayoutCallBack } from '../../layout/interface';
-import type { IElement, srIOption3DType } from '@visactor/vgrammar-core';
 import type { DataSet, DataView, ISimplifyOptions, IFieldsOptions, IFilterOptions, IFoldOptions, IDsvParserOptions } from '@visactor/vdataset';
 import type { RegionSpec } from '../../region/interface';
-import type { IHoverSpec, ISelectSpec, IInteractionSpec } from '../../interaction/interface';
+import type { IHoverSpec, ISelectSpec, IInteractionSpec } from '../../interaction/interface/spec';
 import type { IRenderOption } from '../../compile/interface';
 import type { ISeriesTooltipSpec, ITooltipSpec } from '../../component/tooltip/interface';
 import type { ILayoutSpec } from '../../layout/interface';
@@ -14,7 +13,7 @@ import type { Datum, StringOrNumber } from '../common';
 import type { IInvalidType } from '../data';
 import type { IAnimationSpec, IMorphSeriesSpec } from '../../animation/spec';
 import type { IPlayer } from '../../component/player/interface';
-import type { IMarkProgressiveConfig, MarkTypeEnum } from '../../mark/interface';
+import type { IMark, IMarkProgressiveConfig, MarkTypeEnum } from '../../mark/interface';
 import type { IDataZoomSpec } from '../../component/data-zoom/data-zoom/interface';
 import type { IScrollBarSpec } from '../../component/data-zoom/scroll-bar/interface';
 import type { ICrosshairSpec } from '../../component/crosshair/interface';
@@ -24,7 +23,7 @@ import type { IBrushSpec } from '../../component/brush/interface';
 import type { ITotalLabelSpec } from '../../component/label/interface';
 import type { ILegendSpec } from '../../component/legend/interface';
 import type { ILayoutOrientPadding, ILayoutPaddingSpec } from '../layout';
-import type { IColor, ICustomPath2D, IRichTextCharacter } from '@visactor/vrender-core';
+import type { IColor, ICustomPath2D, IGraphic, IRichTextCharacter } from '@visactor/vrender-core';
 import type { ICommonAxisSpec } from '../../component/axis/interface';
 import type { IMediaQuerySpec } from './media-query';
 import type { IModelSpec } from '../../model/interface';
@@ -34,9 +33,7 @@ export interface IInitOption extends Omit<IRenderOption, 'pluginList'> {
     renderCanvas?: string | HTMLCanvasElement;
     dataSet?: DataSet;
     autoFit?: boolean;
-    performanceHook?: IPerformanceHook;
     animation?: boolean;
-    options3d?: srIOption3DType;
     layout?: LayoutCallBack;
     poptip?: boolean;
     onError?: (...args: any[]) => void;
@@ -199,8 +196,12 @@ export type IMarkStateFilter = {
     datums: Datum[];
     datumKeys: string[];
 } | {
-    items: IElement[];
-} | ((datum: Datum, options: Record<string, any>) => boolean);
+    items: IGraphic[];
+} | ((datum: Datum, options: {
+    mark?: IMark;
+    type?: string;
+    renderNode?: IGraphic;
+}) => boolean);
 export interface IMarkStateSpec<T> {
     filter?: IMarkStateFilter;
     level?: number | undefined;
@@ -224,35 +225,35 @@ export interface IPerformanceHook {
     afterCreateVChart?: (vchart?: IVChart) => void;
     beforeInitializeChart?: (vchart?: IVChart) => void;
     afterInitializeChart?: (vchart?: IVChart) => void;
-    beforeCompileToVGrammar?: () => void;
-    afterCompileToVGrammar?: () => void;
-    beforeRegionCompile?: () => void;
-    afterRegionCompile?: () => void;
-    beforeSeriesCompile?: () => void;
-    afterSeriesCompile?: () => void;
-    beforeComponentCompile?: () => void;
-    afterComponentCompile?: () => void;
-    beforeResizeWithUpdate?: () => void;
-    afterResizeWithUpdate?: () => void;
-    beforeLayoutWithSceneGraph?: () => void;
-    afterLayoutWithSceneGraph?: () => void;
-    beforeParseView?: () => void;
-    afterParseView?: () => void;
-    beforeCreateRuntime?: () => void;
-    afterCreateRuntime?: () => void;
-    beforeSrViewEvaluateAsync?: () => void;
-    afterSrViewEvaluateAsync?: () => void;
-    beforeSrViewRunAsync?: () => void;
-    afterSrViewRunAsync?: () => void;
-    beforeTransform?: (name: string) => void;
-    afterTransform?: (name: string) => void;
-    beforeCreateVRenderStage?: () => void;
-    afterCreateVRenderStage?: () => void;
-    beforeCreateVRenderMark?: () => void;
-    afterCreateVRenderMark?: () => void;
+    beforeCompileToVGrammar?: (vchart?: IVChart) => void;
+    afterCompileToVGrammar?: (vchart?: IVChart) => void;
+    beforeRegionCompile?: (vchart?: IVChart) => void;
+    afterRegionCompile?: (vchart?: IVChart) => void;
+    beforeSeriesCompile?: (vchart?: IVChart) => void;
+    afterSeriesCompile?: (vchart?: IVChart) => void;
+    beforeComponentCompile?: (vchart?: IVChart) => void;
+    afterComponentCompile?: (vchart?: IVChart) => void;
+    beforeResizeWithUpdate?: (vchart?: IVChart) => void;
+    afterResizeWithUpdate?: (vchart?: IVChart) => void;
+    beforeLayoutWithSceneGraph?: (vchart?: IVChart) => void;
+    afterLayoutWithSceneGraph?: (vchart?: IVChart) => void;
+    beforeParseView?: (vchart?: IVChart) => void;
+    afterParseView?: (vchart?: IVChart) => void;
+    beforeCreateRuntime?: (vchart?: IVChart) => void;
+    afterCreateRuntime?: (vchart?: IVChart) => void;
+    beforeSrViewEvaluateAsync?: (vchart?: IVChart) => void;
+    afterSrViewEvaluateAsync?: (vchart?: IVChart) => void;
+    beforeSrViewRunAsync?: (vchart?: IVChart) => void;
+    afterSrViewRunAsync?: (vchart?: IVChart) => void;
+    beforeTransform?: (name: string, vchart?: IVChart) => void;
+    afterTransform?: (name: string, vchart?: IVChart) => void;
+    beforeCreateVRenderStage?: (vchart?: IVChart) => void;
+    afterCreateVRenderStage?: (vchart?: IVChart) => void;
+    beforeCreateVRenderMark?: (vchart?: IVChart) => void;
+    afterCreateVRenderMark?: (vchart?: IVChart) => void;
     beforeDoRender?: (vchart?: IVChart) => void;
-    beforeVRenderDraw?: () => void;
-    afterVRenderDraw?: () => void;
+    beforeVRenderDraw?: (vchart?: IVChart) => void;
+    afterVRenderDraw?: (vchart?: IVChart) => void;
 }
 export type IBuildinMarkSpec = {
     group: IGroupMarkSpec;

package/cjs/typings/spec/common.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/typings/spec/common.ts"],"names":[],"mappings":";;;AAkIA,IAAY,cAWX;AAXD,WAAY,cAAc;IACxB,qDAAqC,CAAA;IACrC,mDAAmC,CAAA;IACnC,+BAAe,CAAA;IACf,mCAAmB,CAAA;IACnB,qCAAqB,CAAA;IACrB,2BAAW,CAAA;IACX,2BAAW,CAAA;IACX,qCAAqB,CAAA;IACrB,qDAAqC,CAAA;IACrC,+BAAe,CAAA;AACjB,CAAC,EAXW,cAAc,GAAd,sBAAc,KAAd,sBAAc,QAWzB","file":"common.js","sourcesContent":["import type { IVChart } from './../../core/interface';\nimport type { IFillMarkSpec, IImageMarkSpec } from '../visual';\nimport type { LayoutCallBack } from '../../layout/interface';\nimport type { IElement, srIOption3DType } from '@visactor/vgrammar-core';\nimport type {\n  DataSet,\n  DataView,\n  ISimplifyOptions,\n  IFieldsOptions,\n  IFilterOptions,\n  IFoldOptions,\n  IDsvParserOptions\n} from '@visactor/vdataset';\nimport type { RegionSpec } from '../../region/interface';\nimport type { IHoverSpec, ISelectSpec, IInteractionSpec } from '../../interaction/interface';\nimport type { IRenderOption } from '../../compile/interface';\nimport type { ISeriesTooltipSpec, ITooltipSpec } from '../../component/tooltip/interface';\n// eslint-disable-next-line no-duplicate-imports\nimport type { ILayoutSpec } from '../../layout/interface';\n// eslint-disable-next-line no-duplicate-imports\nimport type {\n  ConvertToMarkStyleSpec,\n  IArc3dMarkSpec,\n  IArcMarkSpec,\n  IAreaMarkSpec,\n  IBoxPlotMarkSpec,\n  ICommonSpec,\n  IGroupMarkSpec,\n  ILineMarkSpec,\n  ILinkPathMarkSpec,\n  IPathMarkSpec,\n  IPolygonMarkSpec,\n  IPyramid3dMarkSpec,\n  IRect3dMarkSpec,\n  IRectMarkSpec,\n  IRuleMarkSpec,\n  ISymbolMarkSpec,\n  IRippleMarkSpec,\n  ITextMarkSpec,\n  IVisualSpecScale\n} from '../visual';\nimport type { StateValue } from '../../compile/mark/interface';\nimport type { ISeriesStyle, SeriesType } from '../../series/interface';\nimport type { Datum, StringOrNumber } from '../common';\nimport type { IInvalidType } from '../data';\nimport type { IAnimationSpec, IMorphSeriesSpec } from '../../animation/spec';\nimport type { IPlayer } from '../../component/player/interface';\nimport type { IMarkProgressiveConfig, MarkTypeEnum } from '../../mark/interface';\nimport type { IDataZoomSpec } from '../../component/data-zoom/data-zoom/interface';\nimport type { IScrollBarSpec } from '../../component/data-zoom/scroll-bar/interface';\nimport type { ICrosshairSpec } from '../../component/crosshair/interface';\nimport type { ITheme } from '../../theme/interface';\nimport type { ITitleSpec } from '../../component/title/interface';\nimport type { IBrushSpec } from '../../component/brush/interface';\nimport type { ITotalLabelSpec } from '../../component/label/interface';\nimport type { ILegendSpec } from '../../component/legend/interface';\nimport type { ILayoutOrientPadding, ILayoutPaddingSpec } from '../layout';\nimport type { IColor, ICustomPath2D, IRichTextCharacter } from '@visactor/vrender-core';\nimport type { ICommonAxisSpec } from '../../component/axis/interface';\nimport type { IMediaQuerySpec } from './media-query';\nimport type { IModelSpec } from '../../model/interface';\n\nexport type IChartPadding = ILayoutOrientPadding | number;\n\n/** chart option */\nexport interface IInitOption extends Omit<IRenderOption, 'pluginList'> {\n  /**\n   * **仅生效于浏览器环境。**\n   * 图表挂载的父容器，可以直接指定容器 id，也可以传入 dom 对象\n   */\n  dom?: string | HTMLElement;\n  /**\n   * 除去选择 dom 属性进行挂载父容器，也可以使用 renderCanvas 属性直接传入 canvas 实例/ canvasId\n   * 小程序/小组件环境请直接传入 id\n   */\n  renderCanvas?: string | HTMLCanvasElement;\n  /** 数据集 */\n  dataSet?: DataSet;\n  /** 是否自适应容器大小 */\n  autoFit?: boolean;\n  /**\n   * 性能测试钩子\n   */\n  performanceHook?: IPerformanceHook;\n  /**\n   * 是否开启动画\n   */\n  animation?: boolean;\n  /**\n   * 3d配置\n   */\n  options3d?: srIOption3DType;\n\n  /**\n   * 自定义布局函数\n   */\n  layout?: LayoutCallBack;\n\n  /**\n   * 当文本省略时，鼠标 hover 到文本上时是否显示 poptip\n   * @default true\n   */\n  poptip?: boolean;\n\n  /**\n   * 报错的回调函数\n   * @since 1.2.0\n   */\n  onError?: (...args: any[]) => void;\n\n  /**\n   * 默认主题（支持完整主题对象或者主题名称，主题名称需要提前在 `ThemeManager` 中注册）\n   * @since 1.3.0\n   */\n  theme?: string | ITheme;\n\n  /**\n   * 是否关闭交互效果\n   * @since 1.9.0\n   * @default false\n   */\n  disableTriggerEvent?: boolean;\n  /**\n   * 当自动响应容器resize 事件时，触发resize 的间隔时长，单位毫秒\n   * @since 1.12.5\n   * @default 100\n   */\n  resizeDelay?: number;\n}\n\nexport enum RenderModeEnum {\n  'desktop-browser' = 'desktop-browser',\n  'mobile-browser' = 'mobile-browser',\n  'node' = 'node',\n  'worker' = 'worker',\n  'miniApp' = 'miniApp',\n  'wx' = 'wx',\n  'tt' = 'tt',\n  'harmony' = 'harmony',\n  'desktop-miniApp' = 'desktop-miniApp',\n  'lynx' = 'lynx'\n}\nexport type RenderMode = keyof typeof RenderModeEnum;\n\n/** chart spec */\nexport interface IChartSpec {\n  /** 图表类型 */\n  type: string;\n  /** 数据 */\n  data?: IData;\n  /** 画布宽度 */\n  width?: number;\n  /** 画布高度 */\n  height?: number;\n  /**\n   * 图表宽高是否自适应容器，浏览器环境下默认为 true。\n   * 该配置的优先级高于构造函数中的 autoFit 配置。\n   * 如果用户配置了 width，则以用户配置的 width 为准，height 同理。\n   */\n  autoFit?: boolean;\n  /**\n   * 图表整体 padding 设置\n   */\n  padding?: ILayoutPaddingSpec;\n  /**\n   * 图表色系配置\n   */\n  color?: string[] | Omit<IVisualSpecScale<unknown, string>, 'id'>;\n  /**\n   * 系列\n   * @description 仅在组合图中使用, 文档中除组合图外均未透出该配置\n   */\n  series?: ISeriesSpec[];\n  /**\n   * 系列样式\n   * @description 仅在图表配置了seriesField时生效\n   */\n  seriesStyle?: ISeriesStyle;\n\n  /**\n   * 自动关闭动画的阀值，对应的是单系列data的长度\n   * @since 1.2.0\n   */\n  animationThreshold?: number;\n\n  /** hover 交互 */\n  hover?: boolean | IHoverSpec;\n  /** select 交互 */\n  select?: boolean | ISelectSpec;\n\n  /** region配置 */\n  region?: RegionSpec[];\n  /** 图表标题配置 */\n  title?: ITitleSpec;\n  /** 布局配置 */\n  layout?: ILayoutSpec;\n  /** 图例配置 */\n  legends?: ILegendSpec | ILegendSpec[];\n  /** 十字辅助线配置 */\n  crosshair?: ICrosshairSpec | ICrosshairSpec[];\n  /** tooltip配置 */\n  tooltip?: ITooltipSpec;\n  /** 播放器配置 */\n  player?: IPlayer;\n  /** 缩略轴配置 */\n  dataZoom?: IDataZoomSpec | IDataZoomSpec[];\n  /** 滚动条配置 */\n  scrollBar?: IScrollBarSpec | IScrollBarSpec[];\n  /** 框选配置 */\n  brush?: IBrushSpec;\n  /** 全局 scale 配置 */\n  scales?: IVisualSpecScale<unknown, unknown>[];\n  /** 自定义mark */\n  customMark?: ICustomMarkSpec<EnableMarkType>[];\n  /** 轴 */\n  axes?: ICommonAxisSpec[];\n  /**\n   * 图表上的主题定义。\n   * 可以直接配置主题名，前提是该主题名已经注册\n   */\n  theme?: Omit<ITheme, 'name'> | string;\n  /**\n   * 图表背景色配置，优先级高于构造函数中的 background 配置\n   * 自1.11.6版本支持渐变色对象的配置\n   */\n  background?: IBackgroundSpec;\n\n  // TODO：后续开放，现在仍有问题\n  // poptip?: PopTipAttributes;\n  // TODO: 补充动画配置\n\n  /**\n   * 堆积时是否逆序\n   * @default false\n   * @since 1.4.0\n   */\n  stackInverse?: boolean;\n  /**\n   * 堆积时是否排序\n   * @default false\n   * @since 1.10.4\n   */\n  stackSort?: boolean;\n  /**\n   * 媒体查询配置\n   * @since 1.8.0\n   */\n  media?: IMediaQuerySpec;\n}\n\nexport type IBackgroundSpec = IColor | ConvertToMarkStyleSpec<IGroupMarkSpec>;\n\n/** data */\nexport type IDataType = IDataValues | DataView;\nexport type IData = IDataType | IDataType[];\nexport type DataKeyType = string | string[] | ((data: Datum, index: number) => string);\nexport type BuildInTransformOptions =\n  | {\n      /** 地理数据简化 */\n      type: 'simplify';\n      options: ISimplifyOptions;\n    }\n  | {\n      /** 数据维度处理，包括排序，逆序，数据筛选能力 */\n      type: 'fields';\n      options: IFieldsOptions;\n    }\n  | {\n      /** 使用回调的自定义筛选 */\n      type: 'filter';\n      options: IFilterOptions;\n    }\n  | {\n      /** 数据展开 */\n      type: 'fold';\n      options: IFoldOptions;\n    };\n\nexport interface IFieldsMeta {\n  /** TODO: 字段通用format, 暂时先不支持 */\n  // format?: (datum: Datum, index: number) => unknown;\n  /** 字段别名 */\n  alias?: string;\n  /** 字段取值范围 */\n  domain?: StringOrNumber[];\n  /** 是否使用 domain 锁定统计信息。默认为 false */\n  lockStatisticsByDomain?: boolean;\n  /** 连续型 还是 离散型 */\n  type?: 'ordinal' | 'linear';\n  /** 排序顺序 不设置的话当前维度不进行排序 */\n  sortIndex?: number;\n  /** 排序时是否反转 默认为 false */\n  sortReverse?: boolean;\n}\n\nexport interface SheetParseOptions extends CommonParseOptions {\n  /**\n   * 特定类型的数据，支持以下类型：\n   * - csv: 逗号分隔值（Comma-Separated Values，CSV，有时也称为字符分隔值，因为分隔字符也可以不是逗号），其文件以纯文本形式存储表格数据（数字和文本）。\n   * - dsv: 分隔值（Delimiter-Separated Values，DSV，有时也称为字符分隔值，因为分隔字符也可以不是逗号），其文件以纯文本形式存储表格数据（数字和文本）。\n   * - tsv: 制表符分隔值（Tab-Separated Values，TSV，有时也称为字符分隔值，因为分隔字符也可以不是逗号），其文件以纯文本形式存储表格数据（数字和文本）。\n   */\n  type: 'csv' | 'dsv' | 'tsv';\n  /**\n   * 具体的解析配置\n   */\n  options?: IDsvParserOptions;\n}\n\nexport interface CommonParseOptions {\n  /**\n   * 是否需要对数据进行 clone，默认为 true。\n   * 如果考虑性能，你可以将其关闭，但是这会带了一些副作用，即我们会对传入的数据进行修改（不会对原有字段及值修改，只会在原有数据基础上添加一些字段）。\n   * @default true\n   * @since 1.3.0\n   */\n  clone?: boolean;\n}\n\nexport interface IDataValues {\n  /**\n   * 数据唯一标识\n   */\n  id?: StringOrNumber;\n  /**\n   * 数据\n   */\n  values: Datum[] | string;\n  /**\n   * 引用的数据索引\n   */\n  fromDataIndex?: number;\n  /**\n   * 引用的数据 id\n   */\n  fromDataId?: StringOrNumber;\n  /**\n   * 数据 transform 配置\n   */\n  transforms?: BuildInTransformOptions[];\n  /**\n   * 数据字段相关配置\n   */\n  fields?: Record<\n    /** 字段key */\n    string,\n    IFieldsMeta\n  >;\n  /**\n   * 数据解析器配置\n   */\n  parser?: SheetParseOptions | CommonParseOptions;\n}\n\nexport type IHierarchyNodeData = {\n  value?: number;\n  children?: IHierarchyNodeData[];\n} & Datum;\n\nexport interface IHierarchyDataValues extends Omit<IDataValues, 'values'> {\n  values: IHierarchyNodeData;\n}\n\nexport type IHierarchyData = DataView | IHierarchyDataValues;\n\n/** series */\nexport interface ISeriesSpec extends IInteractionSpec {\n  /** 系列类型 */\n  type: SeriesType;\n\n  /** 系列名称 */\n  name?: string;\n\n  /** 用户自定义的 series id */\n  id?: StringOrNumber;\n  /**\n   * 系列数据\n   * @description 系列可以配置自身的数据，也可以从chart.data中获取数据\n   */\n  data?: IDataType;\n  /**\n   * 系列关联的数据索引\n   * @default 0\n   */\n  dataIndex?: number;\n  /**\n   * 系列关联的数据id\n   */\n  dataId?: StringOrNumber;\n  /**\n   * dataKey用于绑定数据与Mark的关系, 该配置在动画中非常重要.\n   */\n  dataKey?: DataKeyType;\n\n  /**\n   * 系列关联的region索引\n   * @default 0\n   */\n  regionIndex?: number;\n  /** 系列关联的region id */\n  regionId?: StringOrNumber;\n  /**\n   * 分组字段\n   */\n  seriesField?: string;\n  /**\n   * 系列样式\n   * @description 仅在图表配置了seriesField时生效\n   */\n  seriesStyle?: ISeriesStyle;\n\n  /** 是否对数据进行堆叠处理 */\n  stack?: boolean;\n\n  /**\n   * 堆叠时的分组值\n   * stackValue 相等的系列将在一起堆积。没有配置的系列将在一组\n   * @since 1.4.0\n   */\n  stackValue?: StringOrNumber;\n\n  /** 堆叠汇总标签\n   * @since 1.3.0\n   */\n  totalLabel?: ITotalLabelSpec;\n\n  /** 是否对数据进行百分比处理 */\n  percent?: boolean;\n\n  /** 是否围绕中心轴偏移轮廓 */\n  stackOffsetSilhouette?: boolean;\n\n  /**\n   * 非合规数据点连接方式\n   * @description null，undefined等非法数据点连接方式。\n   * @default 'break'\n   * 'break'指在该数据点处断开\n   * 'link' 指忽略该点保持连续\n   * 'zero' 指该点默认数值为0\n   * 'ignore' 指不处理\n   */\n  invalidType?: IInvalidType;\n\n  /** 系列对应的提示信息设置，优先级高于图表的tooltip配置 */\n  tooltip?: ISeriesTooltipSpec;\n\n  /**\n   * 是否开启系列动画\n   */\n  animation?: boolean;\n  /**\n   * 自动关闭动画的阀值，对应的是单系列data的长度\n   * @since 1.2.0\n   */\n  animationThreshold?: number;\n\n  /**\n   * 是否支持3d视角\n   */\n  support3d?: boolean;\n  /**\n   * morph 动画配置\n   */\n  morph?: IMorphSeriesSpec;\n\n  /**\n   * 系列的扩展mark，能够获取系列上的数据\n   */\n  extensionMark?: (IExtensionMarkSpec<Exclude<EnableMarkType, 'group'>> | IExtensionGroupMarkSpec)[];\n\n  /**\n   * 今当通过`series`配置的时候，才会生效\n   */\n  zIndex?: number;\n\n  /**\n   * series background\n   * 作用是支持系列的图形对系列背景进行 mask，或者切分等效果。不是作为背景图\n   * 暂时不开放api，避免出现break change\n   */\n  // background?: IBackgroundSpec;\n}\n\nexport type IChartExtendsSeriesSpec<T extends ISeriesSpec> = Omit<T, 'data' | 'morph' | 'stackValue' | 'tooltip'>;\n\nexport type AdaptiveSpec<T, K extends keyof any> = {\n  [key in Exclude<keyof T, K>]: T[key];\n} & { [key in K]: any };\n\nexport interface IMarkStateFullSpec<T> extends Record<string, IMarkStateSpec<T> | IMarkStateStyleSpec<T>> {\n  /**\n   * 正常状态下图元的样式设置\n   */\n  normal?: IMarkStateSpec<T> | IMarkStateStyleSpec<T>;\n  /**\n   * hover状态下图元的样式设置\n   */\n  hover?: IMarkStateSpec<T> | IMarkStateStyleSpec<T>;\n  /**\n   * 没有被hover的状态下图元的样式设置\n   */\n  hover_reverse?: IMarkStateSpec<T> | IMarkStateStyleSpec<T>;\n  /**\n   * 选中状态下图元的样式设置\n   */\n  selected?: IMarkStateSpec<T> | IMarkStateStyleSpec<T>;\n  /**\n   * 没有被选中的状态下图元的样式设置\n   */\n  selected_reverse?: IMarkStateSpec<T> | IMarkStateStyleSpec<T>;\n}\n\n/** markSpec */\nexport type IMarkSpec<T extends ICommonSpec = ICommonSpec> = {\n  /**\n   * 用户id\n   */\n  id?: StringOrNumber;\n  /**\n   * 是否响应交互\n   */\n  interactive?: boolean;\n  // /**\n  //  * 是否会被region区域裁减\n  //  * @todo 暂未支持\n  //  */\n  // clip?: boolean;\n  /**\n   * 与其他mark元素的层级\n   */\n  zIndex?: number;\n  /**\n   * mark 层 是否显示配置\n   */\n  visible?: boolean;\n  /** 默认样式设置 */\n  style?: ConvertToMarkStyleSpec<T>;\n  /** 不同状态下的样式配置 */\n  state?: IMarkStateFullSpec<T>;\n  /**\n   * 状态排序方法，默认状态都是按照添加的顺序处理的，如果有特殊的需求，需要指定状态顺序，可以通过这个方法实现\n   * @since 1.9.0\n   */\n  stateSort?: (stateA: string, stateB: string) => number;\n\n  /*\n   * 是否是3d视角的mark\n   */\n  support3d?: boolean;\n  /* customized shape of mark  */\n  customShape?: (datum: any[], attrs: any, path: ICustomPath2D) => ICustomPath2D;\n} & IMarkProgressiveConfig;\n\nexport type IMarkStateFilter =\n  | {\n      /** 维度筛选 */\n      fields: { [key in string]: { type: 'ordinal' | 'linear'; domain: StringOrNumber[] } };\n    }\n  | {\n      /** 筛选数据 */\n      datums: Datum[];\n      /** 筛选数据 */\n      datumKeys: string[];\n    }\n  | {\n      /** 筛选 item */\n      items: IElement[];\n    }\n  /** 筛选函数 */\n  | ((datum: Datum, options: Record<string, any>) => boolean);\n\nexport interface IMarkStateSpec<T> {\n  /** 筛选器 */\n  filter?: IMarkStateFilter;\n  /** 状态优先级 */\n  level?: number | undefined;\n  style: ConvertToMarkStyleSpec<T>;\n}\n\nexport type IMarkStateStyleSpec<T> = ConvertToMarkStyleSpec<T>;\n\nexport interface IMarkStateTheme<T> extends Record<string, T> {\n  /**\n   * 图元在正常状态下的主题样式设置\n   */\n  normal?: T;\n  /**\n   * 图元在 hover 状态下的主题样式设置\n   */\n  hover?: T;\n  /**\n   * 图元在 未被hover 状态下的主题样式设置\n   */\n  hover_reverse?: T;\n  /**\n   * 图元在 选中状态下的主题样式设置\n   */\n  selected?: T;\n  /**\n   * 图元在 未被选中 状态下的主题样式设置\n   */\n  selected_reverse?: T;\n}\n\nexport type IMarkTheme<T> = {\n  /**\n   * mark 层 是否显示配置\n   */\n  visible?: boolean;\n  /** 默认样式设置 */\n  style?: T;\n  /** 不同状态下的样式配置 */\n  state?: IMarkStateTheme<T>;\n  /**\n   * 可交互的开关\n   */\n  interactive?: boolean;\n};\n\nexport interface IPerformanceHook {\n  // constructor\n  // 创建完成。在使用 vstory 的场景下，图表实例不由业务创建，业务想要获取图表时机非常靠后，因此补充一个钩子\n  afterCreateVChart?: (vchart?: IVChart) => void;\n\n  // InitRender\n  //   ├── InitializeChart\n  //   ├── CompileToVGrammar\n  //   ├── ParseView\n  //   |  └── ParseExpression\n  //   ├── (new View)\n  //   |  ├── CreateRuntime\n  //   |  └── (view.initialize)\n  //   |     └── CreateVRenderStage\n  //   └── SrViewEvaluateAsync / SrViewRunAsync\n  //      ├── MarkTransform\n  //      ├── FacetTransform\n  //      ├── CreateVRenderMark\n  //      └── VRenderDraw\n\n  // 初始化图表配置\n  beforeInitializeChart?: (vchart?: IVChart) => void;\n  afterInitializeChart?: (vchart?: IVChart) => void;\n\n  // 编译\n  beforeCompileToVGrammar?: () => void;\n  afterCompileToVGrammar?: () => void;\n  // 各个图表模块编译\n  beforeRegionCompile?: () => void;\n  afterRegionCompile?: () => void;\n  beforeSeriesCompile?: () => void;\n  afterSeriesCompile?: () => void;\n  beforeComponentCompile?: () => void;\n  afterComponentCompile?: () => void;\n\n  // resize的时候的钩子\n  beforeResizeWithUpdate?: () => void;\n  afterResizeWithUpdate?: () => void;\n\n  // LayoutWithSceneGraph 二次布局\n  beforeLayoutWithSceneGraph?: () => void;\n  afterLayoutWithSceneGraph?: () => void;\n\n  // VGrammar 解析spec\n  beforeParseView?: () => void;\n  afterParseView?: () => void;\n\n  // 初始化runtime\n  beforeCreateRuntime?: () => void;\n  afterCreateRuntime?: () => void;\n\n  // VGrammar EvaluateAsync 时间\n  beforeSrViewEvaluateAsync?: () => void;\n  afterSrViewEvaluateAsync?: () => void;\n\n  // VGrammar RunAsync 时间\n  beforeSrViewRunAsync?: () => void;\n  afterSrViewRunAsync?: () => void;\n\n  // transform测量\n  beforeTransform?: (name: string) => void;\n  afterTransform?: (name: string) => void;\n\n  // Create VRender Stage 时间\n  beforeCreateVRenderStage?: () => void;\n  afterCreateVRenderStage?: () => void;\n\n  // Create VRender Mark 时间\n  beforeCreateVRenderMark?: () => void;\n  afterCreateVRenderMark?: () => void;\n\n  // VGrammar 创建元素完成，vrender 绘图之前\n  beforeDoRender?: (vchart?: IVChart) => void;\n\n  // VRender Draw 时间\n  beforeVRenderDraw?: () => void;\n  afterVRenderDraw?: () => void;\n}\n\nexport type IBuildinMarkSpec = {\n  group: IGroupMarkSpec;\n  symbol: ISymbolMarkSpec;\n  rule: IRuleMarkSpec;\n  line: ILineMarkSpec;\n  text: ITextMarkSpec;\n  rect: IRectMarkSpec;\n  rect3d: IRect3dMarkSpec;\n  image: IImageMarkSpec;\n  path: IPathMarkSpec;\n  area: IAreaMarkSpec;\n  arc: IArcMarkSpec;\n  arc3d: IArc3dMarkSpec;\n  polygon: IPolygonMarkSpec;\n  pyramid3d: IPyramid3dMarkSpec;\n  boxPlot: IBoxPlotMarkSpec;\n  linkPath: ILinkPathMarkSpec;\n  ripple: IRippleMarkSpec;\n};\n\nexport type EnableMarkType = keyof IBuildinMarkSpec;\nexport interface ICustomMarkSpec<T extends EnableMarkType>\n  extends IModelSpec,\n    IMarkSpec<IBuildinMarkSpec[T]>,\n    IAnimationSpec<string, string> {\n  type: T;\n  /**\n   * mark对应的名称，主要用于事件过滤如： { markName: 'yourName' }\n   * @since 1.12.5\n   */\n  name?: string;\n  /**\n   * 关联的数据索引\n   * @default 与系列使用同一份数据\n   */\n  dataIndex?: number;\n  /**\n   * dataKey用于绑定数据与Mark的关系\n   * 如果数据和系列数据一致，可以不配置，默认会读取系列中的配置\n   *\n   * @support since 1.9.5\n   */\n  dataKey?: string | ((datum: any) => string);\n  /**\n   * 关联的数据id\n   */\n  dataId?: StringOrNumber;\n  /**\n   * specify the component type\n   * @support since 1.9.0\n   */\n  componentType?: string;\n  /**\n   * enable animation of custom-mark or not\n   * @since 1.11.0\n   */\n  animation?: boolean;\n  /**\n   * 指定 parent Id\n   * @since 1.13.0\n   */\n  parent?: string;\n}\nexport interface ICustomMarkGroupSpec extends ICustomMarkSpec<MarkTypeEnum.group> {\n  children?: ICustomMarkSpec<EnableMarkType>[];\n}\n\nexport interface IExtensionMarkSpec<T extends Exclude<EnableMarkType, 'group'>> extends ICustomMarkSpec<T> {\n  /**\n   * 关联的数据索引\n   * @default 与系列使用同一份数据\n   */\n  dataIndex?: number;\n  /**\n   * dataKey用于绑定数据与Mark的关系\n   * 如果数据和系列数据一致，可以不配置，默认会读取系列中的配置\n   *\n   * @support since 1.9.5\n   */\n  dataKey?: string | ((datum: any) => string);\n  /**\n   * 关联的数据id\n   */\n  dataId?: StringOrNumber;\n  /**\n   * specify the component type\n   * @support since 1.9.0\n   */\n  componentType?: string;\n}\n\nexport interface IExtensionGroupMarkSpec extends ICustomMarkSpec<MarkTypeEnum.group> {\n  /**\n   * 支持子节点\n   */\n  children?: ICustomMarkSpec<EnableMarkType>[];\n}\n\n/** 纯文本类型的 formatMethod */\nexport type ITextFormatMethod<T extends any[]> = (\n  ...args: T\n) => ITextMarkSpec['text'] | { type: 'text'; text: ITextMarkSpec['text'] };\n\nexport type IRichTextFormatMethod<T extends any[]> = (...args: T) =>\n  | {\n      /**\n       * 设置文本类型为富文本\n       */\n      type: 'rich';\n      /**\n       * 当文本类型为富文本的时候，设置文本的内容\n       */\n      text: IRichTextCharacter[];\n    }\n  | IRichTextCharacter[];\n\n/**\n * 常规 text.formatMethod 支持返回文字字符串，或统一的对象配置\n * （这里特指由 vgrammar 代理的 text 图元）\n */\nexport type IFormatMethod<T extends any[]> = (\n  ...args: T\n) => ReturnType<ITextFormatMethod<T>> | ReturnType<IRichTextFormatMethod<T>>;\n"]}
+{"version":3,"sources":["../src/typings/spec/common.ts"],"names":[],"mappings":";;;AAyHA,IAAY,cAWX;AAXD,WAAY,cAAc;IACxB,qDAAqC,CAAA;IACrC,mDAAmC,CAAA;IACnC,+BAAe,CAAA;IACf,mCAAmB,CAAA;IACnB,qCAAqB,CAAA;IACrB,2BAAW,CAAA;IACX,2BAAW,CAAA;IACX,qCAAqB,CAAA;IACrB,qDAAqC,CAAA;IACrC,+BAAe,CAAA;AACjB,CAAC,EAXW,cAAc,GAAd,sBAAc,KAAd,sBAAc,QAWzB","file":"common.js","sourcesContent":["import type { IVChart } from './../../core/interface';\nimport type { IImageMarkSpec } from '../visual';\nimport type { LayoutCallBack } from '../../layout/interface';\nimport type {\n  DataSet,\n  DataView,\n  ISimplifyOptions,\n  IFieldsOptions,\n  IFilterOptions,\n  IFoldOptions,\n  IDsvParserOptions\n} from '@visactor/vdataset';\nimport type { RegionSpec } from '../../region/interface';\nimport type { IHoverSpec, ISelectSpec, IInteractionSpec } from '../../interaction/interface/spec';\nimport type { IRenderOption } from '../../compile/interface';\nimport type { ISeriesTooltipSpec, ITooltipSpec } from '../../component/tooltip/interface';\n// eslint-disable-next-line no-duplicate-imports\nimport type { ILayoutSpec } from '../../layout/interface';\n// eslint-disable-next-line no-duplicate-imports\nimport type {\n  ConvertToMarkStyleSpec,\n  IArc3dMarkSpec,\n  IArcMarkSpec,\n  IAreaMarkSpec,\n  IBoxPlotMarkSpec,\n  ICommonSpec,\n  IGroupMarkSpec,\n  ILineMarkSpec,\n  ILinkPathMarkSpec,\n  IPathMarkSpec,\n  IPolygonMarkSpec,\n  IPyramid3dMarkSpec,\n  IRect3dMarkSpec,\n  IRectMarkSpec,\n  IRuleMarkSpec,\n  ISymbolMarkSpec,\n  IRippleMarkSpec,\n  ITextMarkSpec,\n  IVisualSpecScale\n} from '../visual';\nimport type { StateValue } from '../../compile/mark/interface';\nimport type { ISeriesStyle, SeriesType } from '../../series/interface';\nimport type { Datum, StringOrNumber } from '../common';\nimport type { IInvalidType } from '../data';\nimport type { IAnimationSpec, IMorphSeriesSpec } from '../../animation/spec';\nimport type { IPlayer } from '../../component/player/interface';\nimport type { IMark, IMarkProgressiveConfig, IMarkRaw, MarkTypeEnum } from '../../mark/interface';\nimport type { IDataZoomSpec } from '../../component/data-zoom/data-zoom/interface';\nimport type { IScrollBarSpec } from '../../component/data-zoom/scroll-bar/interface';\nimport type { ICrosshairSpec } from '../../component/crosshair/interface';\nimport type { ITheme } from '../../theme/interface';\nimport type { ITitleSpec } from '../../component/title/interface';\nimport type { IBrushSpec } from '../../component/brush/interface';\nimport type { ITotalLabelSpec } from '../../component/label/interface';\nimport type { ILegendSpec } from '../../component/legend/interface';\nimport type { ILayoutOrientPadding, ILayoutPaddingSpec } from '../layout';\nimport type { IColor, ICustomPath2D, IGraphic, IOption3D, IRichTextCharacter } from '@visactor/vrender-core';\nimport type { ICommonAxisSpec } from '../../component/axis/interface';\nimport type { IMediaQuerySpec } from './media-query';\nimport type { IModelSpec } from '../../model/interface';\n\nexport type IChartPadding = ILayoutOrientPadding | number;\n\n/** chart option */\nexport interface IInitOption extends Omit<IRenderOption, 'pluginList'> {\n  /**\n   * **仅生效于浏览器环境。**\n   * 图表挂载的父容器，可以直接指定容器 id，也可以传入 dom 对象\n   */\n  dom?: string | HTMLElement;\n  /**\n   * 除去选择 dom 属性进行挂载父容器，也可以使用 renderCanvas 属性直接传入 canvas 实例/ canvasId\n   * 小程序/小组件环境请直接传入 id\n   */\n  renderCanvas?: string | HTMLCanvasElement;\n  /** 数据集 */\n  dataSet?: DataSet;\n  /** 是否自适应容器大小 */\n  autoFit?: boolean;\n  /**\n   * 是否开启动画\n   */\n  animation?: boolean;\n\n  /**\n   * 自定义布局函数\n   */\n  layout?: LayoutCallBack;\n\n  /**\n   * 当文本省略时，鼠标 hover 到文本上时是否显示 poptip\n   * @default true\n   */\n  poptip?: boolean;\n\n  /**\n   * 报错的回调函数\n   * @since 1.2.0\n   */\n  onError?: (...args: any[]) => void;\n\n  /**\n   * 默认主题（支持完整主题对象或者主题名称，主题名称需要提前在 `ThemeManager` 中注册）\n   * @since 1.3.0\n   */\n  theme?: string | ITheme;\n\n  /**\n   * 是否关闭交互效果\n   * @since 1.9.0\n   * @default false\n   */\n  disableTriggerEvent?: boolean;\n  /**\n   * 当自动响应容器resize 事件时，触发resize 的间隔时长，单位毫秒\n   * @since 1.12.5\n   * @default 100\n   */\n  resizeDelay?: number;\n}\n\nexport enum RenderModeEnum {\n  'desktop-browser' = 'desktop-browser',\n  'mobile-browser' = 'mobile-browser',\n  'node' = 'node',\n  'worker' = 'worker',\n  'miniApp' = 'miniApp',\n  'wx' = 'wx',\n  'tt' = 'tt',\n  'harmony' = 'harmony',\n  'desktop-miniApp' = 'desktop-miniApp',\n  'lynx' = 'lynx'\n}\nexport type RenderMode = keyof typeof RenderModeEnum;\n\n/** chart spec */\nexport interface IChartSpec {\n  /** 图表类型 */\n  type: string;\n  /** 数据 */\n  data?: IData;\n  /** 画布宽度 */\n  width?: number;\n  /** 画布高度 */\n  height?: number;\n  /**\n   * 图表宽高是否自适应容器，浏览器环境下默认为 true。\n   * 该配置的优先级高于构造函数中的 autoFit 配置。\n   * 如果用户配置了 width，则以用户配置的 width 为准，height 同理。\n   */\n  autoFit?: boolean;\n  /**\n   * 图表整体 padding 设置\n   */\n  padding?: ILayoutPaddingSpec;\n  /**\n   * 图表色系配置\n   */\n  color?: string[] | Omit<IVisualSpecScale<unknown, string>, 'id'>;\n  /**\n   * 系列\n   * @description 仅在组合图中使用, 文档中除组合图外均未透出该配置\n   */\n  series?: ISeriesSpec[];\n  /**\n   * 系列样式\n   * @description 仅在图表配置了seriesField时生效\n   */\n  seriesStyle?: ISeriesStyle;\n\n  /**\n   * 自动关闭动画的阀值，对应的是单系列data的长度\n   * @since 1.2.0\n   */\n  animationThreshold?: number;\n\n  /** hover 交互 */\n  hover?: boolean | IHoverSpec;\n  /** select 交互 */\n  select?: boolean | ISelectSpec;\n\n  /** region配置 */\n  region?: RegionSpec[];\n  /** 图表标题配置 */\n  title?: ITitleSpec;\n  /** 布局配置 */\n  layout?: ILayoutSpec;\n  /** 图例配置 */\n  legends?: ILegendSpec | ILegendSpec[];\n  /** 十字辅助线配置 */\n  crosshair?: ICrosshairSpec | ICrosshairSpec[];\n  /** tooltip配置 */\n  tooltip?: ITooltipSpec;\n  /** 播放器配置 */\n  player?: IPlayer;\n  /** 缩略轴配置 */\n  dataZoom?: IDataZoomSpec | IDataZoomSpec[];\n  /** 滚动条配置 */\n  scrollBar?: IScrollBarSpec | IScrollBarSpec[];\n  /** 框选配置 */\n  brush?: IBrushSpec;\n  /** 全局 scale 配置 */\n  scales?: IVisualSpecScale<unknown, unknown>[];\n  /** 自定义mark */\n  customMark?: ICustomMarkSpec<EnableMarkType>[];\n  /** 轴 */\n  axes?: ICommonAxisSpec[];\n  /**\n   * 图表上的主题定义。\n   * 可以直接配置主题名，前提是该主题名已经注册\n   */\n  theme?: Omit<ITheme, 'name'> | string;\n  /**\n   * 图表背景色配置，优先级高于构造函数中的 background 配置\n   * 自1.11.6版本支持渐变色对象的配置\n   */\n  background?: IBackgroundSpec;\n\n  // TODO：后续开放，现在仍有问题\n  // poptip?: PopTipAttributes;\n  // TODO: 补充动画配置\n\n  /**\n   * 堆积时是否逆序\n   * @default false\n   * @since 1.4.0\n   */\n  stackInverse?: boolean;\n  /**\n   * 堆积时是否排序\n   * @default false\n   * @since 1.10.4\n   */\n  stackSort?: boolean;\n  /**\n   * 媒体查询配置\n   * @since 1.8.0\n   */\n  media?: IMediaQuerySpec;\n}\n\nexport type IBackgroundSpec = IColor | ConvertToMarkStyleSpec<IGroupMarkSpec>;\n\n/** data */\nexport type IDataType = IDataValues | DataView;\nexport type IData = IDataType | IDataType[];\nexport type DataKeyType = string | string[] | ((data: Datum, index: number) => string);\nexport type BuildInTransformOptions =\n  | {\n      /** 地理数据简化 */\n      type: 'simplify';\n      options: ISimplifyOptions;\n    }\n  | {\n      /** 数据维度处理，包括排序，逆序，数据筛选能力 */\n      type: 'fields';\n      options: IFieldsOptions;\n    }\n  | {\n      /** 使用回调的自定义筛选 */\n      type: 'filter';\n      options: IFilterOptions;\n    }\n  | {\n      /** 数据展开 */\n      type: 'fold';\n      options: IFoldOptions;\n    };\n\nexport interface IFieldsMeta {\n  /** TODO: 字段通用format, 暂时先不支持 */\n  // format?: (datum: Datum, index: number) => unknown;\n  /** 字段别名 */\n  alias?: string;\n  /** 字段取值范围 */\n  domain?: StringOrNumber[];\n  /** 是否使用 domain 锁定统计信息。默认为 false */\n  lockStatisticsByDomain?: boolean;\n  /** 连续型 还是 离散型 */\n  type?: 'ordinal' | 'linear';\n  /** 排序顺序 不设置的话当前维度不进行排序 */\n  sortIndex?: number;\n  /** 排序时是否反转 默认为 false */\n  sortReverse?: boolean;\n}\n\nexport interface SheetParseOptions extends CommonParseOptions {\n  /**\n   * 特定类型的数据，支持以下类型：\n   * - csv: 逗号分隔值（Comma-Separated Values，CSV，有时也称为字符分隔值，因为分隔字符也可以不是逗号），其文件以纯文本形式存储表格数据（数字和文本）。\n   * - dsv: 分隔值（Delimiter-Separated Values，DSV，有时也称为字符分隔值，因为分隔字符也可以不是逗号），其文件以纯文本形式存储表格数据（数字和文本）。\n   * - tsv: 制表符分隔值（Tab-Separated Values，TSV，有时也称为字符分隔值，因为分隔字符也可以不是逗号），其文件以纯文本形式存储表格数据（数字和文本）。\n   */\n  type: 'csv' | 'dsv' | 'tsv';\n  /**\n   * 具体的解析配置\n   */\n  options?: IDsvParserOptions;\n}\n\nexport interface CommonParseOptions {\n  /**\n   * 是否需要对数据进行 clone，默认为 true。\n   * 如果考虑性能，你可以将其关闭，但是这会带了一些副作用，即我们会对传入的数据进行修改（不会对原有字段及值修改，只会在原有数据基础上添加一些字段）。\n   * @default true\n   * @since 1.3.0\n   */\n  clone?: boolean;\n}\n\nexport interface IDataValues {\n  /**\n   * 数据唯一标识\n   */\n  id?: StringOrNumber;\n  /**\n   * 数据\n   */\n  values: Datum[] | string;\n  /**\n   * 引用的数据索引\n   */\n  fromDataIndex?: number;\n  /**\n   * 引用的数据 id\n   */\n  fromDataId?: StringOrNumber;\n  /**\n   * 数据 transform 配置\n   */\n  transforms?: BuildInTransformOptions[];\n  /**\n   * 数据字段相关配置\n   */\n  fields?: Record<\n    /** 字段key */\n    string,\n    IFieldsMeta\n  >;\n  /**\n   * 数据解析器配置\n   */\n  parser?: SheetParseOptions | CommonParseOptions;\n}\n\nexport type IHierarchyNodeData = {\n  value?: number;\n  children?: IHierarchyNodeData[];\n} & Datum;\n\nexport interface IHierarchyDataValues extends Omit<IDataValues, 'values'> {\n  values: IHierarchyNodeData;\n}\n\nexport type IHierarchyData = DataView | IHierarchyDataValues;\n\n/** series */\nexport interface ISeriesSpec extends IInteractionSpec {\n  /** 系列类型 */\n  type: SeriesType;\n\n  /** 系列名称 */\n  name?: string;\n\n  /** 用户自定义的 series id */\n  id?: StringOrNumber;\n  /**\n   * 系列数据\n   * @description 系列可以配置自身的数据，也可以从chart.data中获取数据\n   */\n  data?: IDataType;\n  /**\n   * 系列关联的数据索引\n   * @default 0\n   */\n  dataIndex?: number;\n  /**\n   * 系列关联的数据id\n   */\n  dataId?: StringOrNumber;\n  /**\n   * dataKey用于绑定数据与Mark的关系, 该配置在动画中非常重要.\n   */\n  dataKey?: DataKeyType;\n\n  /**\n   * 系列关联的region索引\n   * @default 0\n   */\n  regionIndex?: number;\n  /** 系列关联的region id */\n  regionId?: StringOrNumber;\n  /**\n   * 分组字段\n   */\n  seriesField?: string;\n  /**\n   * 系列样式\n   * @description 仅在图表配置了seriesField时生效\n   */\n  seriesStyle?: ISeriesStyle;\n\n  /** 是否对数据进行堆叠处理 */\n  stack?: boolean;\n\n  /**\n   * 堆叠时的分组值\n   * stackValue 相等的系列将在一起堆积。没有配置的系列将在一组\n   * @since 1.4.0\n   */\n  stackValue?: StringOrNumber;\n\n  /** 堆叠汇总标签\n   * @since 1.3.0\n   */\n  totalLabel?: ITotalLabelSpec;\n\n  /** 是否对数据进行百分比处理 */\n  percent?: boolean;\n\n  /** 是否围绕中心轴偏移轮廓 */\n  stackOffsetSilhouette?: boolean;\n\n  /**\n   * 非合规数据点连接方式\n   * @description null，undefined等非法数据点连接方式。\n   * @default 'break'\n   * 'break'指在该数据点处断开\n   * 'link' 指忽略该点保持连续\n   * 'zero' 指该点默认数值为0\n   * 'ignore' 指不处理\n   */\n  invalidType?: IInvalidType;\n\n  /** 系列对应的提示信息设置，优先级高于图表的tooltip配置 */\n  tooltip?: ISeriesTooltipSpec;\n\n  /**\n   * 是否开启系列动画\n   */\n  animation?: boolean;\n  /**\n   * 自动关闭动画的阀值，对应的是单系列data的长度\n   * @since 1.2.0\n   */\n  animationThreshold?: number;\n\n  /**\n   * 是否支持3d视角\n   */\n  support3d?: boolean;\n  /**\n   * morph 动画配置\n   */\n  morph?: IMorphSeriesSpec;\n\n  /**\n   * 系列的扩展mark，能够获取系列上的数据\n   */\n  extensionMark?: (IExtensionMarkSpec<Exclude<EnableMarkType, 'group'>> | IExtensionGroupMarkSpec)[];\n\n  /**\n   * 今当通过`series`配置的时候，才会生效\n   */\n  zIndex?: number;\n\n  /**\n   * series background\n   * 作用是支持系列的图形对系列背景进行 mask，或者切分等效果。不是作为背景图\n   * 暂时不开放api，避免出现break change\n   */\n  // background?: IBackgroundSpec;\n}\n\nexport type IChartExtendsSeriesSpec<T extends ISeriesSpec> = Omit<T, 'data' | 'morph' | 'stackValue' | 'tooltip'>;\n\nexport type AdaptiveSpec<T, K extends keyof any> = {\n  [key in Exclude<keyof T, K>]: T[key];\n} & { [key in K]: any };\n\nexport interface IMarkStateFullSpec<T> extends Record<string, IMarkStateSpec<T> | IMarkStateStyleSpec<T>> {\n  /**\n   * 正常状态下图元的样式设置\n   */\n  normal?: IMarkStateSpec<T> | IMarkStateStyleSpec<T>;\n  /**\n   * hover状态下图元的样式设置\n   */\n  hover?: IMarkStateSpec<T> | IMarkStateStyleSpec<T>;\n  /**\n   * 没有被hover的状态下图元的样式设置\n   */\n  hover_reverse?: IMarkStateSpec<T> | IMarkStateStyleSpec<T>;\n  /**\n   * 选中状态下图元的样式设置\n   */\n  selected?: IMarkStateSpec<T> | IMarkStateStyleSpec<T>;\n  /**\n   * 没有被选中的状态下图元的样式设置\n   */\n  selected_reverse?: IMarkStateSpec<T> | IMarkStateStyleSpec<T>;\n}\n\n/** markSpec */\nexport type IMarkSpec<T extends ICommonSpec = ICommonSpec> = {\n  /**\n   * 用户id\n   */\n  id?: StringOrNumber;\n  /**\n   * 是否响应交互\n   */\n  interactive?: boolean;\n  // /**\n  //  * 是否会被region区域裁减\n  //  * @todo 暂未支持\n  //  */\n  // clip?: boolean;\n  /**\n   * 与其他mark元素的层级\n   */\n  zIndex?: number;\n  /**\n   * mark 层 是否显示配置\n   */\n  visible?: boolean;\n  /** 默认样式设置 */\n  style?: ConvertToMarkStyleSpec<T>;\n  /** 不同状态下的样式配置 */\n  state?: IMarkStateFullSpec<T>;\n  /**\n   * 状态排序方法，默认状态都是按照添加的顺序处理的，如果有特殊的需求，需要指定状态顺序，可以通过这个方法实现\n   * @since 1.9.0\n   */\n  stateSort?: (stateA: string, stateB: string) => number;\n\n  /*\n   * 是否是3d视角的mark\n   */\n  support3d?: boolean;\n  /* customized shape of mark  */\n  customShape?: (datum: any[], attrs: any, path: ICustomPath2D) => ICustomPath2D;\n} & IMarkProgressiveConfig;\n\nexport type IMarkStateFilter =\n  | {\n      /** 维度筛选 */\n      fields: { [key in string]: { type: 'ordinal' | 'linear'; domain: StringOrNumber[] } };\n    }\n  | {\n      /** 筛选数据 */\n      datums: Datum[];\n      /** 筛选数据 */\n      datumKeys: string[];\n    }\n  | {\n      /** 筛选 item */\n      items: IGraphic[];\n    }\n  /** 筛选函数 */\n  | ((\n      datum: Datum,\n      options: {\n        mark?: IMark;\n        type?: string;\n        renderNode?: IGraphic;\n      }\n    ) => boolean);\n\nexport interface IMarkStateSpec<T> {\n  /** 筛选器 */\n  filter?: IMarkStateFilter;\n  /** 状态优先级 */\n  level?: number | undefined;\n  style: ConvertToMarkStyleSpec<T>;\n}\n\nexport type IMarkStateStyleSpec<T> = ConvertToMarkStyleSpec<T>;\n\nexport interface IMarkStateTheme<T> extends Record<string, T> {\n  /**\n   * 图元在正常状态下的主题样式设置\n   */\n  normal?: T;\n  /**\n   * 图元在 hover 状态下的主题样式设置\n   */\n  hover?: T;\n  /**\n   * 图元在 未被hover 状态下的主题样式设置\n   */\n  hover_reverse?: T;\n  /**\n   * 图元在 选中状态下的主题样式设置\n   */\n  selected?: T;\n  /**\n   * 图元在 未被选中 状态下的主题样式设置\n   */\n  selected_reverse?: T;\n}\n\nexport type IMarkTheme<T> = {\n  /**\n   * mark 层 是否显示配置\n   */\n  visible?: boolean;\n  /** 默认样式设置 */\n  style?: T;\n  /** 不同状态下的样式配置 */\n  state?: IMarkStateTheme<T>;\n  /**\n   * 可交互的开关\n   */\n  interactive?: boolean;\n};\n\nexport interface IPerformanceHook {\n  // constructor\n  // 创建完成。在使用 vstory 的场景下，图表实例不由业务创建，业务想要获取图表时机非常靠后，因此补充一个钩子\n  afterCreateVChart?: (vchart?: IVChart) => void;\n\n  // InitRender\n  //   ├── InitializeChart\n  //   ├── CompileToVGrammar\n  //   ├── ParseView\n  //   |  └── ParseExpression\n  //   ├── (new View)\n  //   |  ├── CreateRuntime\n  //   |  └── (view.initialize)\n  //   |     └── CreateVRenderStage\n  //   └── SrViewEvaluateAsync / SrViewRunAsync\n  //      ├── MarkTransform\n  //      ├── FacetTransform\n  //      ├── CreateVRenderMark\n  //      └── VRenderDraw\n\n  // 初始化图表配置\n  beforeInitializeChart?: (vchart?: IVChart) => void;\n  afterInitializeChart?: (vchart?: IVChart) => void;\n\n  // 编译\n  beforeCompileToVGrammar?: (vchart?: IVChart) => void;\n  afterCompileToVGrammar?: (vchart?: IVChart) => void;\n  // 各个图表模块编译\n  beforeRegionCompile?: (vchart?: IVChart) => void;\n  afterRegionCompile?: (vchart?: IVChart) => void;\n  beforeSeriesCompile?: (vchart?: IVChart) => void;\n  afterSeriesCompile?: (vchart?: IVChart) => void;\n  beforeComponentCompile?: (vchart?: IVChart) => void;\n  afterComponentCompile?: (vchart?: IVChart) => void;\n\n  // resize的时候的钩子\n  beforeResizeWithUpdate?: (vchart?: IVChart) => void;\n  afterResizeWithUpdate?: (vchart?: IVChart) => void;\n\n  // LayoutWithSceneGraph 二次布局\n  beforeLayoutWithSceneGraph?: (vchart?: IVChart) => void;\n  afterLayoutWithSceneGraph?: (vchart?: IVChart) => void;\n\n  // VGrammar 解析spec\n  beforeParseView?: (vchart?: IVChart) => void;\n  afterParseView?: (vchart?: IVChart) => void;\n\n  // 初始化runtime\n  beforeCreateRuntime?: (vchart?: IVChart) => void;\n  afterCreateRuntime?: (vchart?: IVChart) => void;\n\n  // VGrammar EvaluateAsync 时间\n  beforeSrViewEvaluateAsync?: (vchart?: IVChart) => void;\n  afterSrViewEvaluateAsync?: (vchart?: IVChart) => void;\n\n  // VGrammar RunAsync 时间\n  beforeSrViewRunAsync?: (vchart?: IVChart) => void;\n  afterSrViewRunAsync?: (vchart?: IVChart) => void;\n\n  // transform测量\n  beforeTransform?: (name: string, vchart?: IVChart) => void;\n  afterTransform?: (name: string, vchart?: IVChart) => void;\n\n  // Create VRender Stage 时间\n  beforeCreateVRenderStage?: (vchart?: IVChart) => void;\n  afterCreateVRenderStage?: (vchart?: IVChart) => void;\n\n  // Create VRender Mark 时间\n  beforeCreateVRenderMark?: (vchart?: IVChart) => void;\n  afterCreateVRenderMark?: (vchart?: IVChart) => void;\n\n  // VGrammar 创建元素完成，vrender 绘图之前\n  beforeDoRender?: (vchart?: IVChart) => void;\n\n  // VRender Draw 时间\n  beforeVRenderDraw?: (vchart?: IVChart) => void;\n  afterVRenderDraw?: (vchart?: IVChart) => void;\n}\n\nexport type IBuildinMarkSpec = {\n  group: IGroupMarkSpec;\n  symbol: ISymbolMarkSpec;\n  rule: IRuleMarkSpec;\n  line: ILineMarkSpec;\n  text: ITextMarkSpec;\n  rect: IRectMarkSpec;\n  rect3d: IRect3dMarkSpec;\n  image: IImageMarkSpec;\n  path: IPathMarkSpec;\n  area: IAreaMarkSpec;\n  arc: IArcMarkSpec;\n  arc3d: IArc3dMarkSpec;\n  polygon: IPolygonMarkSpec;\n  pyramid3d: IPyramid3dMarkSpec;\n  boxPlot: IBoxPlotMarkSpec;\n  linkPath: ILinkPathMarkSpec;\n  ripple: IRippleMarkSpec;\n};\n\nexport type EnableMarkType = keyof IBuildinMarkSpec;\nexport interface ICustomMarkSpec<T extends EnableMarkType>\n  extends IModelSpec,\n    IMarkSpec<IBuildinMarkSpec[T]>,\n    IAnimationSpec<string, string> {\n  type: T;\n  /**\n   * mark对应的名称，主要用于事件过滤如： { markName: 'yourName' }\n   * @since 1.12.5\n   */\n  name?: string;\n  /**\n   * 关联的数据索引\n   * @default 与系列使用同一份数据\n   */\n  dataIndex?: number;\n  /**\n   * dataKey用于绑定数据与Mark的关系\n   * 如果数据和系列数据一致，可以不配置，默认会读取系列中的配置\n   *\n   * @support since 1.9.5\n   */\n  dataKey?: string | ((datum: any) => string);\n  /**\n   * 关联的数据id\n   */\n  dataId?: StringOrNumber;\n  /**\n   * specify the component type\n   * @support since 1.9.0\n   */\n  componentType?: string;\n  /**\n   * enable animation of custom-mark or not\n   * @since 1.11.0\n   */\n  animation?: boolean;\n  /**\n   * 指定 parent Id\n   * @since 1.13.0\n   */\n  parent?: string;\n}\nexport interface ICustomMarkGroupSpec extends ICustomMarkSpec<MarkTypeEnum.group> {\n  children?: ICustomMarkSpec<EnableMarkType>[];\n}\n\nexport interface IExtensionMarkSpec<T extends Exclude<EnableMarkType, 'group'>> extends ICustomMarkSpec<T> {\n  /**\n   * 关联的数据索引\n   * @default 与系列使用同一份数据\n   */\n  dataIndex?: number;\n  /**\n   * dataKey用于绑定数据与Mark的关系\n   * 如果数据和系列数据一致，可以不配置，默认会读取系列中的配置\n   *\n   * @support since 1.9.5\n   */\n  dataKey?: string | ((datum: any) => string);\n  /**\n   * 关联的数据id\n   */\n  dataId?: StringOrNumber;\n  /**\n   * specify the component type\n   * @support since 1.9.0\n   */\n  componentType?: string;\n}\n\nexport interface IExtensionGroupMarkSpec extends ICustomMarkSpec<MarkTypeEnum.group> {\n  /**\n   * 支持子节点\n   */\n  children?: ICustomMarkSpec<EnableMarkType>[];\n}\n\n/** 纯文本类型的 formatMethod */\nexport type ITextFormatMethod<T extends any[]> = (\n  ...args: T\n) => ITextMarkSpec['text'] | { type: 'text'; text: ITextMarkSpec['text'] };\n\nexport type IRichTextFormatMethod<T extends any[]> = (...args: T) =>\n  | {\n      /**\n       * 设置文本类型为富文本\n       */\n      type: 'rich';\n      /**\n       * 当文本类型为富文本的时候，设置文本的内容\n       */\n      text: IRichTextCharacter[];\n    }\n  | IRichTextCharacter[];\n\n/**\n * 常规 text.formatMethod 支持返回文字字符串，或统一的对象配置\n * （这里特指由 vgrammar 代理的 text 图元）\n */\nexport type IFormatMethod<T extends any[]> = (\n  ...args: T\n) => ReturnType<ITextFormatMethod<T>> | ReturnType<IRichTextFormatMethod<T>>;\n"]}

package/cjs/typings/visual.d.ts

@@ -5,7 +5,7 @@ import type { InterpolateType } from './interpolate';
 import type { ScaleType } from './scale';
 import type { ShapeType } from './shape';
 import type { IPoint } from './coordinate';
-import type { IAttributeOpt, IModelMarkAttributeContext } from '../compile/mark/interface';
+import type { IModelMarkAttributeContext } from '../compile/mark/interface';
 import type { Datum } from './common';
 import type { IPadding } from '@visactor/vutils';
 import type { IColorKey } from '../theme/color-scheme/interface';
@@ -18,6 +18,7 @@ export interface IVisualSpecBase<D, T> {
     specified?: {
         [key: string]: unknown;
     };
+    clamp?: boolean;
 }
 export interface IVisualSpecStyle<D, T> extends IVisualSpecBase<D, T> {
     field?: string;
@@ -36,7 +37,7 @@ export interface IVisualScale {
     field?: string;
     changeDomain?: 'none' | 'replace' | 'expand';
 }
-export type FunctionType<T> = (datum: Datum, context: IModelMarkAttributeContext, opt?: IAttributeOpt, source?: DataView) => T;
+export type FunctionType<T> = (datum: Datum, context: IModelMarkAttributeContext, source?: DataView) => T;
 export type ValueType<T> = T;
 export type VisualType<T> = ValueType<T> | FunctionType<T> | IVisual<unknown, T>;
 export type TextureType = 'circle' | 'dimond' | 'rect' | 'vertical-line' | 'horizontal-line' | 'bias-lr' | 'bias-rl' | 'grid';
@@ -132,10 +133,16 @@ export interface ITextMarkSpec extends IFillMarkSpec {
     ellipsis?: string;
     suffixPosition?: 'start' | 'end' | 'middle';
     underline?: boolean;
+    underlineDash?: number[];
+    underlineOffset?: number;
     lineThrough?: boolean;
     lineHeight?: number | string | ITokenKey;
     poptip?: PopTipAttributes;
     direction?: 'horizontal' | 'vertical';
+    wordBreak?: 'break-word' | 'break-all' | 'keep-all';
+    heightLimit?: number;
+    lineClamp?: number;
+    whiteSpace?: 'normal' | 'no-wrap';
 }
 export type IRichTextMarkSpec = IRichTextAttribute & IFillMarkSpec & {
     type: 'rich';

package/cjs/typings/visual.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/typings/visual.ts"],"names":[],"mappings":"","file":"visual.js","sourcesContent":["import type { PopTipAttributes } from '@visactor/vrender-components';\nimport type { DataView } from '@visactor/vdataset';\nimport type { Cursor } from './cursor';\nimport type { InterpolateType } from './interpolate';\nimport type { ScaleType } from './scale';\nimport type { ShapeType } from './shape';\nimport type { IPoint } from './coordinate';\nimport type { IAttributeOpt, IModelMarkAttributeContext } from '../compile/mark/interface';\nimport type { Datum } from './common';\nimport type { IPadding } from '@visactor/vutils';\nimport type { IColorKey } from '../theme/color-scheme/interface';\nimport type { ITokenKey } from '../theme/token/interface';\nimport type {\n  IRepeatType,\n  TextAlignType,\n  TextBaselineType,\n  IRichTextAttribute,\n  IGraphicStyle,\n  IColor\n} from '@visactor/vrender-core';\n\n// 基础的visual 对应 scale 的属性\nexport interface IVisualSpecBase<D, T> {\n  /**\n   * type of scale\n   */\n  type: ScaleType;\n  /**\n   * will set to scale.domain, it means input of scale\n   */\n  domain: D[];\n  /**\n   * will set to scale.range, it means output of scale\n   */\n  range: T[];\n  /**\n   * will set to scale.specified if scale support, as a key-value pair matching capability\n   * @since 1.1.0\n   */\n  specified?: { [key: string]: unknown };\n}\n// 用来给用户进行mark.style上的映射配置。所以要配置数据维度\nexport interface IVisualSpecStyle<D, T> extends IVisualSpecBase<D, T> {\n  /**\n   * 指定映射对应的数据字段\n   */\n  field?: string;\n}\n\nexport type IDataDomainSpec = {\n  /**\n   * 数据的id\n   */\n  dataId: string;\n  /**\n   * 数据字段\n   */\n  fields: string[];\n};\n\n// 用来提供给用户进行 scale 配置 所以名字是必选的 对用户配置\nexport interface IVisualSpecScale<D, T> extends Omit<IVisualSpecBase<D, T>, 'domain'> {\n  /**\n   * scale 的id\n   */\n  id: string;\n  /**\n   * 定义域范围\n   */\n  domain:\n    | IVisualSpecBase<D, T>['domain']\n    // 使用数据的字段值，如果 scale 是连续的，就取区间，如果是离散的就使用 values 。\n    // 不考虑图表内的交互等数据筛选，这里只用原始数据的统计信息\n    | IDataDomainSpec[];\n}\n// 对用户配置\nexport type IVisual<D = any, R = any> = IVisualSpecStyle<D, R> | IVisualScale;\n\nexport interface IVisualScale {\n  /**\n   * 对应 IVisualSpecScale 的用户配置 scale-id\n   */\n  scale: string;\n  /**\n   * 指定参与映射的数据字段\n   */\n  field?: string;\n  /**\n   * 当用户指定 field 后，用该属性来控制值域。\n   * @default 'none'\n   */\n  changeDomain?: 'none' | 'replace' | 'expand';\n}\n\nexport type FunctionType<T> = (\n  datum: Datum,\n  context: IModelMarkAttributeContext,\n  opt?: IAttributeOpt,\n  source?: DataView\n) => T;\nexport type ValueType<T> = T;\nexport type VisualType<T> = ValueType<T> | FunctionType<T> | IVisual<unknown, T>;\n\nexport type TextureType =\n  | 'circle'\n  | 'dimond'\n  | 'rect'\n  | 'vertical-line'\n  | 'horizontal-line'\n  | 'bias-lr'\n  | 'bias-rl'\n  | 'grid';\n\n/**\n * style格式转换\n */\nexport type ConvertToMarkStyleSpec<T extends Record<string, any>> = {\n  [key in keyof T]: VisualType<T[key]>;\n};\n\n/**\n * border\n */\nexport interface IBorder {\n  /**\n   * 边框离图形边缘的距离\n   */\n  distance: number | string;\n  /**\n   * 边框的颜色\n   */\n  stroke?: string | IGradient;\n  /**\n   * 边框的透明度\n   */\n  strokeOpacity?: number;\n  /**\n   * 边框线的宽度\n   */\n  lineWidth?: number;\n  /**\n   * 给边框配置虚线模式。它使用一组值来指定描述模式的线和间隙的交替长度\n   */\n  lineDash?: number[];\n  /**\n   * 设置边框的虚线偏移量\n   */\n  lineDashOffset?: number;\n}\n\nexport interface ICommonSpec {\n  /**\n   * 图形是否可见\n   */\n  visible?: boolean;\n  /**\n   * 图形的x坐标\n   */\n  x?: number;\n  /**\n   * 图形的y坐标\n   */\n  y?: number;\n  /**\n   * 图形的z坐标，仅适用于3D图表\n   */\n  z?: number;\n  /**\n   * 图形的描边颜色。\n   * 支持使用 'rgb(255,255,255)'，'rgba(255,255,255,1)'，'#fff' 等方式设置为纯色，也支持设置为渐变色描边\n   * @todo 隔离主题和 spec 配置\n   * IColorKey 类型只适用于主题\n   */\n  stroke?: string | IGradient | false | (number | boolean)[] | IColorKey;\n  /**\n   * 描边透明度\n   */\n  strokeOpacity?: number;\n  /**\n   * 图形的透明度，既影响描边也影响填充\n   */\n  opacity?: number;\n  /**\n   * 图形的描边宽度\n   */\n  lineWidth?: number;\n  /**\n   * 给描边配置虚线模式。它使用一组值来指定描述模式的线和间隙的交替长度\n   */\n  lineDash?: number[];\n  /**\n   * 设置虚线偏移量的属性\n   */\n  lineDashOffset?: number;\n  /**\n   * 设置图形的鼠标样式\n   */\n  cursor?: Cursor;\n  /**\n   * 设置图形的层级，主意这个是相对层级，图形引擎绘制的时候，会对相同group下的所有图形根据zIndex进行排序，然后从小到大进行渲染\n   */\n  zIndex?: number;\n  /**\n   * 图形的旋转角度\n   */\n  angle?: number;\n  /**\n   * 基于AABB的锚点位置，用于简单的定位某些path的位置\n   */\n  anchor?: [number, number];\n\n  /**\n   * x方向的缩放比例，默认为1，即不进行缩放\n   */\n  scaleX?: number;\n  /**\n   * y方向的缩放比例，默认为1，即不进行缩放\n   */\n  scaleY?: number;\n  /**\n   * 图形缩放中心\n   * @since 1.4.0\n   * 可以配置固定坐标，例如 [100, 100]；或者百分比坐标，例如 ['50%', '50%']，代表以图元中心为缩放中心\n   * */\n  scaleCenter?: [number | string, number | string];\n\n  // 3d旋转的属性\n  /**\n   * x方向的旋转角度\n   */\n  alpha?: number;\n  /**\n   * y方向的旋转角度\n   */\n  beta?: number;\n  /**\n   * 3d的锚点位置\n   */\n  anchor3d?: [number, number];\n\n  /**\n   * 选择模式，精确模式，粗糙模式（包围盒模式），自定义模式\n   */\n  pickMode?: 'accurate' | 'imprecise' | 'custom';\n  /**\n   * bounds的计算模式\n   */\n  boundsMode?: 'accurate' | 'imprecise';\n\n  /**\n   * 用于扩展描边的拾取范围，为 0 就是默认线宽，正数就加宽，负数就减宽\n   * @default 0\n   * @since 1.7.3\n   */\n  pickStrokeBuffer?: number;\n\n  // 以下是纹理相关的属性\n  /**\n   * 纹理的类型\n   */\n  texture?: TextureType | string;\n  /**\n   * 纹理的颜色\n   */\n  textureColor?: string;\n  /**\n   * 纹理单元的大小\n   */\n  textureSize?: number; // 纹理大小\n  /**\n   * 纹理之间空隙的大小\n   */\n  texturePadding?: number;\n\n  /**\n   * 外边框，外描边，描边位于图形外侧\n   */\n  outerBorder?: IBorder;\n  /**\n   * 内边框，内描边，描边位于图形内侧\n   */\n  innerBorder?: IBorder;\n  /**\n   * html 浮层，会将配置的html相关内容，绝对定位到图元的位置\n   * @experimental\n   * @since 1.10.0\n   */\n  html?: IMarkHtmlSpec;\n\n  [key: string]: any;\n}\n\nexport interface IFillMarkSpec extends ICommonSpec {\n  /**\n   * 图形的填充颜色\n   * @todo 隔离主题和 spec 配置\n   * IColorKey 类型只适用于主题\n   */\n  fill?: VisualType<string> | IGradient | false | IColorKey;\n  /**\n   * 填充的透明度\n   */\n  fillOpacity?: number;\n\n  /**\n   * 图形的背景色，支持纯色、image元素、canvas元素\n   */\n  background?: IColor | HTMLImageElement | HTMLCanvasElement | null;\n}\n\nexport type IMarkHtmlSpec = Partial<IGraphicStyle['html']>;\n\nexport interface ISymbolMarkSpec extends IFillMarkSpec {\n  /**\n   * x方向的偏移量\n   */\n  dx?: number;\n  /**\n   * y方向的偏移量\n   */\n  dy?: number;\n  /**\n   * 大小，相当于外接圆的半径\n   */\n  size?: number | number[];\n  /** 对外声明使用shape，vrender图形属性对应的是shape */\n  shape?: ShapeType | string;\n  /**\n   * 标记的类型\n   * FIXME:  vrender Symbol接收的图形属性，暂时都申明一下\n   * */\n  symbolType?: ShapeType | string;\n  /**\n   * x方向的缩放比例，默认为1，即不进行缩放\n   */\n  scaleX?: number;\n  /**\n   * y方向的缩放比例，默认为1，即不进行缩放\n   */\n  scaleY?: number;\n}\n\n// lineMark 和 areaMark 共同配置\nexport interface ILineLikeMarkSpec extends IFillMarkSpec {\n  /**\n   * 取消的差值类型，默认为线性插值，也就是普通的折线\n   */\n  curveType?: InterpolateType;\n  /**\n   * 设置点是否有效，也就是是否合法\n   */\n  defined?: boolean;\n}\n\nexport interface IAreaMarkSpec extends ILineLikeMarkSpec {\n  /**\n   * 面积的x1值\n   */\n  x1?: number;\n  /**\n   * 面积的y1值\n   */\n  y1?: number;\n  /**\n   * 面积图元的方向，\n   * horizontal - 水平方向\n   * vertical - 垂直方向\n   */\n  orient?: 'horizontal' | 'vertical';\n}\n\nexport interface ILineMarkSpec extends ILineLikeMarkSpec {\n  /**\n   * 指定如何绘制每一条线段末端的属性。有 3 个可能的值，分别是：'butt', 'round' and 'square'。默认值是 butt。\n   */\n  lineCap?: LineStrokeCap;\n  /**\n   * 用来设置 2 个长度不为 0 的相连部分（线段、圆弧、曲线）如何连接在一起的属性（长度为 0 的变形部分，其指定的末端和控制点在同一位置，会被忽略）。此属性有 3 个值： 'round', 'bevel' and 'miter'。默认值是 'miter'\n   */\n  lineJoin?: LineStrokeJoin;\n  /**\n   * 设置斜接面限制比例的属性。当获取属性值时，会返回当前的值（默认值是 10.0 ）。当给属性赋值时，0、负数、 Infinity 和 NaN 都会被忽略；除此之外都会被赋予一个新值。\n   */\n  miterLimit?: number;\n  /**\n   * stroke 的有界缓冲区\n   */\n  strokeBoundsBuffer?: number;\n}\n\nexport interface IRuleMarkSpec extends ILineMarkSpec {\n  /**\n   * 终点x坐标\n   */\n  x1?: number;\n  /**\n   * 终点y坐标\n   */\n  y1?: number;\n}\n\nexport interface ITextMarkSpec extends IFillMarkSpec {\n  /**\n   * 文字内容\n   */\n  text?: string | number | string[] | number[];\n  /**\n   * x 方向偏移\n   */\n  dx?: number;\n  /**\n   * y 方向偏移\n   */\n  dy?: number;\n  /**\n   * 字号\n   */\n  fontSize?: number | ITokenKey;\n  /**\n   * 文字对齐方式\n   */\n  textAlign?: TextAlign;\n  /**\n   * 文字居中方式\n   */\n  textBaseline?: TextBaseLine;\n  /**\n   * 字体\n   */\n  fontFamily?: string;\n  /**\n   * 字重\n   */\n  fontWeight?: FontWeight;\n  /**\n   * 字体样式\n   */\n  fontStyle?: FontStyle;\n  /**\n   * 文字的最大长度\n   */\n  maxLineWidth?: number;\n  /**\n   * 文字超出 maxLineWidth 后的省略符\n   */\n  ellipsis?: string;\n  /**\n   * 文本省略的位置，默认尾部省略\n   * 1. 'start' 文字首部省略\n   * 2. 'middle' 文本中间省略\n   * 3. 'end' 文本尾部省略\n   * @default 'end'\n   * @since 1.7.3\n   */\n  suffixPosition?: 'start' | 'end' | 'middle';\n  /**\n   * 下划线\n   */\n  underline?: boolean;\n  /**\n   * 中划线\n   */\n  lineThrough?: boolean;\n  /**\n   * 行高（1.3.1 版本新增字符串类型表示比例值，如\"150%\"）\n   * @since 1.3.1\n   */\n  lineHeight?: number | string | ITokenKey;\n  /**\n   * poptip 相关配置\n   */\n  poptip?: PopTipAttributes;\n  /**\n   * 文本的排布方向，如果需要文本纵向排布，可以配置为 'vertical'\n   * @default 'horizontal'\n   */\n  direction?: 'horizontal' | 'vertical';\n}\n\nexport type IRichTextMarkSpec = IRichTextAttribute &\n  IFillMarkSpec & { type: 'rich'; text: IRichTextAttribute['textConfig'] };\n\nexport type IComposedTextMarkSpec = ITextMarkSpec | IRichTextMarkSpec;\n\nexport type IPositionedTextMarkSpec = Omit<ITextMarkSpec, 'align' | 'textAlign' | 'baseline' | 'textBaseline'>;\n\nexport interface IRectMarkSpec extends IFillMarkSpec {\n  /**\n   * 圆角配置。\n   * 1. 如果传入数值，则统一为四个角设置圆角\n   * 2. 如果传入数组，则分别为 [上左, 上右, 下右, 下左]\n   */\n  cornerRadius?: number | number[];\n  /**\n   * 宽度\n   */\n  width?: number;\n  /**\n   * 高度\n   */\n  height?: number;\n  /**\n   * x方向终点坐标\n   */\n  x1?: number;\n  /**\n   * y方向终点坐标\n   */\n\n  y1?: number;\n}\n\n// 3d rect，支持length表示长宽高中的长属性（深度属性）\nexport interface IRect3dMarkSpec extends IRectMarkSpec {\n  /**\n   * 3d柱子的深度\n   */\n  length?: number;\n}\n\nexport interface IBoxPlotMarkSpec extends ICommonSpec {\n  /**\n   * box描边宽度\n   */\n  lineWidth?: number;\n  /**\n   * box宽度\n   */\n  boxWidth?: number;\n  /**\n   * 最大最小值宽度\n   */\n  shaftWidth?: number;\n  /**\n   * 中轴线类型\n   */\n  shaftShape?: BoxPlotShaftShape;\n  /**\n   * 盒子填充颜色，为空则不填充\n   */\n  boxFill?: string;\n  // /**\n  //  * 描边颜色\n  //  */\n  // stroke?: string;\n  /**\n   * 中轴线透明度，仅当shaftType=bar时生效\n   */\n  shaftFillOpacity?: number;\n  /**\n   * 最小值\n   */\n  min?: (datum: Datum) => number;\n  /**\n   * 25%分位数\n   */\n  q1?: (datum: Datum) => number;\n  /**\n   * 中位数\n   */\n  median?: (datum: Datum) => number;\n  /**\n   * 75%分位数\n   */\n  q3?: (datum: Datum) => number;\n  /**\n   * 最大值\n   */\n  max?: (datum: Datum) => number;\n}\n\nexport interface IRippleMarkSpec extends ICommonSpec {\n  /**\n   * 波纹密度ripple\n   * ripple 取值范为[0,1]\n   */\n  ripple?: number;\n  /**\n   * 水波纹最大半径\n   */\n  size?: number;\n}\n\nexport interface ILiquidMarkSpec extends ICommonSpec {\n  /**\n   * 波浪的变化状态，范围为 [0, 1]\n   */\n  wave?: number;\n}\n\nexport interface ILiquidOutlineSpec extends ISymbolMarkSpec {\n  /**\n   * 描边的宽度\n   */\n  lineWidth: number;\n}\n\nexport interface IOutlierMarkSpec {\n  /**\n   * 异常点填充颜色\n   */\n  fill?: string;\n  /**\n   * 异常点大小\n   */\n  size?: number;\n}\n\nexport interface IPathMarkSpec extends IFillMarkSpec {\n  path?: string;\n  // TODO: 该属性后续可能会删除，未定\n  /**\n   * 平滑缩放，不然会发生跳变，在地图交互场景需要配置为true；常规path缩放不需要\n   */\n  smoothScale?: boolean;\n}\n\nexport interface ILinkPathMarkSpec extends IFillMarkSpec {\n  /**\n   * 连边起点的x坐标\n   */\n  x0?: number;\n  /**\n   * 连边起点的y坐标\n   */\n  y0?: number;\n  /**\n   * 连边终点的x坐标\n   */\n  x1?: number;\n  /**\n   * 连边终点的y坐标\n   */\n  y1?: number;\n  /**\n   * 连边的厚度，也可以理解为宽度\n   */\n  thickness?: number;\n  /**\n   * 连边的曲度，决定了连边的弯曲程度，取值范围为0-1，\n   * 0表示不弯曲，也就是直线\n   * 1表示最大的弯曲度，\n   * 默认值为0.5\n   */\n  curvature?: number;\n  /** round all the coordinates */\n  round?: boolean;\n  /** the ratio of normal style path */\n  ratio?: number;\n  /**\n   * 对齐方式\n   */\n  align?: 'start' | 'end' | 'center';\n  /**\n   * 连边的类型\n   *\n   */\n  pathType?: 'line' | 'smooth' | 'polyline';\n  /**\n   * 是否展示终点的箭头\n   */\n  endArrow?: boolean;\n  /**\n   * 是否展示起点的箭头\n   */\n  startArrow?: boolean;\n  /**\n   * 背景线的样式，主要用于部分高亮的场景\n   */\n  backgroundStyle?: any;\n  /**\n   * 连边的方向\n   */\n  direction?: 'horizontal' | 'vertical' | 'LR' | 'RL' | 'TB' | 'BL' | 'radial';\n}\n\n/**\n * arc图元的视觉通道配置\n */\nexport interface IArcMarkSpec extends IFillMarkSpec {\n  /**\n   * 圆弧的开始角度\n   */\n  startAngle?: number;\n  /**\n   * 圆弧的结束角度\n   */\n  endAngle?: number;\n  /**\n   * 间隙角度；间隔角度会转换为一个在两个相邻的弧之间的确定的线性距离，定义为 padRadius * | padAngle |\n   * 这个距离在弧的开始和结束处都是相等的；\n   * 间隔角度通常只应用于环形扇区（即当内半径大于 0）\n   */\n  padAngle?: number;\n\n  /**\n   * 外径，既外半径\n   */\n  outerRadius?: number;\n  /**\n   * 内径，既内半径\n   */\n  innerRadius?: number;\n  /**\n   * 圆角\n   */\n  cornerRadius?: number;\n  /**\n   * 内边距\n   */\n  innerPadding?: number;\n  /**\n   * 外边距\n   */\n  outerPadding?: number;\n  /**\n   * arc的中心点偏移距离，一般是通过在交互状态下设置这个属性来实现将扇区移出中心的一个效果\n   */\n  centerOffset?: number;\n  /**\n   * arc 的 roundCap 属性，即圆角是否伸出 startAngle 和 endAngle 之外\n   */\n  cap?: boolean | [boolean, boolean];\n  /**\n   * arc 在 roundCap 打开且应用环形渐变时是否对 cap 部分生效\n   */\n  autoCapConical?: boolean;\n}\n\n// 3d arc，有高度配置\nexport interface IArc3dMarkSpec extends IArcMarkSpec {\n  /**\n   * 3d圆弧的高度\n   */\n  height?: number;\n}\n\nexport interface ICellMarkSpec extends ISymbolMarkSpec {\n  /**\n   * 内边距\n   */\n  padding?: number | number[] | IPadding;\n}\n\nexport interface IGroupMarkSpec extends IFillMarkSpec {\n  /**\n   * 是否开启裁剪\n   */\n  clip?: boolean;\n  /**\n   * 宽度\n   */\n  width?: number;\n  /**\n   * 高度\n   */\n  height?: number;\n  /**\n   * 圆角配置。\n   * 1. 如果传入数值，则统一为四个角设置圆角\n   * 2. 如果传入数组，则分别为 [上左, 上右, 下右, 下左]\n   */\n  cornerRadius?: number | number[];\n}\n\nexport interface IPolygonMarkSpec extends ICommonSpec, IFillMarkSpec {\n  /**\n   * 顶点坐标\n   */\n  points?: IPoint[];\n  /**\n   * 圆角配置，支持数组配置，数组的顺序同组成 polygon 的顺序对应\n   */\n  cornerRadius?: number | number[];\n  /**\n   * x方向的缩放比例，默认为1，即不进行缩放\n   */\n  scaleX?: number;\n  /**\n   * y方向的缩放比例，默认为1，即不进行缩放\n   */\n  scaleY?: number;\n}\n\nexport interface IPyramid3dMarkSpec extends IPolygonMarkSpec {\n  /**\n   * 3d金字塔顶点坐标，注意只能有4个顶点\n   */\n  points?: IPoint[];\n}\n\n/**\n * ImageFill\n */\nexport type RepeatType = 'no-repeat' | 'repeat-x' | 'repeat-y' | 'repeat';\nexport type RepeatXYType = 'no-repeat' | 'repeat' | 'stretch';\nexport type ImageOriginType = 'top' | 'bottom';\n\n/**\n *  gradient\n */\nexport type GradientPropValue<T> = ValueType<T> | FunctionType<T>;\nexport type GradientStop = {\n  /**\n   * 渐变色的偏移量，0-1的值\n   */\n  offset: GradientPropValue<number>;\n  /**\n   * 渐变色的颜色\n   */\n  color?: GradientPropValue<string>;\n  /**\n   * 渐变色的透明度\n   */\n  opacity?: number;\n};\nexport interface IGradientLinear {\n  /**\n   * 渐变色的起点x坐标，0-1的值，相对于图形包围盒x方向取值的比例值\n   */\n  x0?: GradientPropValue<number>;\n  /**\n   * 渐变色的起点y坐标，0-1的值，相对于图形包围盒y方向取值的比例值\n   */\n  y0?: GradientPropValue<number>;\n  /**\n   * 渐变色的终点x坐标，0-1的值，相对于图形包围盒x方向取值的比例值\n   */\n  x1?: GradientPropValue<number>;\n  /**\n   * 渐变色的终点y坐标，0-1的值，相对于图形包围盒y方向取值的比例值\n   */\n  y1?: GradientPropValue<number>;\n  /**\n   * 渐变色的颜色\n   */\n  stops: GradientStop[];\n  /**\n   * 渐变色的类型设置为 'linear'，即线形渐变\n   */\n  gradient: 'linear';\n}\n\nexport interface IGradientRadial {\n  /**\n   * 径向渐变的起点的半径\n   */\n  r0?: GradientPropValue<number>;\n  /**\n   * 径向渐变的起点的x坐标\n   */\n  x0?: GradientPropValue<number>;\n  /**\n   * 径向渐变的起点的y坐标\n   */\n  y0?: GradientPropValue<number>;\n  /**\n   * 径向渐变的终点的x坐标\n   */\n  x1?: GradientPropValue<number>;\n  /**\n   * 径向渐变的终点的y坐标\n   */\n  y1?: GradientPropValue<number>;\n  /**\n   * 径向渐变的终点的半径\n   */\n  r1?: GradientPropValue<number>;\n  /**\n   * 渐变色的颜色\n   */\n  stops: GradientStop[];\n  /**\n   * 渐变色的类型设置为 'radial'，即径向渐变\n   */\n  gradient: 'radial';\n}\n\nexport interface IGradientConical {\n  /**\n   * 锥形渐变的中心点x坐标\n   */\n  x?: GradientPropValue<number>;\n  /**\n   * 锥形渐变的中心点y坐标\n   */\n  y?: GradientPropValue<number>;\n  /**\n   * 锥形渐变的开始角度\n   */\n  startAngle?: GradientPropValue<number>;\n  /**\n   * 锥形渐变的结束角度\n   */\n  endAngle?: GradientPropValue<number>;\n  /**\n   * 锥形渐变的颜色\n   */\n  stops: GradientStop[];\n  /**\n   * 渐变色的类型设置为 'conical'，即锥形渐变\n   */\n  gradient: 'conical';\n}\n\nexport type GradientType = 'linear' | 'radial' | 'conical';\nexport type IGradient = IGradientLinear | IGradientRadial | IGradientConical;\n\nexport type LineStrokeCap = 'butt' | 'round' | 'square';\nexport type LineStrokeJoin = 'arcs' | 'bevel' | 'miter' | 'miter-clip' | 'round';\n\nexport type BoxPlotShaftShape = 'line' | 'bar';\n/**\n *  threshold\n */\nexport interface IThresholdStyle extends IVisualSpecStyle<number, string> {\n  domain: number[];\n  field: string;\n  range: string[];\n  type: 'threshold';\n}\n\n// FIXME: For some tool methods that need to use common configuration types\nexport interface IUnknownMarkSpec extends ICommonSpec {\n  [key: string]: unknown;\n}\n\nexport interface IImageMarkSpec extends IFillMarkSpec {\n  /**\n   * 圆角配置。\n   * 1. 如果传入数值，则统一为四个角设置圆角\n   * 2. 如果传入数组，则分别为 [上左, 上右, 下右, 下左]\n   */\n  cornerRadius?: number | number[];\n  /**\n   * 图片的宽度\n   */\n  width?: number;\n  /**\n   * 图片的高度\n   */\n  height?: number;\n  /**\n   * 当图片的宽度小于 width 时，图片的重复方式\n   */\n  repeatX?: IRepeatType;\n  /**\n   * 当图片的高度小于 height 时，图片的重复方式\n   */\n  repeatY?: IRepeatType;\n  /**\n   * 设置图片的内容，支持三种类型：\n   * 1. string类型，可以是图片资源的路径或者是svg 标签字符串\n   * 2. image 元素\n   * 3. canvas 元素\n   */\n  image: string | HTMLImageElement | HTMLCanvasElement;\n}\n\n/**\n * text\n */\nexport type TextAlign = TextAlignType;\nexport type TextBaseLine = TextBaselineType;\nexport type FontStyle = 'normal' | 'italic' | 'oblique' | string;\nexport type FontWeight = 'normal' | 'bold' | 'lighter' | 'bolder' | 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;\n"]}
+{"version":3,"sources":["../src/typings/visual.ts"],"names":[],"mappings":"","file":"visual.js","sourcesContent":["import type { PopTipAttributes } from '@visactor/vrender-components';\nimport type { DataView } from '@visactor/vdataset';\nimport type { Cursor } from './cursor';\nimport type { InterpolateType } from './interpolate';\nimport type { ScaleType } from './scale';\nimport type { ShapeType } from './shape';\nimport type { IPoint } from './coordinate';\nimport type { IModelMarkAttributeContext } from '../compile/mark/interface';\nimport type { Datum } from './common';\nimport type { IPadding } from '@visactor/vutils';\nimport type { IColorKey } from '../theme/color-scheme/interface';\nimport type { ITokenKey } from '../theme/token/interface';\nimport type {\n  IRepeatType,\n  TextAlignType,\n  TextBaselineType,\n  IRichTextAttribute,\n  IGraphicStyle,\n  IColor\n} from '@visactor/vrender-core';\n\n// 基础的visual 对应 scale 的属性\nexport interface IVisualSpecBase<D, T> {\n  /**\n   * type of scale\n   */\n  type: ScaleType;\n  /**\n   * will set to scale.domain, it means input of scale\n   */\n  domain: D[];\n  /**\n   * will set to scale.range, it means output of scale\n   */\n  range: T[];\n  /**\n   * will set to scale.specified if scale support, as a key-value pair matching capability\n   * @since 1.1.0\n   */\n  specified?: { [key: string]: unknown };\n  /**\n   * enable clamp in linear scale\n   * If clamp is enabled, the return value of the scale is always within the scale’s range.\n   * @since 1.13.6\n   * @default false\n   */\n  clamp?: boolean;\n}\n// 用来给用户进行mark.style上的映射配置。所以要配置数据维度\nexport interface IVisualSpecStyle<D, T> extends IVisualSpecBase<D, T> {\n  /**\n   * 指定映射对应的数据字段\n   */\n  field?: string;\n}\n\nexport type IDataDomainSpec = {\n  /**\n   * 数据的id\n   */\n  dataId: string;\n  /**\n   * 数据字段\n   */\n  fields: string[];\n};\n\n// 用来提供给用户进行 scale 配置 所以名字是必选的 对用户配置\nexport interface IVisualSpecScale<D, T> extends Omit<IVisualSpecBase<D, T>, 'domain'> {\n  /**\n   * scale 的id\n   */\n  id: string;\n  /**\n   * 定义域范围\n   */\n  domain:\n    | IVisualSpecBase<D, T>['domain']\n    // 使用数据的字段值，如果 scale 是连续的，就取区间，如果是离散的就使用 values 。\n    // 不考虑图表内的交互等数据筛选，这里只用原始数据的统计信息\n    | IDataDomainSpec[];\n}\n// 对用户配置\nexport type IVisual<D = any, R = any> = IVisualSpecStyle<D, R> | IVisualScale;\n\nexport interface IVisualScale {\n  /**\n   * 对应 IVisualSpecScale 的用户配置 scale-id\n   */\n  scale: string;\n  /**\n   * 指定参与映射的数据字段\n   */\n  field?: string;\n  /**\n   * 当用户指定 field 后，用该属性来控制值域。\n   * @default 'none'\n   */\n  changeDomain?: 'none' | 'replace' | 'expand';\n}\n\nexport type FunctionType<T> = (datum: Datum, context: IModelMarkAttributeContext, source?: DataView) => T;\nexport type ValueType<T> = T;\nexport type VisualType<T> = ValueType<T> | FunctionType<T> | IVisual<unknown, T>;\n\nexport type TextureType =\n  | 'circle'\n  | 'dimond'\n  | 'rect'\n  | 'vertical-line'\n  | 'horizontal-line'\n  | 'bias-lr'\n  | 'bias-rl'\n  | 'grid';\n\n/**\n * style格式转换\n */\nexport type ConvertToMarkStyleSpec<T extends Record<string, any>> = {\n  [key in keyof T]: VisualType<T[key]>;\n};\n\n/**\n * border\n */\nexport interface IBorder {\n  /**\n   * 边框离图形边缘的距离\n   */\n  distance: number | string;\n  /**\n   * 边框的颜色\n   */\n  stroke?: string | IGradient;\n  /**\n   * 边框的透明度\n   */\n  strokeOpacity?: number;\n  /**\n   * 边框线的宽度\n   */\n  lineWidth?: number;\n  /**\n   * 给边框配置虚线模式。它使用一组值来指定描述模式的线和间隙的交替长度\n   */\n  lineDash?: number[];\n  /**\n   * 设置边框的虚线偏移量\n   */\n  lineDashOffset?: number;\n}\n\nexport interface ICommonSpec {\n  /**\n   * 图形是否可见\n   */\n  visible?: boolean;\n  /**\n   * 图形的x坐标\n   */\n  x?: number;\n  /**\n   * 图形的y坐标\n   */\n  y?: number;\n  /**\n   * 图形的z坐标，仅适用于3D图表\n   */\n  z?: number;\n  /**\n   * 图形的描边颜色。\n   * 支持使用 'rgb(255,255,255)'，'rgba(255,255,255,1)'，'#fff' 等方式设置为纯色，也支持设置为渐变色描边\n   * @todo 隔离主题和 spec 配置\n   * IColorKey 类型只适用于主题\n   */\n  stroke?: string | IGradient | false | (number | boolean)[] | IColorKey;\n  /**\n   * 描边透明度\n   */\n  strokeOpacity?: number;\n  /**\n   * 图形的透明度，既影响描边也影响填充\n   */\n  opacity?: number;\n  /**\n   * 图形的描边宽度\n   */\n  lineWidth?: number;\n  /**\n   * 给描边配置虚线模式。它使用一组值来指定描述模式的线和间隙的交替长度\n   */\n  lineDash?: number[];\n  /**\n   * 设置虚线偏移量的属性\n   */\n  lineDashOffset?: number;\n  /**\n   * 设置图形的鼠标样式\n   */\n  cursor?: Cursor;\n  /**\n   * 设置图形的层级，主意这个是相对层级，图形引擎绘制的时候，会对相同group下的所有图形根据zIndex进行排序，然后从小到大进行渲染\n   */\n  zIndex?: number;\n  /**\n   * 图形的旋转角度\n   */\n  angle?: number;\n  /**\n   * 基于AABB的锚点位置，用于简单的定位某些path的位置\n   */\n  anchor?: [number, number];\n\n  /**\n   * x方向的缩放比例，默认为1，即不进行缩放\n   */\n  scaleX?: number;\n  /**\n   * y方向的缩放比例，默认为1，即不进行缩放\n   */\n  scaleY?: number;\n  /**\n   * 图形缩放中心\n   * @since 1.4.0\n   * 可以配置固定坐标，例如 [100, 100]；或者百分比坐标，例如 ['50%', '50%']，代表以图元中心为缩放中心\n   * */\n  scaleCenter?: [number | string, number | string];\n\n  // 3d旋转的属性\n  /**\n   * x方向的旋转角度\n   */\n  alpha?: number;\n  /**\n   * y方向的旋转角度\n   */\n  beta?: number;\n  /**\n   * 3d的锚点位置\n   */\n  anchor3d?: [number, number];\n\n  /**\n   * 选择模式，精确模式，粗糙模式（包围盒模式），自定义模式\n   */\n  pickMode?: 'accurate' | 'imprecise' | 'custom';\n  /**\n   * bounds的计算模式\n   */\n  boundsMode?: 'accurate' | 'imprecise';\n\n  /**\n   * 用于扩展描边的拾取范围，为 0 就是默认线宽，正数就加宽，负数就减宽\n   * @default 0\n   * @since 1.7.3\n   */\n  pickStrokeBuffer?: number;\n\n  // 以下是纹理相关的属性\n  /**\n   * 纹理的类型\n   */\n  texture?: TextureType | string;\n  /**\n   * 纹理的颜色\n   */\n  textureColor?: string;\n  /**\n   * 纹理单元的大小\n   */\n  textureSize?: number; // 纹理大小\n  /**\n   * 纹理之间空隙的大小\n   */\n  texturePadding?: number;\n\n  /**\n   * 外边框，外描边，描边位于图形外侧\n   */\n  outerBorder?: IBorder;\n  /**\n   * 内边框，内描边，描边位于图形内侧\n   */\n  innerBorder?: IBorder;\n  /**\n   * html 浮层，会将配置的html相关内容，绝对定位到图元的位置\n   * @experimental\n   * @since 1.10.0\n   */\n  html?: IMarkHtmlSpec;\n\n  [key: string]: any;\n}\n\nexport interface IFillMarkSpec extends ICommonSpec {\n  /**\n   * 图形的填充颜色\n   * @todo 隔离主题和 spec 配置\n   * IColorKey 类型只适用于主题\n   */\n  fill?: VisualType<string> | IGradient | false | IColorKey;\n  /**\n   * 填充的透明度\n   */\n  fillOpacity?: number;\n\n  /**\n   * 图形的背景色，支持纯色、image元素、canvas元素\n   */\n  background?: IColor | HTMLImageElement | HTMLCanvasElement | null;\n}\n\nexport type IMarkHtmlSpec = Partial<IGraphicStyle['html']>;\n\nexport interface ISymbolMarkSpec extends IFillMarkSpec {\n  /**\n   * x方向的偏移量\n   */\n  dx?: number;\n  /**\n   * y方向的偏移量\n   */\n  dy?: number;\n  /**\n   * 大小，相当于外接圆的半径\n   */\n  size?: number | number[];\n  /** 对外声明使用shape，vrender图形属性对应的是shape */\n  shape?: ShapeType | string;\n  /**\n   * 标记的类型\n   * FIXME:  vrender Symbol接收的图形属性，暂时都申明一下\n   * */\n  symbolType?: ShapeType | string;\n  /**\n   * x方向的缩放比例，默认为1，即不进行缩放\n   */\n  scaleX?: number;\n  /**\n   * y方向的缩放比例，默认为1，即不进行缩放\n   */\n  scaleY?: number;\n}\n\n// lineMark 和 areaMark 共同配置\nexport interface ILineLikeMarkSpec extends IFillMarkSpec {\n  /**\n   * 取消的差值类型，默认为线性插值，也就是普通的折线\n   */\n  curveType?: InterpolateType;\n  /**\n   * 设置点是否有效，也就是是否合法\n   */\n  defined?: boolean;\n}\n\nexport interface IAreaMarkSpec extends ILineLikeMarkSpec {\n  /**\n   * 面积的x1值\n   */\n  x1?: number;\n  /**\n   * 面积的y1值\n   */\n  y1?: number;\n  /**\n   * 面积图元的方向，\n   * horizontal - 水平方向\n   * vertical - 垂直方向\n   */\n  orient?: 'horizontal' | 'vertical';\n}\n\nexport interface ILineMarkSpec extends ILineLikeMarkSpec {\n  /**\n   * 指定如何绘制每一条线段末端的属性。有 3 个可能的值，分别是：'butt', 'round' and 'square'。默认值是 butt。\n   */\n  lineCap?: LineStrokeCap;\n  /**\n   * 用来设置 2 个长度不为 0 的相连部分（线段、圆弧、曲线）如何连接在一起的属性（长度为 0 的变形部分，其指定的末端和控制点在同一位置，会被忽略）。此属性有 3 个值： 'round', 'bevel' and 'miter'。默认值是 'miter'\n   */\n  lineJoin?: LineStrokeJoin;\n  /**\n   * 设置斜接面限制比例的属性。当获取属性值时，会返回当前的值（默认值是 10.0 ）。当给属性赋值时，0、负数、 Infinity 和 NaN 都会被忽略；除此之外都会被赋予一个新值。\n   */\n  miterLimit?: number;\n  /**\n   * stroke 的有界缓冲区\n   */\n  strokeBoundsBuffer?: number;\n}\n\nexport interface IRuleMarkSpec extends ILineMarkSpec {\n  /**\n   * 终点x坐标\n   */\n  x1?: number;\n  /**\n   * 终点y坐标\n   */\n  y1?: number;\n}\n\nexport interface ITextMarkSpec extends IFillMarkSpec {\n  /**\n   * 文字内容\n   */\n  text?: string | number | string[] | number[];\n  /**\n   * x 方向偏移\n   */\n  dx?: number;\n  /**\n   * y 方向偏移\n   */\n  dy?: number;\n  /**\n   * 字号\n   */\n  fontSize?: number | ITokenKey;\n  /**\n   * 文字水平方向的对齐方式\n   */\n  textAlign?: TextAlign;\n  /**\n   * 文字竖直方向的对齐方式\n   */\n  textBaseline?: TextBaseLine;\n  /**\n   * 字体\n   */\n  fontFamily?: string;\n  /**\n   * 字重\n   */\n  fontWeight?: FontWeight;\n  /**\n   * 字体样式，是否为斜体等\n   */\n  fontStyle?: FontStyle;\n  /**\n   * 文字的最大长度\n   */\n  maxLineWidth?: number;\n  /**\n   * 文字超出 maxLineWidth 后的省略符\n   */\n  ellipsis?: string;\n  /**\n   * 文本省略的位置，默认尾部省略\n   * 1. 'start' 文字首部省略\n   * 2. 'middle' 文本中间省略\n   * 3. 'end' 文本尾部省略\n   * @default 'end'\n   * @since 1.7.3\n   */\n  suffixPosition?: 'start' | 'end' | 'middle';\n  /**\n   * 下划线\n   */\n  underline?: boolean;\n  /**\n   * 下划线的虚线样式\n   */\n  underlineDash?: number[];\n  /**\n   * 下划线的虚线偏移量\n   */\n  underlineOffset?: number;\n  /**\n   * 中划线\n   */\n  lineThrough?: boolean;\n  /**\n   * 行高（1.3.1 版本新增字符串类型表示比例值，如\"150%\"）\n   * @since 1.3.1\n   */\n  lineHeight?: number | string | ITokenKey;\n  /**\n   * poptip 相关配置\n   */\n  poptip?: PopTipAttributes;\n  /**\n   * 文本的排布方向，如果需要文本纵向排布，可以配置为 'vertical'\n   * @default 'horizontal'\n   */\n  direction?: 'horizontal' | 'vertical';\n  /*\n   * 单词断行\n   */\n  wordBreak?: 'break-word' | 'break-all' | 'keep-all';\n  /**\n   * 高度限制控制显示内容及省略号\n   */\n  heightLimit?: number;\n  /**\n   * 按照行数限制显示内容及省略号\n   */\n  lineClamp?: number;\n  /**\n   * 设置如何处理空白字符\n   */\n  whiteSpace?: 'normal' | 'no-wrap';\n}\n\nexport type IRichTextMarkSpec = IRichTextAttribute &\n  IFillMarkSpec & { type: 'rich'; text: IRichTextAttribute['textConfig'] };\n\nexport type IComposedTextMarkSpec = ITextMarkSpec | IRichTextMarkSpec;\n\nexport type IPositionedTextMarkSpec = Omit<ITextMarkSpec, 'align' | 'textAlign' | 'baseline' | 'textBaseline'>;\n\nexport interface IRectMarkSpec extends IFillMarkSpec {\n  /**\n   * 圆角配置。\n   * 1. 如果传入数值，则统一为四个角设置圆角\n   * 2. 如果传入数组，则分别为 [上左, 上右, 下右, 下左]\n   */\n  cornerRadius?: number | number[];\n  /**\n   * 宽度\n   */\n  width?: number;\n  /**\n   * 高度\n   */\n  height?: number;\n  /**\n   * x方向终点坐标\n   */\n  x1?: number;\n  /**\n   * y方向终点坐标\n   */\n\n  y1?: number;\n}\n\n// 3d rect，支持length表示长宽高中的长属性（深度属性）\nexport interface IRect3dMarkSpec extends IRectMarkSpec {\n  /**\n   * 3d柱子的深度\n   */\n  length?: number;\n}\n\nexport interface IBoxPlotMarkSpec extends ICommonSpec {\n  /**\n   * box描边宽度\n   */\n  lineWidth?: number;\n  /**\n   * box宽度\n   */\n  boxWidth?: number;\n  /**\n   * 最大最小值宽度\n   */\n  shaftWidth?: number;\n  /**\n   * 中轴线类型\n   */\n  shaftShape?: BoxPlotShaftShape;\n  /**\n   * 盒子填充颜色，为空则不填充\n   */\n  boxFill?: string;\n  // /**\n  //  * 描边颜色\n  //  */\n  // stroke?: string;\n  /**\n   * 中轴线透明度，仅当shaftType=bar时生效\n   */\n  shaftFillOpacity?: number;\n  /**\n   * 最小值\n   */\n  min?: (datum: Datum) => number;\n  /**\n   * 25%分位数\n   */\n  q1?: (datum: Datum) => number;\n  /**\n   * 中位数\n   */\n  median?: (datum: Datum) => number;\n  /**\n   * 75%分位数\n   */\n  q3?: (datum: Datum) => number;\n  /**\n   * 最大值\n   */\n  max?: (datum: Datum) => number;\n}\n\nexport interface IRippleMarkSpec extends ICommonSpec {\n  /**\n   * 波纹密度ripple\n   * ripple 取值范为[0,1]\n   */\n  ripple?: number;\n  /**\n   * 水波纹最大半径\n   */\n  size?: number;\n}\n\nexport interface ILiquidMarkSpec extends ICommonSpec {\n  /**\n   * 波浪的变化状态，范围为 [0, 1]\n   */\n  wave?: number;\n}\n\nexport interface ILiquidOutlineSpec extends ISymbolMarkSpec {\n  /**\n   * 描边的宽度\n   */\n  lineWidth: number;\n}\n\nexport interface IOutlierMarkSpec {\n  /**\n   * 异常点填充颜色\n   */\n  fill?: string;\n  /**\n   * 异常点大小\n   */\n  size?: number;\n}\n\nexport interface IPathMarkSpec extends IFillMarkSpec {\n  path?: string;\n  // TODO: 该属性后续可能会删除，未定\n  /**\n   * 平滑缩放，不然会发生跳变，在地图交互场景需要配置为true；常规path缩放不需要\n   */\n  smoothScale?: boolean;\n}\n\nexport interface ILinkPathMarkSpec extends IFillMarkSpec {\n  /**\n   * 连边起点的x坐标\n   */\n  x0?: number;\n  /**\n   * 连边起点的y坐标\n   */\n  y0?: number;\n  /**\n   * 连边终点的x坐标\n   */\n  x1?: number;\n  /**\n   * 连边终点的y坐标\n   */\n  y1?: number;\n  /**\n   * 连边的厚度，也可以理解为宽度\n   */\n  thickness?: number;\n  /**\n   * 连边的曲度，决定了连边的弯曲程度，取值范围为0-1，\n   * 0表示不弯曲，也就是直线\n   * 1表示最大的弯曲度，\n   * 默认值为0.5\n   */\n  curvature?: number;\n  /** round all the coordinates */\n  round?: boolean;\n  /** the ratio of normal style path */\n  ratio?: number;\n  /**\n   * 对齐方式\n   */\n  align?: 'start' | 'end' | 'center';\n  /**\n   * 连边的类型\n   *\n   */\n  pathType?: 'line' | 'smooth' | 'polyline';\n  /**\n   * 是否展示终点的箭头\n   */\n  endArrow?: boolean;\n  /**\n   * 是否展示起点的箭头\n   */\n  startArrow?: boolean;\n  /**\n   * 背景线的样式，主要用于部分高亮的场景\n   */\n  backgroundStyle?: any;\n  /**\n   * 连边的方向\n   */\n  direction?: 'horizontal' | 'vertical' | 'LR' | 'RL' | 'TB' | 'BL' | 'radial';\n}\n\n/**\n * arc图元的视觉通道配置\n */\nexport interface IArcMarkSpec extends IFillMarkSpec {\n  /**\n   * 圆弧的开始角度\n   */\n  startAngle?: number;\n  /**\n   * 圆弧的结束角度\n   */\n  endAngle?: number;\n  /**\n   * 间隙角度；间隔角度会转换为一个在两个相邻的弧之间的确定的线性距离，定义为 padRadius * | padAngle |\n   * 这个距离在弧的开始和结束处都是相等的；\n   * 间隔角度通常只应用于环形扇区（即当内半径大于 0）\n   */\n  padAngle?: number;\n\n  /**\n   * 外径，既外半径\n   */\n  outerRadius?: number;\n  /**\n   * 内径，既内半径\n   */\n  innerRadius?: number;\n  /**\n   * 圆角\n   */\n  cornerRadius?: number;\n  /**\n   * 内边距\n   */\n  innerPadding?: number;\n  /**\n   * 外边距\n   */\n  outerPadding?: number;\n  /**\n   * arc的中心点偏移距离，一般是通过在交互状态下设置这个属性来实现将扇区移出中心的一个效果\n   */\n  centerOffset?: number;\n  /**\n   * arc 的 roundCap 属性，即圆角是否伸出 startAngle 和 endAngle 之外\n   */\n  cap?: boolean | [boolean, boolean];\n  /**\n   * arc 在 roundCap 打开且应用环形渐变时是否对 cap 部分生效\n   */\n  autoCapConical?: boolean;\n}\n\n// 3d arc，有高度配置\nexport interface IArc3dMarkSpec extends IArcMarkSpec {\n  /**\n   * 3d圆弧的高度\n   */\n  height?: number;\n}\n\nexport interface ICellMarkSpec extends ISymbolMarkSpec {\n  /**\n   * 内边距\n   */\n  padding?: number | number[] | IPadding;\n}\n\nexport interface IGroupMarkSpec extends IFillMarkSpec {\n  /**\n   * 是否开启裁剪\n   */\n  clip?: boolean;\n  /**\n   * 宽度\n   */\n  width?: number;\n  /**\n   * 高度\n   */\n  height?: number;\n  /**\n   * 圆角配置。\n   * 1. 如果传入数值，则统一为四个角设置圆角\n   * 2. 如果传入数组，则分别为 [上左, 上右, 下右, 下左]\n   */\n  cornerRadius?: number | number[];\n}\n\nexport interface IPolygonMarkSpec extends ICommonSpec, IFillMarkSpec {\n  /**\n   * 顶点坐标\n   */\n  points?: IPoint[];\n  /**\n   * 圆角配置，支持数组配置，数组的顺序同组成 polygon 的顺序对应\n   */\n  cornerRadius?: number | number[];\n  /**\n   * x方向的缩放比例，默认为1，即不进行缩放\n   */\n  scaleX?: number;\n  /**\n   * y方向的缩放比例，默认为1，即不进行缩放\n   */\n  scaleY?: number;\n}\n\nexport interface IPyramid3dMarkSpec extends IPolygonMarkSpec {\n  /**\n   * 3d金字塔顶点坐标，注意只能有4个顶点\n   */\n  points?: IPoint[];\n}\n\n/**\n * ImageFill\n */\nexport type RepeatType = 'no-repeat' | 'repeat-x' | 'repeat-y' | 'repeat';\nexport type RepeatXYType = 'no-repeat' | 'repeat' | 'stretch';\nexport type ImageOriginType = 'top' | 'bottom';\n\n/**\n *  gradient\n */\nexport type GradientPropValue<T> = ValueType<T> | FunctionType<T>;\nexport type GradientStop = {\n  /**\n   * 渐变色的偏移量，0-1的值\n   */\n  offset: GradientPropValue<number>;\n  /**\n   * 渐变色的颜色\n   */\n  color?: GradientPropValue<string>;\n  /**\n   * 渐变色的透明度\n   */\n  opacity?: number;\n};\nexport interface IGradientLinear {\n  /**\n   * 渐变色的起点x坐标，0-1的值，相对于图形包围盒x方向取值的比例值\n   */\n  x0?: GradientPropValue<number>;\n  /**\n   * 渐变色的起点y坐标，0-1的值，相对于图形包围盒y方向取值的比例值\n   */\n  y0?: GradientPropValue<number>;\n  /**\n   * 渐变色的终点x坐标，0-1的值，相对于图形包围盒x方向取值的比例值\n   */\n  x1?: GradientPropValue<number>;\n  /**\n   * 渐变色的终点y坐标，0-1的值，相对于图形包围盒y方向取值的比例值\n   */\n  y1?: GradientPropValue<number>;\n  /**\n   * 渐变色的颜色\n   */\n  stops: GradientStop[];\n  /**\n   * 渐变色的类型设置为 'linear'，即线形渐变\n   */\n  gradient: 'linear';\n}\n\nexport interface IGradientRadial {\n  /**\n   * 径向渐变的起点的半径\n   */\n  r0?: GradientPropValue<number>;\n  /**\n   * 径向渐变的起点的x坐标\n   */\n  x0?: GradientPropValue<number>;\n  /**\n   * 径向渐变的起点的y坐标\n   */\n  y0?: GradientPropValue<number>;\n  /**\n   * 径向渐变的终点的x坐标\n   */\n  x1?: GradientPropValue<number>;\n  /**\n   * 径向渐变的终点的y坐标\n   */\n  y1?: GradientPropValue<number>;\n  /**\n   * 径向渐变的终点的半径\n   */\n  r1?: GradientPropValue<number>;\n  /**\n   * 渐变色的颜色\n   */\n  stops: GradientStop[];\n  /**\n   * 渐变色的类型设置为 'radial'，即径向渐变\n   */\n  gradient: 'radial';\n}\n\nexport interface IGradientConical {\n  /**\n   * 锥形渐变的中心点x坐标\n   */\n  x?: GradientPropValue<number>;\n  /**\n   * 锥形渐变的中心点y坐标\n   */\n  y?: GradientPropValue<number>;\n  /**\n   * 锥形渐变的开始角度\n   */\n  startAngle?: GradientPropValue<number>;\n  /**\n   * 锥形渐变的结束角度\n   */\n  endAngle?: GradientPropValue<number>;\n  /**\n   * 锥形渐变的颜色\n   */\n  stops: GradientStop[];\n  /**\n   * 渐变色的类型设置为 'conical'，即锥形渐变\n   */\n  gradient: 'conical';\n}\n\nexport type GradientType = 'linear' | 'radial' | 'conical';\nexport type IGradient = IGradientLinear | IGradientRadial | IGradientConical;\n\nexport type LineStrokeCap = 'butt' | 'round' | 'square';\nexport type LineStrokeJoin = 'arcs' | 'bevel' | 'miter' | 'miter-clip' | 'round';\n\nexport type BoxPlotShaftShape = 'line' | 'bar';\n/**\n *  threshold\n */\nexport interface IThresholdStyle extends IVisualSpecStyle<number, string> {\n  domain: number[];\n  field: string;\n  range: string[];\n  type: 'threshold';\n}\n\n// FIXME: For some tool methods that need to use common configuration types\nexport interface IUnknownMarkSpec extends ICommonSpec {\n  [key: string]: unknown;\n}\n\nexport interface IImageMarkSpec extends IFillMarkSpec {\n  /**\n   * 圆角配置。\n   * 1. 如果传入数值，则统一为四个角设置圆角\n   * 2. 如果传入数组，则分别为 [上左, 上右, 下右, 下左]\n   */\n  cornerRadius?: number | number[];\n  /**\n   * 图片的宽度\n   */\n  width?: number;\n  /**\n   * 图片的高度\n   */\n  height?: number;\n  /**\n   * 当图片的宽度小于 width 时，图片的重复方式\n   */\n  repeatX?: IRepeatType;\n  /**\n   * 当图片的高度小于 height 时，图片的重复方式\n   */\n  repeatY?: IRepeatType;\n  /**\n   * 设置图片的内容，支持三种类型：\n   * 1. string类型，可以是图片资源的路径或者是svg 标签字符串\n   * 2. image 元素\n   * 3. canvas 元素\n   */\n  image: string | HTMLImageElement | HTMLCanvasElement;\n}\n\n/**\n * text\n */\nexport type TextAlign = TextAlignType;\nexport type TextBaseLine = TextBaselineType;\nexport type FontStyle = 'normal' | 'italic' | 'oblique' | string;\nexport type FontWeight = 'normal' | 'bold' | 'lighter' | 'bolder' | 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;\n"]}

package/cjs/util/array.d.ts

@@ -1,4 +1,5 @@
 import { array, last as peek, maxInArray as maxInArr, minInArray as minInArr } from '@visactor/vutils';
 export declare function shallowCompare<T, U>(arrA: T | T[], arrB: U | U[]): boolean;
 export declare function combineDomains(domains: number[][]): number[];
+export declare function moveAfterInArray<T>(array: T[], target: T, ref: T): void;
 export { array, peek, maxInArr, minInArr };

package/cjs/util/array.js

@@ -2,7 +2,7 @@
 
 Object.defineProperty(exports, "__esModule", {
     value: !0
-}), exports.minInArr = exports.maxInArr = exports.peek = exports.array = exports.combineDomains = exports.shallowCompare = void 0;
+}), exports.minInArr = exports.maxInArr = exports.peek = exports.array = exports.moveAfterInArray = exports.combineDomains = exports.shallowCompare = void 0;
 
 const vutils_1 = require("@visactor/vutils");
 
@@ -23,6 +23,11 @@ function combineDomains(domains) {
     return result;
 }
 
+function moveAfterInArray(array, target, ref) {
+    const index = array.indexOf(target), refIndex = array.indexOf(ref);
+    index >= 0 && refIndex >= 0 && index < refIndex && (array.splice(index, 1), array.splice(refIndex, 0, target));
+}
+
 Object.defineProperty(exports, "array", {
     enumerable: !0,
     get: function() {
@@ -43,5 +48,6 @@ Object.defineProperty(exports, "array", {
     get: function() {
         return vutils_1.minInArray;
     }
-}), exports.shallowCompare = shallowCompare, exports.combineDomains = combineDomains;
+}), exports.shallowCompare = shallowCompare, exports.combineDomains = combineDomains, 
+exports.moveAfterInArray = moveAfterInArray;
 //# sourceMappingURL=array.js.map

package/cjs/util/array.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/util/array.ts"],"names":[],"mappings":";;;AAAA,6CAAuG;AA8B9F,sFA9BA,cAAK,OA8BA;AAAE,qFA9BQ,aAAI,OA8BR;AAAE,yFA9BsB,mBAAQ,OA8BtB;AAAE,yFA9BoC,mBAAQ,OA8BpC;AA5BxC,SAAgB,cAAc,CAAO,IAAa,EAAE,IAAa;IAC/D,MAAM,IAAI,GAAG,IAAI,GAAG,CAAQ,IAAA,cAAK,EAAC,IAAI,CAAC,CAAC,CAAC;IACzC,MAAM,IAAI,GAAG,IAAI,GAAG,CAAQ,IAAA,cAAK,EAAC,IAAI,CAAC,CAAC,CAAC;IACzC,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,EAAE;QAC3B,OAAO,KAAK,CAAC;KACd;IACD,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE;QAC7B,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;YAChB,OAAO,KAAK,CAAC;SACd;KACF;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAZD,wCAYC;AAED,SAAgB,cAAc,CAAC,OAAmB;IAChD,MAAM,MAAM,GAAG,EAAE,CAAC;IAClB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;QACnD,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;QAC9B,IAAI,KAAK,KAAK,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE;YAC1D,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;SACxB;QAED,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;KACxB;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAZD,wCAYC","file":"array.js","sourcesContent":["import { array, last as peek, maxInArray as maxInArr, minInArray as minInArr } from '@visactor/vutils';\n\nexport function shallowCompare<T, U>(arrA: T | T[], arrB: U | U[]): boolean {\n  const setA = new Set<T | U>(array(arrA));\n  const setB = new Set<T | U>(array(arrB));\n  if (setA.size !== setB.size) {\n    return false;\n  }\n  for (const v of setA.values()) {\n    if (!setB.has(v)) {\n      return false;\n    }\n  }\n  return true;\n}\n\nexport function combineDomains(domains: number[][]): number[] {\n  const result = [];\n  for (let index = 0; index < domains.length; index++) {\n    const domain = domains[index];\n    if (index === 0 || domain[0] !== result[result.length - 1]) {\n      result.push(domain[0]);\n    }\n\n    result.push(domain[1]);\n  }\n\n  return result;\n}\n\nexport { array, peek, maxInArr, minInArr };\n"]}
+{"version":3,"sources":["../src/util/array.ts"],"names":[],"mappings":";;;AAAA,6CAAuG;AAuC9F,sFAvCA,cAAK,OAuCA;AAAE,qFAvCQ,aAAI,OAuCR;AAAE,yFAvCsB,mBAAQ,OAuCtB;AAAE,yFAvCoC,mBAAQ,OAuCpC;AArCxC,SAAgB,cAAc,CAAO,IAAa,EAAE,IAAa;IAC/D,MAAM,IAAI,GAAG,IAAI,GAAG,CAAQ,IAAA,cAAK,EAAC,IAAI,CAAC,CAAC,CAAC;IACzC,MAAM,IAAI,GAAG,IAAI,GAAG,CAAQ,IAAA,cAAK,EAAC,IAAI,CAAC,CAAC,CAAC;IACzC,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,EAAE;QAC3B,OAAO,KAAK,CAAC;KACd;IACD,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE;QAC7B,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;YAChB,OAAO,KAAK,CAAC;SACd;KACF;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAZD,wCAYC;AAED,SAAgB,cAAc,CAAC,OAAmB;IAChD,MAAM,MAAM,GAAG,EAAE,CAAC;IAClB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;QACnD,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;QAC9B,IAAI,KAAK,KAAK,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE;YAC1D,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;SACxB;QAED,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;KACxB;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAZD,wCAYC;AACD,SAAgB,gBAAgB,CAAI,KAAU,EAAE,MAAS,EAAE,GAAM;IAC/D,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACpC,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAEpC,IAAI,KAAK,IAAI,CAAC,IAAI,QAAQ,IAAI,CAAC,IAAI,KAAK,GAAG,QAAQ,EAAE;QACnD,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QACvB,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;KACnC;AACH,CAAC;AARD,4CAQC","file":"array.js","sourcesContent":["import { array, last as peek, maxInArray as maxInArr, minInArray as minInArr } from '@visactor/vutils';\n\nexport function shallowCompare<T, U>(arrA: T | T[], arrB: U | U[]): boolean {\n  const setA = new Set<T | U>(array(arrA));\n  const setB = new Set<T | U>(array(arrB));\n  if (setA.size !== setB.size) {\n    return false;\n  }\n  for (const v of setA.values()) {\n    if (!setB.has(v)) {\n      return false;\n    }\n  }\n  return true;\n}\n\nexport function combineDomains(domains: number[][]): number[] {\n  const result = [];\n  for (let index = 0; index < domains.length; index++) {\n    const domain = domains[index];\n    if (index === 0 || domain[0] !== result[result.length - 1]) {\n      result.push(domain[0]);\n    }\n\n    result.push(domain[1]);\n  }\n\n  return result;\n}\nexport function moveAfterInArray<T>(array: T[], target: T, ref: T) {\n  const index = array.indexOf(target);\n  const refIndex = array.indexOf(ref);\n\n  if (index >= 0 && refIndex >= 0 && index < refIndex) {\n    array.splice(index, 1);\n    array.splice(refIndex, 0, target);\n  }\n}\n\nexport { array, peek, maxInArr, minInArr };\n"]}

package/cjs/util/debug.js

@@ -4,7 +4,7 @@ Object.defineProperty(exports, "__esModule", {
     value: !0
 }), exports.config = exports.error = exports.warn = exports.log = void 0;
 
-const vutils_1 = require("@visactor/vutils"), log = (msg, ...args) => exports.config.silent ? null : vutils_1.Logger.getInstance().info(msg, ...args);
+const vutils_1 = require("@visactor/vutils"), log = (msg, ...args) => exports.config.silent ? null : vutils_1.Logger.getInstance().info(`[VChart log]: ${msg}`, ...args);
 
 exports.log = log;
 

package/cjs/util/debug.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/util/debug.ts"],"names":[],"mappings":";;;AAAA,6CAAsD;AAE/C,MAAM,GAAG,GAAG,CAAC,GAAW,EAAE,GAAG,IAAW,EAAE,EAAE;IACjD,IAAI,CAAC,cAAM,CAAC,MAAM,EAAE;QAClB,OAAO,eAAM,CAAC,WAAW,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;KAChD;IACD,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AALW,QAAA,GAAG,OAKd;AAEK,MAAM,IAAI,GAAG,CAAC,GAAW,EAAE,MAAY,EAAE,EAAE;IAChD,IAAI,IAAA,mBAAU,EAAC,cAAM,CAAC,WAAW,CAAC,EAAE;QAClC,cAAM,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;KAC5C;IACD,IAAI,MAAM,EAAE;QACV,OAAO,eAAM,CAAC,WAAW,EAAE,CAAC,IAAI,CAAC,kBAAkB,GAAG,EAAE,EAAE,MAAM,CAAC,CAAC;KACnE;IACD,OAAO,eAAM,CAAC,WAAW,EAAE,CAAC,IAAI,CAAC,kBAAkB,GAAG,EAAE,CAAC,CAAC;AAC5D,CAAC,CAAC;AARW,QAAA,IAAI,QAQf;AAEK,MAAM,KAAK,GAAG,CAAC,GAAW,EAAE,MAAY,EAAE,GAAW,EAAE,EAAE;IAC9D,IAAI,cAAM,CAAC,MAAM,EAAE;QACjB,OAAO;KACR;IACD,IAAI,IAAA,mBAAU,EAAC,cAAM,CAAC,YAAY,CAAC,EAAE;QACnC,cAAM,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;QAC5C,OAAO;KACR;IACD,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC;AATW,QAAA,KAAK,SAShB;AAEW,QAAA,MAAM,GAAG;IACpB,MAAM,EAAE,KAAK;IACb,WAAW,EAAE,KAAK;IAClB,YAAY,EAAE,KAAK;CACE,CAAC","file":"debug.js","sourcesContent":["import { Logger, isFunction } from '@visactor/vutils';\n\nexport const log = (msg: string, ...args: any[]) => {\n  if (!config.silent) {\n    return Logger.getInstance().info(msg, ...args);\n  }\n  return null;\n};\n\nexport const warn = (msg: string, detail?: any) => {\n  if (isFunction(config.warnHandler)) {\n    config.warnHandler.call(null, msg, detail);\n  }\n  if (detail) {\n    return Logger.getInstance().warn(`[VChart warn]: ${msg}`, detail);\n  }\n  return Logger.getInstance().warn(`[VChart warn]: ${msg}`);\n};\n\nexport const error = (msg: string, detail?: any, err?: Error) => {\n  if (config.silent) {\n    return;\n  }\n  if (isFunction(config.errorHandler)) {\n    config.errorHandler.call(null, msg, detail);\n    return;\n  }\n  throw new Error(msg);\n};\n\nexport const config = {\n  silent: false,\n  warnHandler: false,\n  errorHandler: false\n} as unknown as IConfig;\n\nexport interface IConfig {\n  /**\n   * 是否开启控制台告警\n   */\n  silent: boolean;\n  /**\n   * 错误处理\n   */\n  errorHandler?: (msg: string, detail?: any) => void;\n  /**\n   * 警告处理\n   */\n  warnHandler?: (msg: string, detail?: any) => void;\n}\n"]}
+{"version":3,"sources":["../src/util/debug.ts"],"names":[],"mappings":";;;AAAA,6CAAsD;AAE/C,MAAM,GAAG,GAAG,CAAC,GAAW,EAAE,GAAG,IAAW,EAAE,EAAE;IACjD,IAAI,CAAC,cAAM,CAAC,MAAM,EAAE;QAClB,OAAO,eAAM,CAAC,WAAW,EAAE,CAAC,IAAI,CAAC,iBAAiB,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;KACnE;IACD,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AALW,QAAA,GAAG,OAKd;AAEK,MAAM,IAAI,GAAG,CAAC,GAAW,EAAE,MAAY,EAAE,EAAE;IAChD,IAAI,IAAA,mBAAU,EAAC,cAAM,CAAC,WAAW,CAAC,EAAE;QAClC,cAAM,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;KAC5C;IACD,IAAI,MAAM,EAAE;QACV,OAAO,eAAM,CAAC,WAAW,EAAE,CAAC,IAAI,CAAC,kBAAkB,GAAG,EAAE,EAAE,MAAM,CAAC,CAAC;KACnE;IACD,OAAO,eAAM,CAAC,WAAW,EAAE,CAAC,IAAI,CAAC,kBAAkB,GAAG,EAAE,CAAC,CAAC;AAC5D,CAAC,CAAC;AARW,QAAA,IAAI,QAQf;AAEK,MAAM,KAAK,GAAG,CAAC,GAAW,EAAE,MAAY,EAAE,GAAW,EAAE,EAAE;IAC9D,IAAI,cAAM,CAAC,MAAM,EAAE;QACjB,OAAO;KACR;IACD,IAAI,IAAA,mBAAU,EAAC,cAAM,CAAC,YAAY,CAAC,EAAE;QACnC,cAAM,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;QAC5C,OAAO;KACR;IACD,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC;AATW,QAAA,KAAK,SAShB;AAEW,QAAA,MAAM,GAAG;IACpB,MAAM,EAAE,KAAK;IACb,WAAW,EAAE,KAAK;IAClB,YAAY,EAAE,KAAK;CACE,CAAC","file":"debug.js","sourcesContent":["import { Logger, isFunction } from '@visactor/vutils';\n\nexport const log = (msg: string, ...args: any[]) => {\n  if (!config.silent) {\n    return Logger.getInstance().info(`[VChart log]: ${msg}`, ...args);\n  }\n  return null;\n};\n\nexport const warn = (msg: string, detail?: any) => {\n  if (isFunction(config.warnHandler)) {\n    config.warnHandler.call(null, msg, detail);\n  }\n  if (detail) {\n    return Logger.getInstance().warn(`[VChart warn]: ${msg}`, detail);\n  }\n  return Logger.getInstance().warn(`[VChart warn]: ${msg}`);\n};\n\nexport const error = (msg: string, detail?: any, err?: Error) => {\n  if (config.silent) {\n    return;\n  }\n  if (isFunction(config.errorHandler)) {\n    config.errorHandler.call(null, msg, detail);\n    return;\n  }\n  throw new Error(msg);\n};\n\nexport const config = {\n  silent: false,\n  warnHandler: false,\n  errorHandler: false\n} as unknown as IConfig;\n\nexport interface IConfig {\n  /**\n   * 是否开启控制台告警\n   */\n  silent: boolean;\n  /**\n   * 错误处理\n   */\n  errorHandler?: (msg: string, detail?: any) => void;\n  /**\n   * 警告处理\n   */\n  warnHandler?: (msg: string, detail?: any) => void;\n}\n"]}

package/cjs/util/index.d.ts

@@ -17,6 +17,7 @@ export * from './text';
 export * from './data';
 export * from './hierarchy';
 export * from './style';
+export * from './mark';
 export declare const Utils: {
     TimeUtil: typeof TimeUtil;
 };

package/cjs/util/index.js

@@ -44,7 +44,8 @@ __exportStar(require("./scale"), exports), __exportStar(require("./space"), expo
 __exportStar(require("./type"), exports), __exportStar(require("./theme"), exports), 
 __exportStar(require("./spec"), exports), __exportStar(require("./text"), exports), 
 __exportStar(require("./data"), exports), __exportStar(require("./hierarchy"), exports), 
-__exportStar(require("./style"), exports), exports.Utils = {
+__exportStar(require("./style"), exports), __exportStar(require("./mark"), exports), 
+exports.Utils = {
     TimeUtil: vutils_1.TimeUtil
 };
 //# sourceMappingURL=index.js.map

package/cjs/util/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/util/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,6CAAuE;AAE9D,yFAFA,iBAAQ,OAEA;AAAE,yFAFA,iBAAQ,OAEA;AAAE,sFAFA,cAAK,OAEA;AAElC,0CAAwB;AACxB,0CAAwB;AACxB,0CAAwB;AACxB,wCAAsB;AACtB,uCAAqB;AACrB,yCAAuB;AACvB,0CAAwB;AACxB,2CAAyB;AACzB,0CAAwB;AACxB,0CAAwB;AACxB,yCAAuB;AACvB,0CAAwB;AACxB,yCAAuB;AACvB,yCAAuB;AACvB,yCAAuB;AACvB,8CAA4B;AAC5B,0CAAwB;AAEX,QAAA,KAAK,GAAG,EAAE,QAAQ,EAAR,iBAAQ,EAAE,CAAC","file":"index.js","sourcesContent":["import { debounce, throttle, clamp, TimeUtil } from '@visactor/vutils';\n\nexport { debounce, throttle, clamp };\n\nexport * from './array';\nexport * from './color';\nexport * from './debug';\nexport * from './env';\nexport * from './id';\nexport * from './math';\nexport * from './model';\nexport * from './object';\nexport * from './scale';\nexport * from './space';\nexport * from './type';\nexport * from './theme';\nexport * from './spec';\nexport * from './text';\nexport * from './data';\nexport * from './hierarchy';\nexport * from './style';\n\nexport const Utils = { TimeUtil };\n"]}
+{"version":3,"sources":["../src/util/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,6CAAuE;AAE9D,yFAFA,iBAAQ,OAEA;AAAE,yFAFA,iBAAQ,OAEA;AAAE,sFAFA,cAAK,OAEA;AAElC,0CAAwB;AACxB,0CAAwB;AACxB,0CAAwB;AACxB,wCAAsB;AACtB,uCAAqB;AACrB,yCAAuB;AACvB,0CAAwB;AACxB,2CAAyB;AACzB,0CAAwB;AACxB,0CAAwB;AACxB,yCAAuB;AACvB,0CAAwB;AACxB,yCAAuB;AACvB,yCAAuB;AACvB,yCAAuB;AACvB,8CAA4B;AAC5B,0CAAwB;AACxB,yCAAuB;AAEV,QAAA,KAAK,GAAG,EAAE,QAAQ,EAAR,iBAAQ,EAAE,CAAC","file":"index.js","sourcesContent":["import { debounce, throttle, clamp, TimeUtil } from '@visactor/vutils';\n\nexport { debounce, throttle, clamp };\n\nexport * from './array';\nexport * from './color';\nexport * from './debug';\nexport * from './env';\nexport * from './id';\nexport * from './math';\nexport * from './model';\nexport * from './object';\nexport * from './scale';\nexport * from './space';\nexport * from './type';\nexport * from './theme';\nexport * from './spec';\nexport * from './text';\nexport * from './data';\nexport * from './hierarchy';\nexport * from './style';\nexport * from './mark';\n\nexport const Utils = { TimeUtil };\n"]}

package/cjs/util/mark.d.ts

@@ -0,0 +1,5 @@
+import type { IGraphic } from '@visactor/vrender-core';
+import type { IMarkGraphic } from '../mark/interface/common';
+export declare const isCollectionMark: (type: string) => boolean;
+export declare const getDatumOfGraphic: (g: IMarkGraphic) => import("../typings").Datum;
+export declare const findMarkGraphic: (rootGroup: IGraphic, target: IGraphic) => IGraphic<Partial<import("@visactor/vrender-core").IGraphicAttribute>>;

package/cjs/util/mark.js

@@ -0,0 +1,27 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+    value: !0
+}), exports.findMarkGraphic = exports.getDatumOfGraphic = exports.isCollectionMark = void 0;
+
+const isCollectionMark = type => "line" === type || "area" === type;
+
+exports.isCollectionMark = isCollectionMark;
+
+const getDatumOfGraphic = g => {
+    if (!g || !g.context) return null;
+    const {data: data, markType: markType} = g.context;
+    return (0, exports.isCollectionMark)(markType) ? data : null == data ? void 0 : data[0];
+};
+
+exports.getDatumOfGraphic = getDatumOfGraphic;
+
+const findMarkGraphic = (rootGroup, target) => {
+    let g = target;
+    for (;(null == g ? void 0 : g.parent) && g.parent !== rootGroup; ) if (g = g.parent, 
+    g.context) return g;
+    return null;
+};
+
+exports.findMarkGraphic = findMarkGraphic;
+//# sourceMappingURL=mark.js.map

package/cjs/util/mark.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/util/mark.ts"],"names":[],"mappings":";;;AAIO,MAAM,gBAAgB,GAAG,CAAC,IAAY,EAAE,EAAE;IAC/C,OAAO,IAAI,WAAsB,IAAI,IAAI,WAAsB,CAAC;AAClE,CAAC,CAAC;AAFW,QAAA,gBAAgB,oBAE3B;AAEK,MAAM,iBAAiB,GAAG,CAAC,CAAe,EAAE,EAAE;IACnD,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE;QACpB,OAAO,IAAI,CAAC;KACb;IAED,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC;IACrC,IAAI,IAAA,wBAAgB,EAAC,QAAQ,CAAC,EAAE;QAC9B,OAAO,IAAI,CAAC;KACb;IAED,OAAO,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAG,CAAC,CAAC,CAAC;AACnB,CAAC,CAAC;AAXW,QAAA,iBAAiB,qBAW5B;AAEK,MAAM,eAAe,GAAG,CAAC,SAAmB,EAAE,MAAgB,EAAE,EAAE;IACvE,IAAI,CAAC,GAAG,MAAM,CAAC;IAEf,OAAO,CAAA,CAAC,aAAD,CAAC,uBAAD,CAAC,CAAE,MAAM,KAAI,CAAC,CAAC,MAAM,KAAK,SAAS,EAAE;QAC1C,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC;QAEb,IAAK,CAAkB,CAAC,OAAO,EAAE;YAC/B,OAAO,CAAC,CAAC;SACV;KACF;IAED,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAZW,QAAA,eAAe,mBAY1B","file":"mark.js","sourcesContent":["import type { IGraphic } from '@visactor/vrender-core';\nimport { MarkTypeEnum } from '../mark/interface';\nimport type { IMarkGraphic } from '../mark/interface/common';\n\nexport const isCollectionMark = (type: string) => {\n  return type === MarkTypeEnum.line || type === MarkTypeEnum.area;\n};\n\nexport const getDatumOfGraphic = (g: IMarkGraphic) => {\n  if (!g || !g.context) {\n    return null;\n  }\n\n  const { data, markType } = g.context;\n  if (isCollectionMark(markType)) {\n    return data;\n  }\n\n  return data?.[0];\n};\n\nexport const findMarkGraphic = (rootGroup: IGraphic, target: IGraphic) => {\n  let g = target;\n\n  while (g?.parent && g.parent !== rootGroup) {\n    g = g.parent;\n\n    if ((g as IMarkGraphic).context) {\n      return g;\n    }\n  }\n\n  return null;\n};\n"]}

package/cjs/util/math.d.ts

@@ -23,5 +23,5 @@ export declare function radiusLabelOrientAttribute(angle: number): {
 };
 export declare function vectorAngle(v1: IPoint, v2: IPoint): number;
 export declare function distance(p1: IPoint, p2?: IPoint): number;
-export declare function getPercentValue(valueList: number[], precision?: number): number[] | 0;
+export declare function getPercentValue(valueList: number[], precision?: number): 0 | number[];
 export declare function isValidPoint(p: IPoint): boolean;