@visactor/vseed 0.4.24 → 0.4.26

package/dist/umd/index.js

@@ -1029,6 +1029,7 @@
                 FoldPrimaryMeasureValue: ()=>FoldPrimaryMeasureValue,
                 donutSpecPipeline: ()=>donutSpecPipeline,
                 registerTokenThemes: ()=>registerTokenThemes,
+                zRegionPadding: ()=>zRegionPadding,
                 zSortLegend: ()=>zSortLegend,
                 registerTable: ()=>registerTable,
                 zCrosshairRect: ()=>zCrosshairRect,
@@ -1117,8 +1118,9 @@
                 pivotTableSpecPipeline: ()=>pivotTableSpecPipeline,
                 registerRoseParallel: ()=>registerRoseParallel,
                 terminateWorkerPool: ()=>terminateWorkerPool,
-                zYBandAxis: ()=>zYBandAxis,
+                zDifferenceAnchor: ()=>zDifferenceAnchor,
                 zRaceBar: ()=>zRaceBar,
+                zYBandAxis: ()=>zYBandAxis,
                 zTimeFormat: ()=>zTimeFormat,
                 zRacePie: ()=>zRacePie,
                 DimAxisType: ()=>DimAxisType,
@@ -1192,6 +1194,7 @@
                 zKdeRegressionLine: ()=>zKdeRegressionLine,
                 zDynamicFilter: ()=>zDynamicFilter,
                 zTooltip: ()=>zTooltip,
+                zAnnotationDifferenceLineConfig: ()=>zAnnotationDifferenceLineConfig,
                 zAreaPercentConfig: ()=>zAreaPercentConfig,
                 zPivotChartGridConfig: ()=>zPivotChartGridConfig,
                 zMarkStyle: ()=>zMarkStyle,
@@ -1206,10 +1209,10 @@
                 BinStartMeasureId: ()=>BinStartMeasureId,
                 MeasureEncodingEnum: ()=>MeasureEncodingEnum,
                 ColorEncoding: ()=>ColorEncoding,
-                zLowessRegressionLine: ()=>zLowessRegressionLine,
+                zDifferenceSelectors: ()=>zDifferenceSelectors,
                 heatmapAdvancedPipeline: ()=>heatmapAdvancedPipeline,
                 tableSpecPipeline: ()=>tableSpecPipeline,
-                zTableDynamicFilter: ()=>zTableDynamicFilter,
+                zLowessRegressionLine: ()=>zLowessRegressionLine,
                 zEncoding: ()=>zEncoding,
                 zAreaConfig: ()=>zAreaConfig,
                 registerAll: ()=>registerAll,
@@ -1225,6 +1228,7 @@
                 FoldMeasureValue: ()=>FoldMeasureValue,
                 isVChart: ()=>isVChart,
                 zBrushConfig: ()=>zBrushConfig,
+                zTableDynamicFilter: ()=>zTableDynamicFilter,
                 zTheme: ()=>zTheme,
                 autoFormatter: ()=>autoFormatter,
                 zDatum: ()=>zDatum,
@@ -1235,6 +1239,7 @@
                 zDimensionEncoding: ()=>zDimensionEncoding,
                 zBodyCellStyle: ()=>zBodyCellStyle,
                 barAdvancedPipeline: ()=>barAdvancedPipeline,
+                zDifferenceSelector: ()=>zDifferenceSelector,
                 zTreeMap: ()=>zTreeMap,
                 DUAL_AXIS_CHART_COLUMN_Z_INDEX: ()=>1000,
                 condition: ()=>condition_condition,
@@ -1321,6 +1326,7 @@
                 zLinearColor: ()=>zLinearColor,
                 zCirclePacking: ()=>zCirclePacking,
                 isDualAxisChartType: ()=>isDualAxisChartType,
+                zAnnotationDifferenceLine: ()=>zAnnotationDifferenceLine,
                 raceScatterAdvancedPipeline: ()=>raceScatterAdvancedPipeline,
                 treeMapAdvancedPipeline: ()=>treeMapAdvancedPipeline,
                 barParallelAdvancedPipeline: ()=>barParallelAdvancedPipeline,
@@ -5573,6 +5579,7 @@ self.R = R;
                     'color',
                     'label',
                     'legend',
+                    'regionPadding',
                     'tooltip',
                     'xAxis',
                     'yAxis',
@@ -5612,7 +5619,8 @@ self.R = R;
                     'annotationPoint',
                     'annotationHorizontalLine',
                     'annotationVerticalLine',
-                    'annotationArea'
+                    'annotationArea',
+                    'annotationDifferenceLine'
                 ]);
                 return {
                     ...advancedVSeed,
@@ -5686,6 +5694,23 @@ self.R = R;
                 result.animation = true;
                 return result;
             };
+            const regionPadding = (spec, context)=>{
+                const chartConfig = context.advancedVSeed.config?.[context.vseed.chartType];
+                const padding = chartConfig?.regionPadding;
+                if (null == padding || !Array.isArray(spec.region)) return spec;
+                const region = spec.region;
+                if (0 === region.length) return spec;
+                return {
+                    ...spec,
+                    region: [
+                        {
+                            ...region[0],
+                            padding
+                        },
+                        ...region.slice(1)
+                    ]
+                };
+            };
             const color_color = (spec, context)=>{
                 const result = {
                     ...spec
@@ -7070,6 +7095,426 @@ self.R = R;
                 };
             };
             const annotationPoint_annotationPoint = generateAnnotationPointPipe({});
