@visactor/vseed 0.4.25 → 0.4.27

package/dist/esm/pipeline/spec/chart/pipes/annotation/annotationDifferenceLine.js

@@ -1,5 +1,8 @@
+import { autoFormatter, createFormatter, findAllMeasures } from "../../../../utils/index.js";
+import { isDimensionSelector, isFieldSelector, isMeasureSelector, isPartialDatumSelector } from "../../../../../dataSelector/index.js";
+import { isEmpty } from "remeda";
 import { ANNOTATION_Z_INDEX } from "../../../../utils/constant.js";
-import { buildDifferenceCoordinateDatum, buildDifferenceText, inferDifferenceConnectDirection, isDifferenceLineStacked, resolveDifferenceAnchor } from "./annotationDifferenceLineCommon.js";
+import { buildDifferenceCoordinateDatum, buildDifferenceText, getDifferenceLineStackResolveMode, getRuntimeDifferenceValue, inferDifferenceBracketDirection, inferDifferenceConnectDirection, resolveDifferenceAnchor, usesDifferenceLineElementStackEnd } from "./annotationDifferenceLineCommon.js";
 const DEFAULT_LINE_COLOR = '#BCC1CB';
 const DEFAULT_TEXT_COLOR = '#ffffff';
 const DEFAULT_TEXT_BACKGROUND_COLOR = '#BCC1CB';
@@ -10,7 +13,63 @@ const DEFAULT_CORNER_RADIUS = 4;
 const DEFAULT_LABEL_PADDING = 4;
 const DEFAULT_END_SYMBOL_SIZE = 12;
 const DEFAULT_END_SYMBOL_REF_X = -4;
+const DEFAULT_BRACKET_EXPAND_DISTANCE = 80;
+const DEFAULT_BRACKET_LINE_DASH = [
+    2,
+    2
+];
+const DEFAULT_PERCENT_DIFFERENCE_FORMAT = {
+    type: 'percent',
+    fractionDigits: 2
+};
 const getDifferenceLinePath = (index, total)=>1 === total ? 'annotationDifferenceLine' : `annotationDifferenceLine[${index}]`;