+            const STACK_END_FIELD = '__VCHART_STACK_END';
+            const toArray = (value)=>{
+                if (Array.isArray(value)) return value;
+                return null == value ? [] : [
+                    value
+                ];
+            };
+            const getDifferenceBandFields = (spec)=>toArray('horizontal' === spec.direction ? spec.yField : spec.xField);
+            const getDifferenceValueField = (spec)=>{
+                const valueField = toArray('horizontal' === spec.direction ? spec.xField : spec.yField)[0];
+                if (!valueField) throw new Error('annotationDifferenceLine requires a value field in the target chart spec');
+                return valueField;
+            };
+            const normalizeDifferenceValue = (value, selectorLabel, field)=>{
+                const numberValue = Number(value);
+                if (Number.isNaN(numberValue)) throw new Error(`annotationDifferenceLine ${selectorLabel} selector resolved to a non-numeric value on field "${field}"`);
+                return numberValue;
+            };
+            const buildStackGroupDatum = (datum, bandFields)=>Object.fromEntries(bandFields.map((field)=>[
+                        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
+                ];
+                const fallbackDatum = {};
+                for (const currentSelector of selectorList){
+                    if (isValueSelector(currentSelector) || isFieldSelector(currentSelector)) return;
+                    if (isMeasureSelector(currentSelector)) {
+                        const operator = currentSelector.operator || currentSelector.op;
+                        const selectorValues = Array.isArray(currentSelector.value) ? currentSelector.value : [
+                            currentSelector.value
+                        ];
+                        if (![
+                            '=',
+                            '=='
+                        ].includes(operator) || 1 !== selectorValues.length) return;
+                        fallbackDatum[currentSelector.field] = selectorValues[0];
+                        continue;
+                    }
+                    if (isDimensionSelector(currentSelector)) {
+                        const operator = currentSelector.operator || currentSelector.op;
+                        const selectorValues = Array.isArray(currentSelector.value) ? currentSelector.value : [
+                            currentSelector.value
+                        ];
+                        if ('in' !== operator || 1 !== selectorValues.length) return;
+                        fallbackDatum[currentSelector.field] = selectorValues[0];
+                        continue;
+                    }
+                    if (isPartialDatumSelector(currentSelector)) {
+                        Object.assign(fallbackDatum, currentSelector);
+                        continue;
+                    }
+                    return;
+                }
+                return Object.keys(fallbackDatum).length > 0 ? fallbackDatum : void 0;
+            };
+            const inferFallbackValue = (fallbackDatum, valueField, bandFields)=>{
+                if (valueField in fallbackDatum) return fallbackDatum[valueField];
+                const numericCandidateKeys = Object.keys(fallbackDatum).filter((key)=>{
+                    if (key === valueField || bandFields.includes(key)) return false;
+                    return 'number' == typeof fallbackDatum[key];
+                });
+                if (1 !== numericCandidateKeys.length) return;
+                return fallbackDatum[numericCandidateKeys[0]];
+            };
+            const resolveFallbackAnchor = (options)=>{
+                const { dataset, selectorLabel, selectorValue, valueField, bandFields } = options;
+                const fallbackDatum = buildFallbackSelectorDatum(selectorValue);
+                if (!fallbackDatum) return;
+                const inferredValue = inferFallbackValue(fallbackDatum, valueField, bandFields);
+                if (void 0 === inferredValue) return;
+                const coordinateDatum = {
+                    ...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  {
+                    return;
+                }
+            };
+            const hasMixedSigns = (values)=>{
+                const nonZeroValues = values.filter((value)=>0 !== value);
+                return nonZeroValues.some((value)=>value > 0) && nonZeroValues.some((value)=>value < 0);
+            };
+            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, stackResolveMode, allowSelectorFallback = true } = options;
+                const matches = dataset.filter((datum)=>selector_selector(datum, selectorValue));
+                const valueField = getDifferenceValueField(spec);
+                const bandFields = getDifferenceBandFields(spec);
+                if (0 === matches.length) return 'none' === stackResolveMode && allowSelectorFallback ? resolveFallbackAnchor({
+                    dataset,
+                    selectorLabel,
+                    selectorValue,
+                    valueField,
+                    bandFields
+                }) : 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)
+                    };
+                }
+                const stackGroups = new Map();
+                matches.forEach((datum)=>{
+                    const stackGroupDatum = buildStackGroupDatum(datum, bandFields);
+                    stackGroups.set(JSON.stringify(stackGroupDatum), stackGroupDatum);
+                });
+                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[STACK_END_FIELD]));
+                if (stackEndValues.some((value)=>Number.isNaN(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, useElementStackEnd = false } = options;
+                if (!anchor.stackGroupDatum) {
+                    const runtimeMatches = anchor.matchedDatum ? seriesData.filter((datum)=>isSubset(anchor.matchedDatum, datum)) : [];
+                    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.isNaN(runtimeStackEnd) ? anchor.value : runtimeStackEnd
+                    };
+                }
+                const runtimeMatches = seriesData.filter((datum)=>isSubset(anchor.stackGroupDatum, datum));
+                const runtimeStackTotal = getStackRuntimeTotal(runtimeMatches);
+                return {
+                    ...runtimeMatches[0] ?? anchor.coordinateDatum,
+                    [relativeSeries.getStackValueField()]: runtimeStackTotal ?? anchor.value
+                };
+            };
+            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.isNaN(runtimeStackEnd) ? anchor.value : runtimeStackEnd;
+            };
+            const buildDifferenceText = (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}`;
+            };
+            const inferDifferenceConnectDirection = (vseed, values)=>{
+                const isNegativeSide = values.every((value)=>value < 0);
+                if (isBarLikeChart(vseed)) return isNegativeSide ? 'left' : 'right';
+                return isNegativeSide ? 'bottom' : 'top';
+            };
+            const inferDifferenceBracketDirection = (start, end)=>{
+                if (void 0 === start.bandIndex || void 0 === end.bandIndex) return 'right';
+                return start.bandIndex <= end.bandIndex ? 'right' : 'left';
+            };
+            const DEFAULT_LINE_COLOR = '#BCC1CB';
+            const DEFAULT_TEXT_COLOR = '#ffffff';
+            const DEFAULT_TEXT_BACKGROUND_COLOR = '#BCC1CB';
+            const DEFAULT_TEXT_FONT_SIZE = 12;
+            const DEFAULT_EXPAND_DISTANCE = 24;
+            const DEFAULT_LINE_WIDTH = 2;
+            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 getDifferenceLinePath = (index, total)=>1 === total ? 'annotationDifferenceLine' : `annotationDifferenceLine[${index}]`;
+            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;
+                if ('object' != typeof start || null === start || Array.isArray(start)) throw new Error(`${path}.start is required`);
+                if (null == start.selector) throw new Error(`${path}.start.selector is required`);
+                const end = value.end;
+                if ('object' != typeof end || null === end || Array.isArray(end)) throw new Error(`${path}.end is required`);
+                if (null == end.selector) throw new Error(`${path}.end.selector is required`);
+            };
+            const annotationDifferenceLine_annotationDifferenceLine = (spec, context)=>{
+                const { advancedVSeed, vseed } = context;
+                const annotationDifferenceLine = advancedVSeed.annotation?.annotationDifferenceLine;
+                if (!annotationDifferenceLine) return spec;
+                const theme = advancedVSeed.config?.[vseed.chartType]?.annotation?.annotationDifferenceLine;
+                const annotationDifferenceLineList = Array.isArray(annotationDifferenceLine) ? annotationDifferenceLine : [
+                    annotationDifferenceLine
+                ];
+                const dataset = advancedVSeed.dataset.flat();
+                const chartSpec = spec;
+                const stackResolveMode = getDifferenceLineStackResolveMode(vseed, advancedVSeed);
+                const useElementStackEnd = usesDifferenceLineElementStackEnd(vseed, advancedVSeed);
+                const isBracketChart = 'line' === vseed.chartType || 'area' === vseed.chartType;
+                const markLine = annotationDifferenceLineList.flatMap((annotationDifferenceLine, index)=>{
+                    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 label = usesRuntimeStackEnd ? {
+                            visible: true,
+                            position: 'middle',
+                            refY: 0,
+                            formatMethod: (_markData, seriesData)=>{
+                                try {
+                                    return buildDifferenceText(getRuntimeDifferenceValue({
+                                        anchor: start,
+                                        seriesData,
+                                        useElementStackEnd: usesRuntimeStackEnd
+                                    }), getRuntimeDifferenceValue({
+                                        anchor: end,
+                                        seriesData,
+                                        useElementStackEnd: usesRuntimeStackEnd
+                                    }), differenceType);
+                                } catch  {
+                                    return '';
+                                }
+                            },
+                            style: {
+                                fill: textColor,
+                                fontSize: textFontSize
+                            },
+                            labelBackground: {
+                                visible: true,
+                                padding: DEFAULT_LABEL_PADDING,
+                                style: {
+                                    fill: textBackgroundColor,
+                                    fillOpacity: 1,
+                                    stroke: lineColor,
+                                    lineWidth: 1,
+                                    cornerRadius: DEFAULT_CORNER_RADIUS
+                                }
+                            }
+                        } : {
+                            visible: true,
+                            position: 'middle',
+                            refY: 0,
+                            text: buildDifferenceText(start.value, end.value, differenceType),
+                            style: {
+                                fill: textColor,
+                                fontSize: textFontSize
+                            },
+                            labelBackground: {
+                                visible: true,
+                                padding: DEFAULT_LABEL_PADDING,
+                                style: {
+                                    fill: textBackgroundColor,
+                                    fillOpacity: 1,
+                                    stroke: lineColor,
+                                    lineWidth: 1,
+                                    cornerRadius: DEFAULT_CORNER_RADIUS
+                                }
+                            }
+                        };
+                        return [
+                            {
+                                type: 'type-step',
+                                autoRange: true,
+                                zIndex: 1000,
+                                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 [];
+                                    }
+                                },
+                                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: {
+                                        visible: true,
+                                        stroke: lineColor,
+                                        lineWidth: DEFAULT_LINE_WIDTH,
+                                        lineDash: [
+                                            0
+                                        ],
+                                        cornerRadius: DEFAULT_CORNER_RADIUS
+                                    }
+                                },
+                                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 = chartSpec.markLine || [];
+                return {
+                    ...spec,
+                    markLine: [
+                        ...specMarkLine,
+                        ...markLine
+                    ]
+                };
+            };
             const annotationVerticalLine_annotationVerticalLine = (spec, context)=>{
                 const { advancedVSeed, vseed } = context;
                 const { annotation, config } = advancedVSeed;
@@ -8713,6 +9158,7 @@ self.R = R;
             const line_line = [
                 fontFamilyTheme,
                 initLine,
+                regionPadding,
                 colorAdapter(color_color, linearColor),
                 background_backgroundColor,
                 datasetXY,
@@ -8730,6 +9176,7 @@ self.R = R;
                     titleEncoding: 'x'
                 }),
                 annotationPoint_annotationPoint,
+                annotationDifferenceLine_annotationDifferenceLine,
                 annotationVerticalLine_annotationVerticalLine,
                 annotationHorizontalLine_annotationHorizontalLine,
                 annotationArea_annotationArea,
@@ -8743,6 +9190,7 @@ self.R = R;
                 pivotIndicators_pivotIndicators([
                     fontFamilyTheme,
                     initLine,
+                    regionPadding,
                     colorAdapter(color_color, linearColor),
                     background_backgroundColor,
                     datasetXY,
@@ -8759,6 +9207,7 @@ self.R = R;
                         titleEncoding: 'x'
                     }),
                     annotationPoint_annotationPoint,
+                    annotationDifferenceLine_annotationDifferenceLine,
                     annotationVerticalLine_annotationVerticalLine,
                     annotationHorizontalLine_annotationHorizontalLine,
                     annotationArea_annotationArea,
@@ -8856,6 +9305,7 @@ self.R = R;
                     'color',
                     'label',
                     'legend',
+                    'regionPadding',
                     'tooltip',
                     'xAxis',
                     'yAxis',
@@ -9742,6 +10192,7 @@ self.R = R;
             const column_column = [
                 fontFamilyTheme,
                 initColumn,
+                regionPadding,
                 stackCornerRadius_stackCornerRadius,
                 barMaxWidth_barMaxWidth,
                 stackInverse,
@@ -9762,6 +10213,7 @@ self.R = R;
                 annotationPoint_annotationPoint,
                 annotationVerticalLine_annotationVerticalLine,
                 annotationHorizontalLine_annotationHorizontalLine,
+                annotationDifferenceLine_annotationDifferenceLine,
                 annotationAreaBand,
                 columnPolynomialRegressionLine
             ];
@@ -9773,6 +10225,7 @@ self.R = R;
                 pivotIndicators_pivotIndicators([
                     fontFamilyTheme,
                     initColumn,
+                    regionPadding,
                     stackCornerRadius_stackCornerRadius,
                     barMaxWidth_barMaxWidth,
                     stackInverse,
@@ -9792,6 +10245,7 @@ self.R = R;
                     annotationPoint_annotationPoint,
                     annotationVerticalLine_annotationVerticalLine,
                     annotationHorizontalLine_annotationHorizontalLine,
+                    annotationDifferenceLine_annotationDifferenceLine,
                     annotationAreaBand,
                     columnPolynomialRegressionLine
                 ]),
@@ -9957,6 +10411,7 @@ self.R = R;
             const columnParallel = [
                 fontFamilyTheme,
                 initColumnParallel,
+                regionPadding,
                 stackCornerRadius_stackCornerRadius,
                 barMaxWidth_barMaxWidth,
                 barGapInGroup_barGapInGroup,
@@ -9977,6 +10432,7 @@ self.R = R;
                 annotationPoint_annotationPoint,
                 annotationVerticalLine_annotationVerticalLine,
                 annotationHorizontalLine_annotationHorizontalLine,
+                annotationDifferenceLine_annotationDifferenceLine,
                 annotationAreaBand
             ];
             const pivotColumnParallel = [
@@ -9987,6 +10443,7 @@ self.R = R;
                 pivotIndicators_pivotIndicators([
                     fontFamilyTheme,
                     initColumnParallel,
+                    regionPadding,
                     stackCornerRadius_stackCornerRadius,
                     barMaxWidth_barMaxWidth,
                     colorAdapter(color_color, linearColor),
@@ -10005,6 +10462,7 @@ self.R = R;
                     annotationPoint_annotationPoint,
                     annotationVerticalLine_annotationVerticalLine,
                     annotationHorizontalLine_annotationHorizontalLine,
+                    annotationDifferenceLine_annotationDifferenceLine,
                     annotationAreaBand
                 ]),
                 pivotRowDimensions,
@@ -10062,6 +10520,7 @@ self.R = R;
             const columnPercent = [
                 fontFamilyTheme,
                 initColumn,
+                regionPadding,
                 stackCornerRadius_stackCornerRadius,
                 stackInverse,
                 barMaxWidth_barMaxWidth,
@@ -10093,6 +10552,7 @@ self.R = R;
                 pivotIndicators_pivotIndicators([
                     fontFamilyTheme,
                     initColumn,
+                    regionPadding,
                     stackCornerRadius_stackCornerRadius,
                     stackInverse,
                     barMaxWidth_barMaxWidth,
@@ -10442,6 +10902,7 @@ self.R = R;
             const bar = [
                 fontFamilyTheme,
                 initBar,
+                regionPadding,
                 stackCornerRadius_stackCornerRadius,
                 barMaxWidth_barMaxWidth,
                 colorAdapter(color_color, linearColor),
@@ -10461,6 +10922,7 @@ self.R = R;
                 annotationPoint_annotationPoint,
                 annotationVerticalLine_annotationVerticalLine,
                 annotationHorizontalLine_annotationHorizontalLine,
+                annotationDifferenceLine_annotationDifferenceLine,
                 annotationAreaBand
             ];
             const pivotBar = [
@@ -10471,6 +10933,7 @@ self.R = R;
                 pivotIndicators_pivotIndicators([
                     fontFamilyTheme,
                     initBar,
+                    regionPadding,
                     stackCornerRadius_stackCornerRadius,
                     barMaxWidth_barMaxWidth,
                     colorAdapter(color_color, linearColor),
@@ -10489,6 +10952,7 @@ self.R = R;
                     annotationPoint_annotationPoint,
                     annotationVerticalLine_annotationVerticalLine,
                     annotationHorizontalLine_annotationHorizontalLine,
+                    annotationDifferenceLine_annotationDifferenceLine,
                     annotationAreaBand
                 ]),
                 pivotRowDimensions,
@@ -13191,6 +13655,7 @@ self.R = R;
             const barParallel = [
                 fontFamilyTheme,
                 initBarParallel,
+                regionPadding,
                 stackCornerRadius_stackCornerRadius,
                 barMaxWidth_barMaxWidth,
                 barGapInGroup_barGapInGroup,
@@ -13211,6 +13676,7 @@ self.R = R;
                 annotationPoint_annotationPoint,
                 annotationVerticalLine_annotationVerticalLine,
                 annotationHorizontalLine_annotationHorizontalLine,
+                annotationDifferenceLine_annotationDifferenceLine,
                 annotationAreaBand
             ];
             const pivotBarParallel = [
@@ -13221,6 +13687,7 @@ self.R = R;
                 pivotIndicators_pivotIndicators([
                     fontFamilyTheme,
                     initBarParallel,
+                    regionPadding,
                     stackCornerRadius_stackCornerRadius,
                     barMaxWidth_barMaxWidth,
                     colorAdapter(color_color, linearColor),
@@ -13238,6 +13705,7 @@ self.R = R;
                     annotationPoint_annotationPoint,
                     annotationVerticalLine_annotationVerticalLine,
                     annotationHorizontalLine_annotationHorizontalLine,
+                    annotationDifferenceLine_annotationDifferenceLine,
                     annotationAreaBand
                 ]),
                 pivotRowDimensions,
@@ -13288,6 +13756,7 @@ self.R = R;
             const barPercent = [
                 fontFamilyTheme,
                 initBar,
+                regionPadding,
                 stackCornerRadius_stackCornerRadius,
                 barMaxWidth_barMaxWidth,
                 colorAdapter(color_color, linearColor),
@@ -13318,6 +13787,7 @@ self.R = R;
                 pivotIndicators_pivotIndicators([
                     fontFamilyTheme,
                     initBar,
+                    regionPadding,
                     stackCornerRadius_stackCornerRadius,
                     barMaxWidth_barMaxWidth,
                     colorAdapter(color_color, linearColor),
@@ -13475,6 +13945,7 @@ self.R = R;
             const area_area = [
                 fontFamilyTheme,
                 initArea,
+                regionPadding,
                 stackInverse,
                 colorAdapter(color_color, linearColor),
                 background_backgroundColor,
@@ -13494,6 +13965,7 @@ self.R = R;
                 colorLineStyleFill(lineStyle_lineStyle),
                 colorAreaStyleFill(areaStyle_areaStyle),
                 annotationPoint_annotationPoint,
+                annotationDifferenceLine_annotationDifferenceLine,
                 annotationVerticalLine_annotationVerticalLine,
                 annotationHorizontalLine_annotationHorizontalLine,
                 annotationArea_annotationArea,
@@ -13507,6 +13979,7 @@ self.R = R;
                 pivotIndicators_pivotIndicators([
                     fontFamilyTheme,
                     initArea,
+                    regionPadding,
                     colorAdapter(color_color, linearColor),
                     background_backgroundColor,
                     stackInverse,
@@ -13525,6 +13998,7 @@ self.R = R;
                     colorLineStyleFill(lineStyle_lineStyle),
                     colorAreaStyleFill(areaStyle_areaStyle),
                     annotationPoint_annotationPoint,
+                    annotationDifferenceLine_annotationDifferenceLine,
                     annotationVerticalLine_annotationVerticalLine,
                     annotationHorizontalLine_annotationHorizontalLine,
                     annotationArea_annotationArea,
@@ -13578,6 +14052,7 @@ self.R = R;
             const areaPercent = [
                 fontFamilyTheme,
                 initArea,
+                regionPadding,
                 stackInverse,
                 colorAdapter(color_color, linearColor),
                 background_backgroundColor,
@@ -13610,6 +14085,7 @@ self.R = R;
                 pivotIndicators_pivotIndicators([
                     fontFamilyTheme,
                     initArea,
+                    regionPadding,
                     stackInverse,
                     colorAdapter(color_color, linearColor),
                     background_backgroundColor,
@@ -19389,6 +19865,15 @@ self.R = R;
                     textBackgroundBorderColor: '#BCC1CB'
                 });
             const getLightAnnotationVerticalLine = ()=>getLightAnnotationHorizontalLine();
+            const getDefaultAnnotationDifferenceLine = ()=>({
+                    textFontSize: 12
+                });
+            const getLightAnnotationDifferenceLine = ()=>({
+                    ...getDefaultAnnotationDifferenceLine(),
+                    lineColor: '#BCC1CB',
+                    textColor: '#ffffff',
+                    textBackgroundColor: '#BCC1CB'
+                });
             const getDefaultAnnotationArea = ()=>({
                     textFontSize: 12,
                     textFontWeight: 400,
@@ -19417,6 +19902,7 @@ self.R = R;
                     annotationPoint: getLightAnnotationPoint(),
                     annotationHorizontalLine: getLightAnnotationHorizontalLine(),
                     annotationVerticalLine: getLightAnnotationVerticalLine(),
+                    annotationDifferenceLine: getLightAnnotationDifferenceLine(),
                     annotationArea: getLightAnnotationArea()
                 });
             const getDarkAnnotationPoint = ()=>({
@@ -19433,6 +19919,12 @@ self.R = R;
                     textBackgroundBorderColor: '#55595F'
                 });
             const getDarkAnnotationVerticalLine = ()=>getDarkAnnotationHorizontalLine();
+            const getDarkAnnotationDifferenceLine = ()=>({
+                    ...getDefaultAnnotationDifferenceLine(),
+                    lineColor: '#55595F',
+                    textColor: '#E2E3E6',
+                    textBackgroundColor: '#55595F'
+                });
             const getDarkAnnotationArea = ()=>({
                     ...getDefaultAnnotationArea(),
                     textColor: '#E2E3E6',
@@ -19446,6 +19938,7 @@ self.R = R;
                     annotationPoint: getDarkAnnotationPoint(),
                     annotationHorizontalLine: getDarkAnnotationHorizontalLine(),
                     annotationVerticalLine: getDarkAnnotationVerticalLine(),
+                    annotationDifferenceLine: getDarkAnnotationDifferenceLine(),
                     annotationArea: getDarkAnnotationArea()
                 });
             const getLightLinearAxis = ()=>({
@@ -25094,6 +25587,30 @@ self.R = R;
                 offsetY: schemas_number().default(0).nullish(),
                 offsetX: schemas_number().default(0).nullish()
             });
+            const zDifferenceSelector = union([
+                zPartialSelector,
+                zMeasureSelector,
+                zDimensionSelector
+            ]);
+            const zDifferenceSelectors = schemas_array(zDifferenceSelector);
+            const zDifferenceAnchor = schemas_object({
+                selector: union([
+                    zDifferenceSelector,
+                    zDifferenceSelectors
+                ])
+            });
+            const zAnnotationDifferenceLine = schemas_object({
+                start: zDifferenceAnchor,
+                end: zDifferenceAnchor,
+                differenceType: schemas_enum([
+                    'absolute',
+                    'percent'
+                ]).nullish(),
+                textFontSize: schemas_number().nullish(),
+                textColor: schemas_string().nullish(),
+                textBackgroundColor: schemas_string().nullish(),
+                lineColor: schemas_string().nullish()
+            });
             const zAnnotationHorizontalLine = schemas_object({
                 yValue: union([
                     schemas_number(),
@@ -25229,11 +25746,18 @@ self.R = R;
                 areaLineDash: true,
                 outerPadding: true
             }).partial();
+            const zAnnotationDifferenceLineConfig = zAnnotationDifferenceLine.pick({
+                lineColor: true,
+                textColor: true,
+                textFontSize: true,
+                textBackgroundColor: true
+            }).partial();
             const zAnnotationConfig = schemas_object({
                 annotationPoint: zAnnotationPointConfig.nullish(),
                 annotationHorizontalLine: zAnnotationHorizontalLineConfig.nullish(),
                 annotationVerticalLine: zAnnotationVerticalLineConfig.nullish(),
-                annotationArea: zAnnotationAreaConfig.nullish()
+                annotationArea: zAnnotationAreaConfig.nullish(),
+                annotationDifferenceLine: zAnnotationDifferenceLineConfig.nullish()
             });
             const zPivotChartGridConfig = schemas_object({
                 borderColor: schemas_string().nullish(),
@@ -25260,6 +25784,13 @@ self.R = R;
                 showTooltip: schemas_boolean().nullish(),
                 showLabel: schemas_boolean().nullish()
             });
+            const zRegionPaddingObject = schemas_object({
+                top: schemas_number().nonnegative().nullish(),
+                right: schemas_number().nonnegative().nullish(),
+                bottom: schemas_number().nonnegative().nullish(),
+                left: schemas_number().nonnegative().nullish()
+            }).partial();
+            const zRegionPadding = schemas_number().nonnegative().or(zRegionPaddingObject);
             const zBrushStyleConfig = schemas_object({
                 opacity: schemas_number().optional(),
                 stroke: schemas_string().optional(),
@@ -25292,6 +25823,7 @@ self.R = R;
                 color: zColor.nullish(),
                 tooltip: zTooltip.nullish(),
                 legend: zLegend.nullish(),
+                regionPadding: zRegionPadding.nullish(),
                 xAxis: zXBandAxis.nullish(),
                 yAxis: zYLinearAxis.nullish(),
                 crosshairLine: zCrosshairLine.nullish(),
@@ -25347,6 +25879,7 @@ self.R = R;
                 color: zColor.nullish(),
                 tooltip: zTooltip.nullish(),
                 legend: zLegend.nullish(),
+                regionPadding: zRegionPadding.nullish(),
                 xAxis: zXBandAxis.nullish(),
                 yAxis: zYLinearAxis.nullish(),
                 crosshairRect: zCrosshairRect.nullish(),
@@ -25368,6 +25901,7 @@ self.R = R;
                 color: zColor.nullish(),
                 tooltip: zTooltip.nullish(),
                 legend: zLegend.nullish(),
+                regionPadding: zRegionPadding.nullish(),
                 xAxis: zXLinearAxis.nullish(),
                 yAxis: zYBandAxis.nullish(),
                 crosshairRect: zCrosshairRect.nullish(),
@@ -25385,6 +25919,7 @@ self.R = R;
                 color: zColor.nullish(),
                 tooltip: zTooltip.nullish(),
                 legend: zLegend.nullish(),
+                regionPadding: zRegionPadding.nullish(),
                 xAxis: zXBandAxis.nullish(),
                 yAxis: zYLinearAxis.nullish(),
                 crosshairLine: zCrosshairLine.nullish(),
@@ -25789,7 +26324,8 @@ self.R = R;
                 annotationPoint: zAnnotationPoint.or(schemas_array(zAnnotationPoint)).nullish(),
                 annotationVerticalLine: zAnnotationVerticalLine.or(schemas_array(zAnnotationVerticalLine)).nullish(),
                 annotationHorizontalLine: zAnnotationHorizontalLine.or(schemas_array(zAnnotationHorizontalLine)).nullish(),
-                annotationArea: zAnnotationArea.or(schemas_array(zAnnotationArea)).nullish()
+                annotationArea: zAnnotationArea.or(schemas_array(zAnnotationArea)).nullish(),
+                annotationDifferenceLine: zAnnotationDifferenceLine.or(schemas_array(zAnnotationDifferenceLine)).nullish()
             });
             const zSort = schemas_object({
                 order: schemas_enum([
@@ -25920,6 +26456,7 @@ self.R = R;
                 color: zColor.nullish(),
                 label: zLabel.nullish(),
                 legend: zLegend.nullish(),
+                regionPadding: zRegionPadding.nullish(),
                 tooltip: zTooltip.nullish(),
                 brush: zBrush.nullish(),
                 xAxis: zXBandAxis.nullish(),
@@ -25934,6 +26471,7 @@ self.R = R;
                 annotationVerticalLine: schemas_array(zAnnotationVerticalLine).or(zAnnotationVerticalLine).nullish(),
                 annotationHorizontalLine: schemas_array(zAnnotationHorizontalLine).or(zAnnotationHorizontalLine).nullish(),
                 annotationArea: schemas_array(zAnnotationArea).or(zAnnotationArea).nullish(),
+                annotationDifferenceLine: schemas_array(zAnnotationDifferenceLine).or(zAnnotationDifferenceLine).nullish(),
                 dimensionLinkage: zDimensionLinkage.nullish(),
                 locale: zLocale.nullish()
             });
@@ -25949,6 +26487,7 @@ self.R = R;
                 color: zColor.nullish(),
                 label: zLabel.nullish(),
                 legend: zLegend.nullish(),
+                regionPadding: zRegionPadding.nullish(),
                 tooltip: zTooltip.nullish(),
                 brush: zBrush.nullish(),
                 xAxis: zXBandAxis.nullish(),
@@ -25964,6 +26503,7 @@ self.R = R;
                 annotationVerticalLine: schemas_array(zAnnotationVerticalLine).or(zAnnotationVerticalLine).nullish(),
                 annotationHorizontalLine: schemas_array(zAnnotationHorizontalLine).or(zAnnotationHorizontalLine).nullish(),
                 annotationArea: schemas_array(zAnnotationArea).or(zAnnotationArea).nullish(),
+                annotationDifferenceLine: schemas_array(zAnnotationDifferenceLine).or(zAnnotationDifferenceLine).nullish(),
                 polynomialRegressionLine: schemas_array(zPolynomialRegressionLine).or(zPolynomialRegressionLine).nullish(),
                 dimensionLinkage: zDimensionLinkage.nullish(),
                 locale: zLocale.nullish()
@@ -25980,6 +26520,7 @@ self.R = R;
                 color: zColor.nullish(),
                 label: zLabel.nullish(),
                 legend: zLegend.nullish(),
+                regionPadding: zRegionPadding.nullish(),
                 tooltip: zTooltip.nullish(),
                 brush: zBrush.nullish(),
                 xAxis: zXBandAxis.nullish(),
@@ -25994,6 +26535,7 @@ self.R = R;
                 annotationVerticalLine: schemas_array(zAnnotationVerticalLine).or(zAnnotationVerticalLine).nullish(),
                 annotationHorizontalLine: schemas_array(zAnnotationHorizontalLine).or(zAnnotationHorizontalLine).nullish(),
                 annotationArea: schemas_array(zAnnotationArea).or(zAnnotationArea).nullish(),
+                annotationDifferenceLine: schemas_array(zAnnotationDifferenceLine).or(zAnnotationDifferenceLine).nullish(),
                 dimensionLinkage: zDimensionLinkage.nullish(),
                 locale: zLocale.nullish()
             });
@@ -26008,6 +26550,7 @@ self.R = R;
                 color: zColor.nullish(),
                 label: zLabel.nullish(),
                 legend: zLegend.nullish(),
+                regionPadding: zRegionPadding.nullish(),
                 tooltip: zTooltip.nullish(),
                 brush: zBrush.nullish(),
                 xAxis: zXBandAxis.nullish(),
@@ -26035,6 +26578,7 @@ self.R = R;
                 color: zColor.nullish(),
                 label: zLabel.nullish(),
                 legend: zLegend.nullish(),
+                regionPadding: zRegionPadding.nullish(),
                 tooltip: zTooltip.nullish(),
                 brush: zBrush.nullish(),
                 xAxis: zXLinearAxis.nullish(),
@@ -26048,6 +26592,7 @@ self.R = R;
                 annotationVerticalLine: schemas_array(zAnnotationVerticalLine).or(zAnnotationVerticalLine).nullish(),
                 annotationHorizontalLine: schemas_array(zAnnotationHorizontalLine).or(zAnnotationHorizontalLine).nullish(),
                 annotationArea: schemas_array(zAnnotationArea).or(zAnnotationArea).nullish(),
+                annotationDifferenceLine: schemas_array(zAnnotationDifferenceLine).or(zAnnotationDifferenceLine).nullish(),
                 dimensionLinkage: zDimensionLinkage.nullish(),
                 locale: zLocale.nullish()
             });
@@ -26179,6 +26724,7 @@ self.R = R;
                 color: zColor.nullish(),
                 label: zLabel.nullish(),
                 legend: zLegend.nullish(),
+                regionPadding: zRegionPadding.nullish(),
                 tooltip: zTooltip.nullish(),
                 brush: zBrush.nullish(),
                 xAxis: zXLinearAxis.nullish(),
@@ -26193,6 +26739,7 @@ self.R = R;
                 annotationVerticalLine: schemas_array(zAnnotationVerticalLine).or(zAnnotationVerticalLine).nullish(),
                 annotationHorizontalLine: schemas_array(zAnnotationHorizontalLine).or(zAnnotationHorizontalLine).nullish(),
                 annotationArea: schemas_array(zAnnotationArea).or(zAnnotationArea).nullish(),
+                annotationDifferenceLine: schemas_array(zAnnotationDifferenceLine).or(zAnnotationDifferenceLine).nullish(),
                 dimensionLinkage: zDimensionLinkage.nullish(),
                 locale: zLocale.nullish(),
                 page: zPage.nullish()
@@ -26208,6 +26755,7 @@ self.R = R;
                 color: zColor.nullish(),
                 label: zLabel.nullish(),
                 legend: zLegend.nullish(),
+                regionPadding: zRegionPadding.nullish(),
                 tooltip: zTooltip.nullish(),
                 brush: zBrush.nullish(),
                 xAxis: zXLinearAxis.nullish(),
@@ -26235,6 +26783,7 @@ self.R = R;
                 color: zColor.nullish(),
                 label: zLabel.nullish(),
                 legend: zLegend.nullish(),
+                regionPadding: zRegionPadding.nullish(),
                 tooltip: zTooltip.nullish(),
                 brush: zBrush.nullish(),
                 xAxis: zXBandAxis.nullish(),
@@ -26248,6 +26797,7 @@ self.R = R;
                 annotationVerticalLine: schemas_array(zAnnotationVerticalLine).or(zAnnotationVerticalLine).nullish(),
                 annotationHorizontalLine: schemas_array(zAnnotationHorizontalLine).or(zAnnotationHorizontalLine).nullish(),
                 annotationArea: schemas_array(zAnnotationArea).or(zAnnotationArea).nullish(),
+                annotationDifferenceLine: schemas_array(zAnnotationDifferenceLine).or(zAnnotationDifferenceLine).nullish(),
                 dimensionLinkage: zDimensionLinkage.nullish(),
                 locale: zLocale.nullish()
             });
@@ -26262,6 +26812,7 @@ self.R = R;
                 color: zColor.nullish(),
                 label: zLabel.nullish(),
                 legend: zLegend.nullish(),
+                regionPadding: zRegionPadding.nullish(),
                 tooltip: zTooltip.nullish(),
                 brush: zBrush.nullish(),
                 xAxis: zXBandAxis.nullish(),
@@ -26803,6 +27354,9 @@ self.R = R;
                     annotationVerticalLine: {
                         textFontSize: tokens.labelFontSize
                     },
+                    annotationDifferenceLine: {
+                        textFontSize: tokens.labelFontSize
+                    },
                     annotationArea: {
                         textFontSize: tokens.labelFontSize
                     }