+const toArray = (value)=>{
+    if (Array.isArray(value)) return value;
+    return null == value ? [] : [
+        value
+    ];
+};
+const getAxisFormatter = (spec)=>{
+    const valueAxisOrient = 'horizontal' === spec.direction ? 'bottom' : 'left';
+    const formatMethod = spec.axes?.find((axis)=>axis.orient === valueAxisOrient)?.label?.formatMethod;
+    return 'function' == typeof formatMethod ? (value)=>String(formatMethod(value) ?? value) : void 0;
+};
+const getExplicitMeasureFormat = (measure)=>{
+    if (measure?.numFormat && !isEmpty(measure.numFormat)) return measure.numFormat;
+    if (measure?.format && !isEmpty(measure.format)) return measure.format;
+};
+const inferMeasureIdFromDatum = (anchor, measureIds)=>{
+    const candidateValues = [
+        anchor.matchedDatum,
+        anchor.coordinateDatum
+    ];
+    for (const datum of candidateValues){
+        if (!datum) continue;
+        const candidates = measureIds.filter((measureId)=>Number(datum[measureId]) === anchor.value);
+        if (1 === candidates.length) return candidates[0];
+    }
+};
+const inferMeasureIdFromSelector = (selectorValue, measureIdSet)=>{
+    const matchedMeasureIds = new Set();
+    for (const currentSelector of toArray(selectorValue)){
+        if (isMeasureSelector(currentSelector)) {
+            if (measureIdSet.has(currentSelector.field)) matchedMeasureIds.add(currentSelector.field);
+            continue;
+        }
+        if (!(isFieldSelector(currentSelector) || isDimensionSelector(currentSelector))) {
+            if (isPartialDatumSelector(currentSelector)) Object.keys(currentSelector).forEach((field)=>{
+                if (measureIdSet.has(field)) matchedMeasureIds.add(field);
+            });
+        }
+    }
+    return 1 === matchedMeasureIds.size ? Array.from(matchedMeasureIds)[0] : void 0;
+};
+const resolveDifferenceMeasureId = (anchor, selectorValue, measureIds)=>{
+    if ('element' !== anchor.mode) return;
+    if (1 === measureIds.length) return measureIds[0];
+    const measureIdSet = new Set(measureIds);
+    return inferMeasureIdFromSelector(selectorValue, measureIdSet) ?? inferMeasureIdFromDatum(anchor, measureIds);
+};
 const assertDifferenceLineConfig = (value, path)=>{
     if ('object' != typeof value || null === value || Array.isArray(value)) throw new Error(`${path} must be an object`);
     const start = value.start;
@@ -29,98 +88,186 @@ const annotationDifferenceLine_annotationDifferenceLine = (spec, context)=>{
         annotationDifferenceLine
     ];
     const dataset = advancedVSeed.dataset.flat();
-    const barSpec = spec;
-    const isStacked = isDifferenceLineStacked(vseed, advancedVSeed);
+    const chartSpec = spec;
+    const stackResolveMode = getDifferenceLineStackResolveMode(vseed, advancedVSeed);
+    const useElementStackEnd = usesDifferenceLineElementStackEnd(vseed, advancedVSeed);
+    const isBracketChart = 'line' === vseed.chartType || 'area' === vseed.chartType;
+    const measures = findAllMeasures(advancedVSeed.measures);
+    const measureIds = measures.map((measure)=>measure.id);
+    const axisFormatter = getAxisFormatter(chartSpec);
+    const percentFormatter = createFormatter(DEFAULT_PERCENT_DIFFERENCE_FORMAT);
     const markLine = annotationDifferenceLineList.flatMap((annotationDifferenceLine, index)=>{
-        assertDifferenceLineConfig(annotationDifferenceLine, getDifferenceLinePath(index, annotationDifferenceLineList.length));
-        const start = resolveDifferenceAnchor({
-            dataset,
-            selectorLabel: 'start',
-            selectorValue: annotationDifferenceLine.start.selector,
-            spec: barSpec,
-            isStacked
-        });
-        const end = resolveDifferenceAnchor({
-            dataset,
-            selectorLabel: 'end',
-            selectorValue: annotationDifferenceLine.end.selector,
-            spec: barSpec,
-            isStacked
-        });
-        if (!start || !end) return [];
-        const lineColor = annotationDifferenceLine.lineColor ?? theme?.lineColor ?? DEFAULT_LINE_COLOR;
-        const textColor = annotationDifferenceLine.textColor ?? theme?.textColor ?? DEFAULT_TEXT_COLOR;
-        const textBackgroundColor = annotationDifferenceLine.textBackgroundColor ?? theme?.textBackgroundColor ?? DEFAULT_TEXT_BACKGROUND_COLOR;
-        const textFontSize = annotationDifferenceLine.textFontSize ?? theme?.textFontSize ?? DEFAULT_TEXT_FONT_SIZE;
-        return [
-            {
-                type: 'type-step',
-                autoRange: true,
-                zIndex: ANNOTATION_Z_INDEX,
-                connectDirection: inferDifferenceConnectDirection(vseed, [
-                    start.value,
-                    end.value
-                ]),
-                expandDistance: DEFAULT_EXPAND_DISTANCE,
-                coordinates: (seriesData, relativeSeries)=>[
-                        buildDifferenceCoordinateDatum({
+        try {
+            assertDifferenceLineConfig(annotationDifferenceLine, getDifferenceLinePath(index, annotationDifferenceLineList.length));
+            const start = resolveDifferenceAnchor({
+                dataset,
+                selectorLabel: 'start',
+                selectorValue: annotationDifferenceLine.start.selector,
+                spec: chartSpec,
+                stackResolveMode,
+                allowSelectorFallback: !useElementStackEnd
+            });
+            const end = resolveDifferenceAnchor({
+                dataset,
+                selectorLabel: 'end',
+                selectorValue: annotationDifferenceLine.end.selector,
+                spec: chartSpec,
+                stackResolveMode,
+                allowSelectorFallback: !useElementStackEnd
+            });
+            if (!start || !end) return [];
+            if (start.mode !== end.mode) return [];
+            const usesRuntimeStackEnd = useElementStackEnd || ('column' === vseed.chartType || 'bar' === vseed.chartType) && 'element' === start.mode && 'auto' === stackResolveMode;
+            const useBracketStyle = isBracketChart || ('column' === vseed.chartType || 'bar' === vseed.chartType) && 'element' === start.mode && 'auto' === stackResolveMode;
+            const isStackedBarElementBracket = 'bar' === vseed.chartType && 'element' === start.mode && 'auto' === stackResolveMode;
+            const connectDirection = useBracketStyle ? isStackedBarElementBracket ? 'top' : inferDifferenceBracketDirection(start, end) : inferDifferenceConnectDirection(vseed, [
+                start.value,
+                end.value
+            ]);
+            const lineColor = annotationDifferenceLine.lineColor ?? theme?.lineColor ?? DEFAULT_LINE_COLOR;
+            const textColor = annotationDifferenceLine.textColor ?? theme?.textColor ?? DEFAULT_TEXT_COLOR;
+            const textBackgroundColor = annotationDifferenceLine.textBackgroundColor ?? theme?.textBackgroundColor ?? DEFAULT_TEXT_BACKGROUND_COLOR;
+            const textFontSize = annotationDifferenceLine.textFontSize ?? theme?.textFontSize ?? DEFAULT_TEXT_FONT_SIZE;
+            const differenceType = annotationDifferenceLine.differenceType ?? 'absolute';
+            const startMeasureId = resolveDifferenceMeasureId(start, annotationDifferenceLine.start.selector, measureIds);
+            const endMeasureId = resolveDifferenceMeasureId(end, annotationDifferenceLine.end.selector, measureIds);
+            const sameMeasure = void 0 !== startMeasureId && startMeasureId === endMeasureId;
+            const explicitMeasureFormat = sameMeasure ? getExplicitMeasureFormat(measures.find((measure)=>measure.id === startMeasureId)) : void 0;
+            const differenceFormatter = 'percent' === differenceType ? percentFormatter : explicitMeasureFormat ? createFormatter(explicitMeasureFormat) : axisFormatter ?? autoFormatter;
+            const label = usesRuntimeStackEnd ? {
+                visible: true,
+                position: 'middle',
+                refY: 0,
+                formatMethod: (_markData, seriesData)=>{
+                    try {
+                        return buildDifferenceText(getRuntimeDifferenceValue({
                             anchor: start,
                             seriesData,
-                            relativeSeries
-                        }),
-                        buildDifferenceCoordinateDatum({
+                            useElementStackEnd: usesRuntimeStackEnd
+                        }), getRuntimeDifferenceValue({
                             anchor: end,
                             seriesData,
-                            relativeSeries
-                        })
-                    ],
-                line: {
+                            useElementStackEnd: usesRuntimeStackEnd
+                        }), differenceType, differenceFormatter);
+                    } catch  {
+                        return '';
+                    }
+                },
+                style: {
+                    fill: textColor,
+                    fontSize: textFontSize
+                },
+                labelBackground: {
+                    visible: true,
+                    padding: DEFAULT_LABEL_PADDING,
                     style: {
-                        visible: true,
+                        fill: textBackgroundColor,
+                        fillOpacity: 1,
                         stroke: lineColor,
-                        lineWidth: DEFAULT_LINE_WIDTH,
-                        lineDash: [
-                            0
-                        ],
+                        lineWidth: 1,
                         cornerRadius: DEFAULT_CORNER_RADIUS
                     }
+                }
+            } : {
+                visible: true,
+                position: 'middle',
+                refY: 0,
+                text: buildDifferenceText(start.value, end.value, differenceType, differenceFormatter),
+                style: {
+                    fill: textColor,
+                    fontSize: textFontSize
                 },
-                label: {
-                    confine: true,
+                labelBackground: {
                     visible: true,
-                    position: 'middle',
-                    text: buildDifferenceText(start.value, end.value, annotationDifferenceLine.differenceType ?? 'absolute'),
+                    padding: DEFAULT_LABEL_PADDING,
                     style: {
-                        fill: textColor,
-                        fontSize: textFontSize
+                        fill: textBackgroundColor,
+                        fillOpacity: 1,
+                        stroke: lineColor,
+                        lineWidth: 1,
+                        cornerRadius: DEFAULT_CORNER_RADIUS
+                    }
+                }
+            };
+            return [
+                {
+                    type: 'type-step',
+                    autoRange: true,
+                    zIndex: ANNOTATION_Z_INDEX,
+                    connectDirection,
+                    expandDistance: useBracketStyle ? DEFAULT_BRACKET_EXPAND_DISTANCE : DEFAULT_EXPAND_DISTANCE,
+                    coordinates: (seriesData, relativeSeries)=>{
+                        try {
+                            return [
+                                buildDifferenceCoordinateDatum({
+                                    anchor: start,
+                                    seriesData,
+                                    relativeSeries,
+                                    useElementStackEnd: usesRuntimeStackEnd
+                                }),
+                                buildDifferenceCoordinateDatum({
+                                    anchor: end,
+                                    seriesData,
+                                    relativeSeries,
+                                    useElementStackEnd: usesRuntimeStackEnd
+                                })
+                            ];
+                        } catch  {
+                            return [];
+                        }
                     },
-                    labelBackground: {
-                        visible: true,
-                        padding: DEFAULT_LABEL_PADDING,
+                    line: useBracketStyle ? {
+                        multiSegment: true,
+                        mainSegmentIndex: 1,
+                        style: [
+                            {
+                                visible: true,
+                                stroke: lineColor,
+                                lineWidth: DEFAULT_LINE_WIDTH,
+                                lineDash: DEFAULT_BRACKET_LINE_DASH
+                            },
+                            {
+                                visible: true,
+                                stroke: lineColor,
+                                lineWidth: DEFAULT_LINE_WIDTH
+                            },
+                            {
+                                visible: true,
+                                stroke: lineColor,
+                                lineWidth: DEFAULT_LINE_WIDTH,
+                                lineDash: DEFAULT_BRACKET_LINE_DASH
+                            }
+                        ]
+                    } : {
                         style: {
-                            fill: textBackgroundColor,
-                            fillOpacity: 1,
+                            visible: true,
                             stroke: lineColor,
-                            lineWidth: 1,
+                            lineWidth: DEFAULT_LINE_WIDTH,
+                            lineDash: [
+                                0
+                            ],
                             cornerRadius: DEFAULT_CORNER_RADIUS
                         }
-                    }
-                },
-                startSymbol: {
-                    visible: false
-                },
-                endSymbol: {
-                    visible: true,
-                    size: DEFAULT_END_SYMBOL_SIZE,
-                    refX: DEFAULT_END_SYMBOL_REF_X,
-                    style: {
-                        fill: lineColor
+                    },
+                    label,
+                    startSymbol: {
+                        visible: false
+                    },
+                    endSymbol: {
+                        visible: true,
+                        size: DEFAULT_END_SYMBOL_SIZE,
+                        refX: DEFAULT_END_SYMBOL_REF_X,
+                        style: {
+                            fill: lineColor
+                        }
                     }
                 }
-            }
-        ];
+            ];
+        } catch  {
+            return [];
+        }
     });
-    const specMarkLine = barSpec.markLine || [];
+    const specMarkLine = chartSpec.markLine || [];
     return {
         ...spec,
         markLine: [

package/dist/esm/pipeline/spec/chart/pipes/annotation/annotationDifferenceLine.js.map

@@ -1 +1 @@
-{"version":3,"file":"pipeline/spec/chart/pipes/annotation/annotationDifferenceLine.js","sources":["../../../../../../../src/pipeline/spec/chart/pipes/annotation/annotationDifferenceLine.ts"],"sourcesContent":["import type { IBarChartSpec, ICartesianSeries, IMarkLineSpec } from '@visactor/vchart'\nimport type { AnnotationDifferenceLine, VChartSpecPipe } from 'src/types'\nimport { ANNOTATION_Z_INDEX } from '../../../../utils/constant'\nimport {\n  buildDifferenceCoordinateDatum,\n  buildDifferenceText,\n  inferDifferenceConnectDirection,\n  isDifferenceLineStacked,\n  resolveDifferenceAnchor,\n} from './annotationDifferenceLineCommon'\n\nconst DEFAULT_LINE_COLOR = '#BCC1CB'\nconst DEFAULT_TEXT_COLOR = '#ffffff'\nconst DEFAULT_TEXT_BACKGROUND_COLOR = '#BCC1CB'\nconst DEFAULT_TEXT_FONT_SIZE = 12\nconst DEFAULT_EXPAND_DISTANCE = 24\nconst DEFAULT_LINE_WIDTH = 2\nconst DEFAULT_CORNER_RADIUS = 4\nconst DEFAULT_LABEL_PADDING = 4\nconst DEFAULT_END_SYMBOL_SIZE = 12\nconst DEFAULT_END_SYMBOL_REF_X = -4\n\nconst getDifferenceLinePath = (index: number, total: number) =>\n  total === 1 ? 'annotationDifferenceLine' : `annotationDifferenceLine[${index}]`\n\nconst assertDifferenceLineConfig: (value: unknown, path: string) => asserts value is AnnotationDifferenceLine = (\n  value,\n  path,\n) => {\n  if (typeof value !== 'object' || value === null || Array.isArray(value)) {\n    throw new Error(`${path} must be an object`)\n  }\n\n  const start = (value as Record<string, unknown>).start\n  if (typeof start !== 'object' || start === null || Array.isArray(start)) {\n    throw new Error(`${path}.start is required`)\n  }\n  if ((start as Record<string, unknown>).selector == null) {\n    throw new Error(`${path}.start.selector is required`)\n  }\n\n  const end = (value as Record<string, unknown>).end\n  if (typeof end !== 'object' || end === null || Array.isArray(end)) {\n    throw new Error(`${path}.end is required`)\n  }\n  if ((end as Record<string, unknown>).selector == null) {\n    throw new Error(`${path}.end.selector is required`)\n  }\n}\n\nexport const annotationDifferenceLine: VChartSpecPipe = (spec, context) => {\n  const { advancedVSeed, vseed } = context\n  const annotationDifferenceLine = advancedVSeed.annotation?.annotationDifferenceLine\n\n  if (!annotationDifferenceLine) {\n    return spec\n  }\n\n  const theme = advancedVSeed.config?.[vseed.chartType as 'column']?.annotation?.annotationDifferenceLine\n  const annotationDifferenceLineList = Array.isArray(annotationDifferenceLine)\n    ? annotationDifferenceLine\n    : [annotationDifferenceLine]\n  const dataset = advancedVSeed.dataset.flat()\n  const barSpec = spec as IBarChartSpec\n  const isStacked = isDifferenceLineStacked(vseed, advancedVSeed)\n\n  const markLine = annotationDifferenceLineList.flatMap((annotationDifferenceLine, index) => {\n    assertDifferenceLineConfig(\n      annotationDifferenceLine,\n      getDifferenceLinePath(index, annotationDifferenceLineList.length),\n    )\n\n    const start = resolveDifferenceAnchor({\n      dataset,\n      selectorLabel: 'start',\n      selectorValue: annotationDifferenceLine.start.selector,\n      spec: barSpec,\n      isStacked,\n    })\n    const end = resolveDifferenceAnchor({\n      dataset,\n      selectorLabel: 'end',\n      selectorValue: annotationDifferenceLine.end.selector,\n      spec: barSpec,\n      isStacked,\n    })\n\n    if (!start || !end) {\n      return []\n    }\n\n    const lineColor = annotationDifferenceLine.lineColor ?? theme?.lineColor ?? DEFAULT_LINE_COLOR\n    const textColor = annotationDifferenceLine.textColor ?? theme?.textColor ?? DEFAULT_TEXT_COLOR\n    const textBackgroundColor =\n      annotationDifferenceLine.textBackgroundColor ?? theme?.textBackgroundColor ?? DEFAULT_TEXT_BACKGROUND_COLOR\n    const textFontSize = annotationDifferenceLine.textFontSize ?? theme?.textFontSize ?? DEFAULT_TEXT_FONT_SIZE\n\n    return [\n      {\n        type: 'type-step',\n        autoRange: true,\n        zIndex: ANNOTATION_Z_INDEX,\n        connectDirection: inferDifferenceConnectDirection(vseed, [start.value, end.value]),\n        expandDistance: DEFAULT_EXPAND_DISTANCE,\n        coordinates: (seriesData: any[], relativeSeries: ICartesianSeries) => [\n          buildDifferenceCoordinateDatum({\n            anchor: start,\n            seriesData,\n            relativeSeries,\n          }),\n          buildDifferenceCoordinateDatum({\n            anchor: end,\n            seriesData,\n            relativeSeries,\n          }),\n        ],\n        line: {\n          style: {\n            visible: true,\n            stroke: lineColor,\n            lineWidth: DEFAULT_LINE_WIDTH,\n            lineDash: [0],\n            cornerRadius: DEFAULT_CORNER_RADIUS,\n          },\n        },\n        label: {\n          confine: true,\n          visible: true,\n          position: 'middle',\n          text: buildDifferenceText(start.value, end.value, annotationDifferenceLine.differenceType ?? 'absolute'),\n          style: {\n            fill: textColor,\n            fontSize: textFontSize,\n          },\n          labelBackground: {\n            visible: true,\n            padding: DEFAULT_LABEL_PADDING,\n            style: {\n              fill: textBackgroundColor,\n              fillOpacity: 1,\n              stroke: lineColor,\n              lineWidth: 1,\n              cornerRadius: DEFAULT_CORNER_RADIUS,\n            },\n          },\n        },\n        startSymbol: {\n          visible: false,\n        },\n        endSymbol: {\n          visible: true,\n          size: DEFAULT_END_SYMBOL_SIZE,\n          refX: DEFAULT_END_SYMBOL_REF_X,\n          style: {\n            fill: lineColor,\n          },\n        },\n      } as IMarkLineSpec,\n    ]\n  })\n\n  const specMarkLine = (barSpec.markLine as IMarkLineSpec[]) || []\n\n  return {\n    ...spec,\n    markLine: [...specMarkLine, ...markLine],\n  }\n}\n"],"names":["DEFAULT_LINE_COLOR","DEFAULT_TEXT_COLOR","DEFAULT_TEXT_BACKGROUND_COLOR","DEFAULT_TEXT_FONT_SIZE","DEFAULT_EXPAND_DISTANCE","DEFAULT_LINE_WIDTH","DEFAULT_CORNER_RADIUS","DEFAULT_LABEL_PADDING","DEFAULT_END_SYMBOL_SIZE","DEFAULT_END_SYMBOL_REF_X","getDifferenceLinePath","index","total","assertDifferenceLineConfig","value","path","Array","Error","start","end","annotationDifferenceLine","spec","context","advancedVSeed","vseed","theme","annotationDifferenceLineList","dataset","barSpec","isStacked","isDifferenceLineStacked","markLine","resolveDifferenceAnchor","lineColor","textColor","textBackgroundColor","textFontSize","ANNOTATION_Z_INDEX","inferDifferenceConnectDirection","seriesData","relativeSeries","buildDifferenceCoordinateDatum","buildDifferenceText","specMarkLine"],"mappings":"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"}
+{"version":3,"file":"pipeline/spec/chart/pipes/annotation/annotationDifferenceLine.js","sources":["../../../../../../../src/pipeline/spec/chart/pipes/annotation/annotationDifferenceLine.ts"],"sourcesContent":["import type { IAreaChartSpec, IBarChartSpec, ICartesianSeries, ILineChartSpec, IMarkLineSpec } from '@visactor/vchart'\nimport type { AnnotationDifferenceLine, Measure, VChartSpecPipe } from 'src/types'\nimport { createFormatter, findAllMeasures, autoFormatter } from '../../../../utils'\nimport {\n  isDimensionSelector,\n  isFieldSelector,\n  isMeasureSelector,\n  isPartialDatumSelector,\n} from '../../../../../dataSelector'\nimport { isEmpty } from 'remeda'\nimport { ANNOTATION_Z_INDEX } from '../../../../utils/constant'\nimport {\n  buildDifferenceCoordinateDatum,\n  buildDifferenceText,\n  getDifferenceLineStackResolveMode,\n  getRuntimeDifferenceValue,\n  inferDifferenceBracketDirection,\n  inferDifferenceConnectDirection,\n  type ResolvedDifferenceAnchor,\n  usesDifferenceLineElementStackEnd,\n  resolveDifferenceAnchor,\n} from './annotationDifferenceLineCommon'\n\nconst DEFAULT_LINE_COLOR = '#BCC1CB'\nconst DEFAULT_TEXT_COLOR = '#ffffff'\nconst DEFAULT_TEXT_BACKGROUND_COLOR = '#BCC1CB'\nconst DEFAULT_TEXT_FONT_SIZE = 12\nconst DEFAULT_EXPAND_DISTANCE = 24\nconst DEFAULT_LINE_WIDTH = 2\nconst DEFAULT_CORNER_RADIUS = 4\nconst DEFAULT_LABEL_PADDING = 4\nconst DEFAULT_END_SYMBOL_SIZE = 12\nconst DEFAULT_END_SYMBOL_REF_X = -4\nconst DEFAULT_BRACKET_EXPAND_DISTANCE = 80\nconst DEFAULT_BRACKET_LINE_DASH: [number, number] = [2, 2]\nconst DEFAULT_PERCENT_DIFFERENCE_FORMAT = {\n  type: 'percent' as const,\n  fractionDigits: 2,\n}\n\nconst getDifferenceLinePath = (index: number, total: number) =>\n  total === 1 ? 'annotationDifferenceLine' : `annotationDifferenceLine[${index}]`\n\nconst toArray = <T>(value: T | T[] | undefined | null): T[] => {\n  if (Array.isArray(value)) {\n    return value\n  }\n\n  return value === undefined || value === null ? [] : [value]\n}\n\nconst getAxisFormatter = (spec: IBarChartSpec | ILineChartSpec | IAreaChartSpec) => {\n  const valueAxisOrient = spec.direction === 'horizontal' ? 'bottom' : 'left'\n  const formatMethod = spec.axes?.find((axis) => axis.orient === valueAxisOrient)?.label?.formatMethod\n\n  return typeof formatMethod === 'function'\n    ? (value: number) => String(formatMethod(value as never) ?? value)\n    : undefined\n}\n\nconst getExplicitMeasureFormat = (measure?: Measure) => {\n  if (measure?.numFormat && !isEmpty(measure.numFormat)) {\n    return measure.numFormat\n  }\n\n  if (measure?.format && !isEmpty(measure.format)) {\n    return measure.format\n  }\n\n  return undefined\n}\n\nconst inferMeasureIdFromDatum = (anchor: ResolvedDifferenceAnchor, measureIds: string[]) => {\n  const candidateValues = [anchor.matchedDatum, anchor.coordinateDatum]\n\n  for (const datum of candidateValues) {\n    if (!datum) {\n      continue\n    }\n\n    const candidates = measureIds.filter((measureId) => Number(datum[measureId]) === anchor.value)\n\n    if (candidates.length === 1) {\n      return candidates[0]\n    }\n  }\n\n  return undefined\n}\n\nconst inferMeasureIdFromSelector = (\n  selectorValue: AnnotationDifferenceLine['start']['selector'],\n  measureIdSet: Set<string>,\n) => {\n  const matchedMeasureIds = new Set<string>()\n\n  for (const currentSelector of toArray(selectorValue)) {\n    if (isMeasureSelector(currentSelector)) {\n      if (measureIdSet.has(currentSelector.field)) {\n        matchedMeasureIds.add(currentSelector.field)\n      }\n      continue\n    }\n\n    if (isFieldSelector(currentSelector) || isDimensionSelector(currentSelector)) {\n      continue\n    }\n\n    if (isPartialDatumSelector(currentSelector)) {\n      Object.keys(currentSelector).forEach((field) => {\n        if (measureIdSet.has(field)) {\n          matchedMeasureIds.add(field)\n        }\n      })\n    }\n  }\n\n  return matchedMeasureIds.size === 1 ? Array.from(matchedMeasureIds)[0] : undefined\n}\n\nconst resolveDifferenceMeasureId = (\n  anchor: ResolvedDifferenceAnchor,\n  selectorValue: AnnotationDifferenceLine['start']['selector'],\n  measureIds: string[],\n) => {\n  if (anchor.mode !== 'element') {\n    return undefined\n  }\n\n  if (measureIds.length === 1) {\n    return measureIds[0]\n  }\n\n  const measureIdSet = new Set(measureIds)\n  return inferMeasureIdFromSelector(selectorValue, measureIdSet) ?? inferMeasureIdFromDatum(anchor, measureIds)\n}\n\nconst assertDifferenceLineConfig: (value: unknown, path: string) => asserts value is AnnotationDifferenceLine = (\n  value,\n  path,\n) => {\n  if (typeof value !== 'object' || value === null || Array.isArray(value)) {\n    throw new Error(`${path} must be an object`)\n  }\n\n  const start = (value as Record<string, unknown>).start\n  if (typeof start !== 'object' || start === null || Array.isArray(start)) {\n    throw new Error(`${path}.start is required`)\n  }\n  if ((start as Record<string, unknown>).selector == null) {\n    throw new Error(`${path}.start.selector is required`)\n  }\n\n  const end = (value as Record<string, unknown>).end\n  if (typeof end !== 'object' || end === null || Array.isArray(end)) {\n    throw new Error(`${path}.end is required`)\n  }\n  if ((end as Record<string, unknown>).selector == null) {\n    throw new Error(`${path}.end.selector is required`)\n  }\n}\n\nexport const annotationDifferenceLine: VChartSpecPipe = (spec, context) => {\n  const { advancedVSeed, vseed } = context\n  const annotationDifferenceLine = advancedVSeed.annotation?.annotationDifferenceLine\n\n  if (!annotationDifferenceLine) {\n    return spec\n  }\n\n  const theme = advancedVSeed.config?.[vseed.chartType as 'column']?.annotation?.annotationDifferenceLine\n  const annotationDifferenceLineList = Array.isArray(annotationDifferenceLine)\n    ? annotationDifferenceLine\n    : [annotationDifferenceLine]\n  const dataset = advancedVSeed.dataset.flat()\n  const chartSpec = spec as IBarChartSpec | ILineChartSpec | IAreaChartSpec\n  const stackResolveMode = getDifferenceLineStackResolveMode(vseed, advancedVSeed)\n  const useElementStackEnd = usesDifferenceLineElementStackEnd(vseed, advancedVSeed)\n  const isBracketChart = vseed.chartType === 'line' || vseed.chartType === 'area'\n  const measures = findAllMeasures(advancedVSeed.measures)\n  const measureIds = measures.map((measure) => measure.id)\n  const axisFormatter = getAxisFormatter(chartSpec)\n  const percentFormatter = createFormatter(DEFAULT_PERCENT_DIFFERENCE_FORMAT)\n\n  const markLine = annotationDifferenceLineList.flatMap((annotationDifferenceLine, index) => {\n    try {\n      assertDifferenceLineConfig(\n        annotationDifferenceLine,\n        getDifferenceLinePath(index, annotationDifferenceLineList.length),\n      )\n\n      const start = resolveDifferenceAnchor({\n        dataset,\n        selectorLabel: 'start',\n        selectorValue: annotationDifferenceLine.start.selector,\n        spec: chartSpec,\n        stackResolveMode,\n        allowSelectorFallback: !useElementStackEnd,\n      })\n      const end = resolveDifferenceAnchor({\n        dataset,\n        selectorLabel: 'end',\n        selectorValue: annotationDifferenceLine.end.selector,\n        spec: chartSpec,\n        stackResolveMode,\n        allowSelectorFallback: !useElementStackEnd,\n      })\n\n      if (!start || !end) {\n        return []\n      }\n\n      if (start.mode !== end.mode) {\n        return []\n      }\n\n      const usesRuntimeStackEnd =\n        useElementStackEnd ||\n        ((vseed.chartType === 'column' || vseed.chartType === 'bar') &&\n          start.mode === 'element' &&\n          stackResolveMode === 'auto')\n      const useBracketStyle =\n        isBracketChart ||\n        ((vseed.chartType === 'column' || vseed.chartType === 'bar') &&\n          start.mode === 'element' &&\n          stackResolveMode === 'auto')\n      const isStackedBarElementBracket =\n        vseed.chartType === 'bar' && start.mode === 'element' && stackResolveMode === 'auto'\n      const connectDirection = useBracketStyle\n        ? isStackedBarElementBracket\n          ? 'top'\n          : inferDifferenceBracketDirection(start, end)\n        : inferDifferenceConnectDirection(vseed, [start.value, end.value])\n\n      const lineColor = annotationDifferenceLine.lineColor ?? theme?.lineColor ?? DEFAULT_LINE_COLOR\n      const textColor = annotationDifferenceLine.textColor ?? theme?.textColor ?? DEFAULT_TEXT_COLOR\n      const textBackgroundColor =\n        annotationDifferenceLine.textBackgroundColor ?? theme?.textBackgroundColor ?? DEFAULT_TEXT_BACKGROUND_COLOR\n      const textFontSize = annotationDifferenceLine.textFontSize ?? theme?.textFontSize ?? DEFAULT_TEXT_FONT_SIZE\n      const differenceType = annotationDifferenceLine.differenceType ?? 'absolute'\n      const startMeasureId = resolveDifferenceMeasureId(start, annotationDifferenceLine.start.selector, measureIds)\n      const endMeasureId = resolveDifferenceMeasureId(end, annotationDifferenceLine.end.selector, measureIds)\n      const sameMeasure = startMeasureId !== undefined && startMeasureId === endMeasureId\n      const explicitMeasureFormat = sameMeasure\n        ? getExplicitMeasureFormat(measures.find((measure) => measure.id === startMeasureId))\n        : undefined\n      const differenceFormatter =\n        differenceType === 'percent'\n          ? percentFormatter\n          : explicitMeasureFormat\n            ? createFormatter(explicitMeasureFormat)\n            : (axisFormatter ?? autoFormatter)\n\n      const label = usesRuntimeStackEnd\n        ? {\n            visible: true,\n            position: 'middle',\n            refY: 0,\n            formatMethod: (_markData: any[], seriesData: any[]) => {\n              try {\n                return buildDifferenceText(\n                  getRuntimeDifferenceValue({\n                    anchor: start,\n                    seriesData,\n                    useElementStackEnd: usesRuntimeStackEnd,\n                  }),\n                  getRuntimeDifferenceValue({\n                    anchor: end,\n                    seriesData,\n                    useElementStackEnd: usesRuntimeStackEnd,\n                  }),\n                  differenceType,\n                  differenceFormatter,\n                )\n              } catch {\n                return ''\n              }\n            },\n            style: {\n              fill: textColor,\n              fontSize: textFontSize,\n            },\n            labelBackground: {\n              visible: true,\n              padding: DEFAULT_LABEL_PADDING,\n              style: {\n                fill: textBackgroundColor,\n                fillOpacity: 1,\n                stroke: lineColor,\n                lineWidth: 1,\n                cornerRadius: DEFAULT_CORNER_RADIUS,\n              },\n            },\n          }\n        : {\n            visible: true,\n            position: 'middle',\n            refY: 0,\n            text: buildDifferenceText(start.value, end.value, differenceType, differenceFormatter),\n            style: {\n              fill: textColor,\n              fontSize: textFontSize,\n            },\n            labelBackground: {\n              visible: true,\n              padding: DEFAULT_LABEL_PADDING,\n              style: {\n                fill: textBackgroundColor,\n                fillOpacity: 1,\n                stroke: lineColor,\n                lineWidth: 1,\n                cornerRadius: DEFAULT_CORNER_RADIUS,\n              },\n            },\n          }\n\n      return [\n        {\n          type: 'type-step',\n          autoRange: true,\n          zIndex: ANNOTATION_Z_INDEX,\n          connectDirection,\n          expandDistance: useBracketStyle ? DEFAULT_BRACKET_EXPAND_DISTANCE : DEFAULT_EXPAND_DISTANCE,\n          coordinates: (seriesData: any[], relativeSeries: ICartesianSeries) => {\n            try {\n              return [\n                buildDifferenceCoordinateDatum({\n                  anchor: start,\n                  seriesData,\n                  relativeSeries,\n                  useElementStackEnd: usesRuntimeStackEnd,\n                }),\n                buildDifferenceCoordinateDatum({\n                  anchor: end,\n                  seriesData,\n                  relativeSeries,\n                  useElementStackEnd: usesRuntimeStackEnd,\n                }),\n              ]\n            } catch {\n              return []\n            }\n          },\n          line: useBracketStyle\n            ? {\n                multiSegment: true,\n                mainSegmentIndex: 1,\n                style: [\n                  {\n                    visible: true,\n                    stroke: lineColor,\n                    lineWidth: DEFAULT_LINE_WIDTH,\n                    lineDash: DEFAULT_BRACKET_LINE_DASH,\n                  },\n                  {\n                    visible: true,\n                    stroke: lineColor,\n                    lineWidth: DEFAULT_LINE_WIDTH,\n                  },\n                  {\n                    visible: true,\n                    stroke: lineColor,\n                    lineWidth: DEFAULT_LINE_WIDTH,\n                    lineDash: DEFAULT_BRACKET_LINE_DASH,\n                  },\n                ],\n              }\n            : {\n                style: {\n                  visible: true,\n                  stroke: lineColor,\n                  lineWidth: DEFAULT_LINE_WIDTH,\n                  lineDash: [0],\n                  cornerRadius: DEFAULT_CORNER_RADIUS,\n                },\n              },\n          label,\n          startSymbol: {\n            visible: false,\n          },\n          endSymbol: {\n            visible: true,\n            size: DEFAULT_END_SYMBOL_SIZE,\n            refX: DEFAULT_END_SYMBOL_REF_X,\n            style: {\n              fill: lineColor,\n            },\n          },\n        } as IMarkLineSpec,\n      ]\n    } catch {\n      return []\n    }\n  })\n\n  const specMarkLine = (chartSpec.markLine as IMarkLineSpec[]) || []\n\n  return {\n    ...spec,\n    markLine: [...specMarkLine, ...markLine],\n  }\n}\n"],"names":["DEFAULT_LINE_COLOR","DEFAULT_TEXT_COLOR","DEFAULT_TEXT_BACKGROUND_COLOR","DEFAULT_TEXT_FONT_SIZE","DEFAULT_EXPAND_DISTANCE","DEFAULT_LINE_WIDTH","DEFAULT_CORNER_RADIUS","DEFAULT_LABEL_PADDING","DEFAULT_END_SYMBOL_SIZE","DEFAULT_END_SYMBOL_REF_X","DEFAULT_BRACKET_EXPAND_DISTANCE","DEFAULT_BRACKET_LINE_DASH","DEFAULT_PERCENT_DIFFERENCE_FORMAT","getDifferenceLinePath","index","total","toArray","value","Array","getAxisFormatter","spec","valueAxisOrient","formatMethod","axis","String","undefined","getExplicitMeasureFormat","measure","isEmpty","inferMeasureIdFromDatum","anchor","measureIds","candidateValues","datum","candidates","measureId","Number","inferMeasureIdFromSelector","selectorValue","measureIdSet","matchedMeasureIds","Set","currentSelector","isMeasureSelector","isFieldSelector","isDimensionSelector","isPartialDatumSelector","Object","field","resolveDifferenceMeasureId","assertDifferenceLineConfig","path","Error","start","end","annotationDifferenceLine","context","advancedVSeed","vseed","theme","annotationDifferenceLineList","dataset","chartSpec","stackResolveMode","getDifferenceLineStackResolveMode","useElementStackEnd","usesDifferenceLineElementStackEnd","isBracketChart","measures","findAllMeasures","axisFormatter","percentFormatter","createFormatter","markLine","resolveDifferenceAnchor","usesRuntimeStackEnd","useBracketStyle","isStackedBarElementBracket","connectDirection","inferDifferenceBracketDirection","inferDifferenceConnectDirection","lineColor","textColor","textBackgroundColor","textFontSize","differenceType","startMeasureId","endMeasureId","sameMeasure","explicitMeasureFormat","differenceFormatter","autoFormatter","label","_markData","seriesData","buildDifferenceText","getRuntimeDifferenceValue","ANNOTATION_Z_INDEX","relativeSeries","buildDifferenceCoordinateDatum","specMarkLine"],"mappings":"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"}

package/dist/esm/pipeline/spec/chart/pipes/annotation/annotationDifferenceLineCommon.d.ts

@@ -1,27 +1,43 @@
-import type { IBarChartSpec, ICartesianSeries } from '@visactor/vchart';
+import type { IAreaChartSpec, IBarChartSpec, ICartesianSeries, ILineChartSpec } from '@visactor/vchart';
 import type { AdvancedVSeed, Datum, Selector, Selectors, VSeed } from '../../../../../types';
 type DifferenceSelectorLabel = 'start' | 'end';
+type DifferenceChartSpec = IBarChartSpec | ILineChartSpec | IAreaChartSpec;
+export type DifferenceStackResolveMode = 'none' | 'stackTotal' | 'auto';
+export type DifferenceAnchorMode = 'element' | 'stackTotal';
 export type ResolvedDifferenceAnchor = {
+    mode: DifferenceAnchorMode;
     selectorLabel: DifferenceSelectorLabel;
     coordinateDatum: Datum;
     matchedDatum?: Datum;
     stackGroupDatum?: Datum;
+    bandDatum: Datum;
+    bandIndex?: number;
     value: number;
 };
-export declare const isDifferenceLineStacked: (vseed: VSeed, advancedVSeed: AdvancedVSeed) => boolean;
+export declare const getDifferenceLineStackResolveMode: (vseed: VSeed, advancedVSeed: AdvancedVSeed) => DifferenceStackResolveMode;
+export declare const usesDifferenceLineElementStackEnd: (vseed: VSeed, advancedVSeed: AdvancedVSeed) => boolean;
 export declare const resolveDifferenceAnchor: (options: {
     dataset: Datum[];
     selectorLabel: DifferenceSelectorLabel;
     selectorValue: Selector | Selectors;
-    spec: IBarChartSpec;
-    isStacked: boolean;
+    spec: DifferenceChartSpec;
+    stackResolveMode: DifferenceStackResolveMode;
+    allowSelectorFallback?: boolean;
 }) => ResolvedDifferenceAnchor | undefined;
 export declare const getStackRuntimeTotal: (runtimeMatches: Datum[]) => number | undefined;
 export declare const buildDifferenceCoordinateDatum: (options: {
     anchor: ResolvedDifferenceAnchor;
     seriesData: Datum[];
     relativeSeries: ICartesianSeries;
+    useElementStackEnd?: boolean;
 }) => Record<string | number, any>;
-export declare const buildDifferenceText: (startValue: number, endValue: number, differenceType?: "absolute" | "percent") => string;
+export declare const getRuntimeDifferenceValue: (options: {
+    anchor: ResolvedDifferenceAnchor;
+    seriesData: Datum[];
+    useElementStackEnd?: boolean;
+}) => number;
+export declare const getDifferenceValue: (startValue: number, endValue: number, differenceType?: "absolute" | "percent") => number;
+export declare const buildDifferenceText: (startValue: number, endValue: number, differenceType?: "absolute" | "percent", formatter?: (value: number) => string) => string;
 export declare const inferDifferenceConnectDirection: (vseed: VSeed, values: [number, number]) => "left" | "top" | "right" | "bottom";
+export declare const inferDifferenceBracketDirection: (start: ResolvedDifferenceAnchor, end: ResolvedDifferenceAnchor) => "left" | "right";
 export {};

package/dist/esm/pipeline/spec/chart/pipes/annotation/annotationDifferenceLineCommon.js

@@ -1,6 +1,7 @@
 import { isDimensionSelector, isFieldSelector, isMeasureSelector, isPartialDatumSelector, isValueSelector, selector } from "../../../../../dataSelector/index.js";
 import { hasMultipleMeasureInSingleView, isBarLikeChart } from "../../../../utils/index.js";
 import { isSubset } from "./utils.js";
+const STACK_END_FIELD = '__VCHART_STACK_END';
 const toArray = (value)=>{
     if (Array.isArray(value)) return value;
     return null == value ? [] : [
@@ -22,6 +23,10 @@ const buildStackGroupDatum = (datum, bandFields)=>Object.fromEntries(bandFields.
             field,
             datum[field]
         ]));
+const resolveBandIndex = (dataset, bandDatum)=>{
+    const bandIndex = dataset.findIndex((datum)=>isSubset(bandDatum, datum));
+    return bandIndex >= 0 ? bandIndex : void 0;
+};
 const buildFallbackSelectorDatum = (selectorValue)=>{
     const selectorList = Array.isArray(selectorValue) ? selectorValue : [
         selectorValue
@@ -68,7 +73,7 @@ const inferFallbackValue = (fallbackDatum, valueField, bandFields)=>{
     return fallbackDatum[numericCandidateKeys[0]];
 };
 const resolveFallbackAnchor = (options)=>{
-    const { selectorLabel, selectorValue, valueField, bandFields } = options;
+    const { dataset, selectorLabel, selectorValue, valueField, bandFields } = options;
     const fallbackDatum = buildFallbackSelectorDatum(selectorValue);
     if (!fallbackDatum) return;
     const inferredValue = inferFallbackValue(fallbackDatum, valueField, bandFields);
@@ -77,11 +82,15 @@ const resolveFallbackAnchor = (options)=>{
         ...fallbackDatum,
         [valueField]: inferredValue
     };
+    const bandDatum = buildStackGroupDatum(coordinateDatum, bandFields);
     try {
         return {
+            mode: 'element',
             selectorLabel,
             coordinateDatum,
             matchedDatum: fallbackDatum,
+            bandDatum,
+            bandIndex: resolveBandIndex(dataset, bandDatum),
             value: normalizeDifferenceValue(inferredValue, selectorLabel, valueField)
         };
     } catch  {
@@ -92,24 +101,36 @@ const hasMixedSigns = (values)=>{
     const nonZeroValues = values.filter((value)=>0 !== value);
     return nonZeroValues.some((value)=>value > 0) && nonZeroValues.some((value)=>value < 0);
 };
-const isDifferenceLineStacked = (vseed, advancedVSeed)=>('column' === vseed.chartType || 'bar' === vseed.chartType) && hasMultipleMeasureInSingleView(advancedVSeed.reshapeMeasures ?? []);
+const getDifferenceLineStackResolveMode = (vseed, advancedVSeed)=>{
+    const hasMultipleMeasure = hasMultipleMeasureInSingleView(advancedVSeed.reshapeMeasures ?? []);
+    if (!hasMultipleMeasure) return 'none';
+    if ('column' === vseed.chartType) return 'auto';
+    if ('bar' === vseed.chartType) return 'auto';
+    return 'none';
+};
+const usesDifferenceLineElementStackEnd = (vseed, advancedVSeed)=>'area' === vseed.chartType && hasMultipleMeasureInSingleView(advancedVSeed.reshapeMeasures ?? []);
 const resolveDifferenceAnchor = (options)=>{
-    const { dataset, selectorLabel, selectorValue, spec, isStacked } = options;
+    const { dataset, selectorLabel, selectorValue, spec, stackResolveMode, allowSelectorFallback = true } = options;
     const matches = dataset.filter((datum)=>selector(datum, selectorValue));
     const valueField = getDifferenceValueField(spec);
     const bandFields = getDifferenceBandFields(spec);
-    if (0 === matches.length) return isStacked ? void 0 : resolveFallbackAnchor({
+    if (0 === matches.length) return 'none' === stackResolveMode && allowSelectorFallback ? resolveFallbackAnchor({
+        dataset,
         selectorLabel,
         selectorValue,
         valueField,
         bandFields
-    });
-    if (!isStacked) {
+    }) : void 0;
+    if ('none' === stackResolveMode || 'auto' === stackResolveMode && 1 === matches.length) {
         if (1 !== matches.length) throw new Error(`annotationDifferenceLine ${selectorLabel} selector must resolve to exactly one datum, got ${matches.length}`);
+        const bandDatum = buildStackGroupDatum(matches[0], bandFields);
         return {
+            mode: 'element',
             selectorLabel,
             coordinateDatum: matches[0],
             matchedDatum: matches[0],
+            bandDatum,
+            bandIndex: resolveBandIndex(dataset, bandDatum),
             value: normalizeDifferenceValue(matches[0][valueField], selectorLabel, valueField)
         };
     }
@@ -121,27 +142,38 @@ const resolveDifferenceAnchor = (options)=>{
     if (1 !== stackGroups.size) throw new Error(`annotationDifferenceLine ${selectorLabel} selector must resolve to exactly one stack group, got ${stackGroups.size}`);
     const stackGroupDatum = Array.from(stackGroups.values())[0];
     const groupRows = dataset.filter((datum)=>isSubset(stackGroupDatum, datum));
+    if ('auto' === stackResolveMode && groupRows.length !== matches.length) throw new Error(`annotationDifferenceLine ${selectorLabel} selector must resolve to exactly one stack element or one full stack group`);
     const groupValues = groupRows.map((datum)=>normalizeDifferenceValue(datum[valueField], selectorLabel, valueField));
     if (hasMixedSigns(groupValues)) throw new Error('annotationDifferenceLine does not support mixed-sign stack totals in v1');
     return {
+        mode: 'stackTotal',
         selectorLabel,
         coordinateDatum: stackGroupDatum,
         matchedDatum: matches[0],
         stackGroupDatum,
+        bandDatum: stackGroupDatum,
+        bandIndex: resolveBandIndex(dataset, stackGroupDatum),
         value: groupValues.reduce((sum, value)=>sum + value, 0)
     };
 };
 const getStackRuntimeTotal = (runtimeMatches)=>{
-    const stackEndValues = runtimeMatches.map((datum)=>Number(datum.__VCHART_STACK_END));
-    if (stackEndValues.some((value)=>Number.isNaN(value))) return;
+    if (0 === runtimeMatches.length) return;
+    const stackEndValues = runtimeMatches.map((datum)=>Number(datum[STACK_END_FIELD]));
+    if (stackEndValues.some((value)=>!Number.isFinite(value))) return;
     if (hasMixedSigns(stackEndValues)) throw new Error('annotationDifferenceLine does not support mixed-sign runtime stack totals in v1');
     return stackEndValues.some((value)=>value < 0) ? Math.min(...stackEndValues) : Math.max(...stackEndValues);
 };
 const buildDifferenceCoordinateDatum = (options)=>{
-    const { anchor, seriesData, relativeSeries } = options;
+    const { anchor, seriesData, relativeSeries, useElementStackEnd = false } = options;
     if (!anchor.stackGroupDatum) {
         const runtimeMatches = anchor.matchedDatum ? seriesData.filter((datum)=>isSubset(anchor.matchedDatum, datum)) : [];
-        return runtimeMatches[0] ?? anchor.coordinateDatum;
+        if (!useElementStackEnd) return runtimeMatches[0] ?? anchor.coordinateDatum;
+        const runtimeMatch = runtimeMatches[0];
+        const runtimeStackEnd = Number(runtimeMatch?.[STACK_END_FIELD]);
+        return {
+            ...runtimeMatch ?? anchor.coordinateDatum,
+            [relativeSeries.getStackValueField()]: Number.isFinite(runtimeStackEnd) ? runtimeStackEnd : anchor.value
+        };
     }
     const runtimeMatches = seriesData.filter((datum)=>isSubset(anchor.stackGroupDatum, datum));
     const runtimeStackTotal = getStackRuntimeTotal(runtimeMatches);
@@ -150,18 +182,39 @@ const buildDifferenceCoordinateDatum = (options)=>{
         [relativeSeries.getStackValueField()]: runtimeStackTotal ?? anchor.value
     };
 };
-const buildDifferenceText = (startValue, endValue, differenceType = 'absolute')=>{
+const getRuntimeDifferenceValue = (options)=>{
+    const { anchor, seriesData, useElementStackEnd = false } = options;
+    if (anchor.stackGroupDatum) {
+        const runtimeMatches = seriesData.filter((datum)=>isSubset(anchor.stackGroupDatum, datum));
+        return getStackRuntimeTotal(runtimeMatches) ?? anchor.value;
+    }
+    if (!useElementStackEnd || !anchor.matchedDatum) return anchor.value;
+    const runtimeMatch = seriesData.find((datum)=>isSubset(anchor.matchedDatum, datum));
+    const runtimeStackEnd = Number(runtimeMatch?.[STACK_END_FIELD]);
+    return Number.isFinite(runtimeStackEnd) ? runtimeStackEnd : anchor.value;
+};
+const getDifferenceValue = (startValue, endValue, differenceType = 'absolute')=>{
     if ('percent' === differenceType) {
         if (0 === startValue) throw new Error('annotationDifferenceLine percent difference cannot be computed because start value is 0');
-        return `${((endValue - startValue) / startValue * 100).toFixed(0)}%`;
+        return (endValue - startValue) / startValue;
     }
-    return `${endValue - startValue}`;
+    return endValue - startValue;
+};
+const buildDifferenceText = (startValue, endValue, differenceType = 'absolute', formatter)=>{
+    const differenceValue = getDifferenceValue(startValue, endValue, differenceType);
+    if (formatter) return formatter(differenceValue);
+    if ('percent' === differenceType) return `${(100 * differenceValue).toFixed(2)}%`;
+    return `${differenceValue}`;
 };
 const inferDifferenceConnectDirection = (vseed, values)=>{
     const isNegativeSide = values.every((value)=>value < 0);
     if (isBarLikeChart(vseed)) return isNegativeSide ? 'left' : 'right';
     return isNegativeSide ? 'bottom' : 'top';
 };
-export { buildDifferenceCoordinateDatum, buildDifferenceText, getStackRuntimeTotal, inferDifferenceConnectDirection, isDifferenceLineStacked, resolveDifferenceAnchor };
+const inferDifferenceBracketDirection = (start, end)=>{
+    if (void 0 === start.bandIndex || void 0 === end.bandIndex) return 'right';
+    return start.bandIndex <= end.bandIndex ? 'right' : 'left';
+};
+export { buildDifferenceCoordinateDatum, buildDifferenceText, getDifferenceLineStackResolveMode, getDifferenceValue, getRuntimeDifferenceValue, getStackRuntimeTotal, inferDifferenceBracketDirection, inferDifferenceConnectDirection, resolveDifferenceAnchor, usesDifferenceLineElementStackEnd };
 
 //# sourceMappingURL=annotationDifferenceLineCommon.js.map