@visactor/vseed 0.4.25 → 0.4.27

package/dist/umd/index.js

@@ -1029,6 +1029,7 @@
                 FoldPrimaryMeasureValue: ()=>FoldPrimaryMeasureValue,
                 donutSpecPipeline: ()=>donutSpecPipeline,
                 registerTokenThemes: ()=>registerTokenThemes,
+                zRegionPadding: ()=>zRegionPadding,
                 zSortLegend: ()=>zSortLegend,
                 registerTable: ()=>registerTable,
                 zCrosshairRect: ()=>zCrosshairRect,
@@ -5578,6 +5579,7 @@ self.R = R;
                     'color',
                     'label',
                     'legend',
+                    'regionPadding',
                     'tooltip',
                     'xAxis',
                     'yAxis',
@@ -5692,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
@@ -7075,7 +7094,494 @@ self.R = R;
                     };
                 };
             };
-            const annotationPoint_annotationPoint = generateAnnotationPointPipe({});
+            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)=>{
+                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, 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.isFinite(runtimeStackEnd) ? runtimeStackEnd : anchor.value
+                    };
+                }
+                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.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;
+                }
+                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';
+            };
+            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 DEFAULT_PERCENT_DIFFERENCE_FORMAT = {
+                type: 'percent',
+                fractionDigits: 2
+            };
+            const getDifferenceLinePath = (index, total)=>1 === total ? 'annotationDifferenceLine' : `annotationDifferenceLine[${index}]`;
+            const annotationDifferenceLine_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 && !chunk_VCYTMP4D_n(measure.numFormat)) return measure.numFormat;
+                if (measure?.format && !chunk_VCYTMP4D_n(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 annotationDifferenceLine_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;
+                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 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)=>{
+                    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,
+                                        useElementStackEnd: usesRuntimeStackEnd
+                                    }), getRuntimeDifferenceValue({
+                                        anchor: end,
+                                        seriesData,
+                                        useElementStackEnd: usesRuntimeStackEnd
+                                    }), differenceType, differenceFormatter);
+                                } 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, differenceFormatter),
+                            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;
@@ -8719,6 +9225,7 @@ self.R = R;
             const line_line = [
                 fontFamilyTheme,
                 initLine,
+                regionPadding,
                 colorAdapter(color_color, linearColor),
                 background_backgroundColor,
                 datasetXY,
@@ -8736,6 +9243,7 @@ self.R = R;
                     titleEncoding: 'x'
                 }),
                 annotationPoint_annotationPoint,
+                annotationDifferenceLine_annotationDifferenceLine,
                 annotationVerticalLine_annotationVerticalLine,
                 annotationHorizontalLine_annotationHorizontalLine,
                 annotationArea_annotationArea,
@@ -8749,6 +9257,7 @@ self.R = R;
                 pivotIndicators_pivotIndicators([
                     fontFamilyTheme,
                     initLine,
+                    regionPadding,
                     colorAdapter(color_color, linearColor),
                     background_backgroundColor,
                     datasetXY,
@@ -8765,6 +9274,7 @@ self.R = R;
                         titleEncoding: 'x'
                     }),
                     annotationPoint_annotationPoint,
+                    annotationDifferenceLine_annotationDifferenceLine,
                     annotationVerticalLine_annotationVerticalLine,
                     annotationHorizontalLine_annotationHorizontalLine,
                     annotationArea_annotationArea,
@@ -8862,6 +9372,7 @@ self.R = R;
                     'color',
                     'label',
                     'legend',
+                    'regionPadding',
                     'tooltip',
                     'xAxis',
                     'yAxis',
@@ -9153,296 +9664,6 @@ self.R = R;
                 };
                 return result;
             };
-            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 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 { 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
-                };
-                try {
-                    return {
-                        selectorLabel,
-                        coordinateDatum,
-                        matchedDatum: fallbackDatum,
-                        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 isDifferenceLineStacked = (vseed, advancedVSeed)=>('column' === vseed.chartType || 'bar' === vseed.chartType) && hasMultipleMeasureInSingleView(advancedVSeed.reshapeMeasures ?? []);
-            const resolveDifferenceAnchor = (options)=>{
-                const { dataset, selectorLabel, selectorValue, spec, isStacked } = options;
-                const matches = dataset.filter((datum)=>selector_selector(datum, selectorValue));
-                const valueField = getDifferenceValueField(spec);
-                const bandFields = getDifferenceBandFields(spec);
-                if (0 === matches.length) return isStacked ? void 0 : resolveFallbackAnchor({
-                    selectorLabel,
-                    selectorValue,
-                    valueField,
-                    bandFields
-                });
-                if (!isStacked) {
-                    if (1 !== matches.length) throw new Error(`annotationDifferenceLine ${selectorLabel} selector must resolve to exactly one datum, got ${matches.length}`);
-                    return {
-                        selectorLabel,
-                        coordinateDatum: matches[0],
-                        matchedDatum: matches[0],
-                        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));
-                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 {
-                    selectorLabel,
-                    coordinateDatum: stackGroupDatum,
-                    matchedDatum: matches[0],
-                    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 (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;
-                if (!anchor.stackGroupDatum) {
-                    const runtimeMatches = anchor.matchedDatum ? seriesData.filter((datum)=>isSubset(anchor.matchedDatum, datum)) : [];
-                    return runtimeMatches[0] ?? anchor.coordinateDatum;
-                }
-                const runtimeMatches = seriesData.filter((datum)=>isSubset(anchor.stackGroupDatum, datum));
-                const runtimeStackTotal = getStackRuntimeTotal(runtimeMatches);
-                return {
-                    ...runtimeMatches[0] ?? anchor.coordinateDatum,
-                    [relativeSeries.getStackValueField()]: runtimeStackTotal ?? anchor.value
-                };
-            };
-            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 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 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 barSpec = spec;
-                const isStacked = isDifferenceLineStacked(vseed, advancedVSeed);
-                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: 1000,
-                            connectDirection: inferDifferenceConnectDirection(vseed, [
-                                start.value,
-                                end.value
-                            ]),
-                            expandDistance: DEFAULT_EXPAND_DISTANCE,
-                            coordinates: (seriesData, relativeSeries)=>[
-                                    buildDifferenceCoordinateDatum({
-                                        anchor: start,
-                                        seriesData,
-                                        relativeSeries
-                                    }),
-                                    buildDifferenceCoordinateDatum({
-                                        anchor: end,
-                                        seriesData,
-                                        relativeSeries
-                                    })
-                                ],
-                            line: {
-                                style: {
-                                    visible: true,
-                                    stroke: lineColor,
-                                    lineWidth: DEFAULT_LINE_WIDTH,
-                                    lineDash: [
-                                        0
-                                    ],
-                                    cornerRadius: DEFAULT_CORNER_RADIUS
-                                }
-                            },
-                            label: {
-                                confine: true,
-                                visible: true,
-                                position: 'middle',
-                                text: buildDifferenceText(start.value, end.value, annotationDifferenceLine.differenceType ?? 'absolute'),
-                                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
-                                    }
-                                }
-                            },
-                            startSymbol: {
-                                visible: false
-                            },
-                            endSymbol: {
-                                visible: true,
-                                size: DEFAULT_END_SYMBOL_SIZE,
-                                refX: DEFAULT_END_SYMBOL_REF_X,
-                                style: {
-                                    fill: lineColor
-                                }
-                            }
-                        }
-                    ];
-                });
-                const specMarkLine = barSpec.markLine || [];
-                return {
-                    ...spec,
-                    markLine: [
-                        ...specMarkLine,
-                        ...markLine
-                    ]
-                };
-            };
             const annotationAreaBand = (spec, context)=>{
                 const { advancedVSeed, vseed } = context;
                 const { annotation, config } = advancedVSeed;
@@ -10038,6 +10259,7 @@ self.R = R;
             const column_column = [
                 fontFamilyTheme,
                 initColumn,
+                regionPadding,
                 stackCornerRadius_stackCornerRadius,
                 barMaxWidth_barMaxWidth,
                 stackInverse,
@@ -10070,6 +10292,7 @@ self.R = R;
                 pivotIndicators_pivotIndicators([
                     fontFamilyTheme,
                     initColumn,
+                    regionPadding,
                     stackCornerRadius_stackCornerRadius,
                     barMaxWidth_barMaxWidth,
                     stackInverse,
@@ -10255,6 +10478,7 @@ self.R = R;
             const columnParallel = [
                 fontFamilyTheme,
                 initColumnParallel,
+                regionPadding,
                 stackCornerRadius_stackCornerRadius,
                 barMaxWidth_barMaxWidth,
                 barGapInGroup_barGapInGroup,
@@ -10286,6 +10510,7 @@ self.R = R;
                 pivotIndicators_pivotIndicators([
                     fontFamilyTheme,
                     initColumnParallel,
+                    regionPadding,
                     stackCornerRadius_stackCornerRadius,
                     barMaxWidth_barMaxWidth,
                     colorAdapter(color_color, linearColor),
@@ -10362,6 +10587,7 @@ self.R = R;
             const columnPercent = [
                 fontFamilyTheme,
                 initColumn,
+                regionPadding,
                 stackCornerRadius_stackCornerRadius,
                 stackInverse,
                 barMaxWidth_barMaxWidth,
@@ -10393,6 +10619,7 @@ self.R = R;
                 pivotIndicators_pivotIndicators([
                     fontFamilyTheme,
                     initColumn,
+                    regionPadding,
                     stackCornerRadius_stackCornerRadius,
                     stackInverse,
                     barMaxWidth_barMaxWidth,
@@ -10742,6 +10969,7 @@ self.R = R;
             const bar = [
                 fontFamilyTheme,
                 initBar,
+                regionPadding,
                 stackCornerRadius_stackCornerRadius,
                 barMaxWidth_barMaxWidth,
                 colorAdapter(color_color, linearColor),
@@ -10772,6 +11000,7 @@ self.R = R;
                 pivotIndicators_pivotIndicators([
                     fontFamilyTheme,
                     initBar,
+                    regionPadding,
                     stackCornerRadius_stackCornerRadius,
                     barMaxWidth_barMaxWidth,
                     colorAdapter(color_color, linearColor),
@@ -13493,6 +13722,7 @@ self.R = R;
             const barParallel = [
                 fontFamilyTheme,
                 initBarParallel,
+                regionPadding,
                 stackCornerRadius_stackCornerRadius,
                 barMaxWidth_barMaxWidth,
                 barGapInGroup_barGapInGroup,
@@ -13524,6 +13754,7 @@ self.R = R;
                 pivotIndicators_pivotIndicators([
                     fontFamilyTheme,
                     initBarParallel,
+                    regionPadding,
                     stackCornerRadius_stackCornerRadius,
                     barMaxWidth_barMaxWidth,
                     colorAdapter(color_color, linearColor),
@@ -13592,6 +13823,7 @@ self.R = R;
             const barPercent = [
                 fontFamilyTheme,
                 initBar,
+                regionPadding,
                 stackCornerRadius_stackCornerRadius,
                 barMaxWidth_barMaxWidth,
                 colorAdapter(color_color, linearColor),
@@ -13622,6 +13854,7 @@ self.R = R;
                 pivotIndicators_pivotIndicators([
                     fontFamilyTheme,
                     initBar,
+                    regionPadding,
                     stackCornerRadius_stackCornerRadius,
                     barMaxWidth_barMaxWidth,
                     colorAdapter(color_color, linearColor),
@@ -13779,6 +14012,7 @@ self.R = R;
             const area_area = [
                 fontFamilyTheme,
                 initArea,
+                regionPadding,
                 stackInverse,
                 colorAdapter(color_color, linearColor),
                 background_backgroundColor,
@@ -13798,6 +14032,7 @@ self.R = R;
                 colorLineStyleFill(lineStyle_lineStyle),
                 colorAreaStyleFill(areaStyle_areaStyle),
                 annotationPoint_annotationPoint,
+                annotationDifferenceLine_annotationDifferenceLine,
                 annotationVerticalLine_annotationVerticalLine,
                 annotationHorizontalLine_annotationHorizontalLine,
                 annotationArea_annotationArea,
@@ -13811,6 +14046,7 @@ self.R = R;
                 pivotIndicators_pivotIndicators([
                     fontFamilyTheme,
                     initArea,
+                    regionPadding,
                     colorAdapter(color_color, linearColor),
                     background_backgroundColor,
                     stackInverse,
@@ -13829,6 +14065,7 @@ self.R = R;
                     colorLineStyleFill(lineStyle_lineStyle),
                     colorAreaStyleFill(areaStyle_areaStyle),
                     annotationPoint_annotationPoint,
+                    annotationDifferenceLine_annotationDifferenceLine,
                     annotationVerticalLine_annotationVerticalLine,
                     annotationHorizontalLine_annotationHorizontalLine,
                     annotationArea_annotationArea,
@@ -13882,6 +14119,7 @@ self.R = R;
             const areaPercent = [
                 fontFamilyTheme,
                 initArea,
+                regionPadding,
                 stackInverse,
                 colorAdapter(color_color, linearColor),
                 background_backgroundColor,
@@ -13914,6 +14152,7 @@ self.R = R;
                 pivotIndicators_pivotIndicators([
                     fontFamilyTheme,
                     initArea,
+                    regionPadding,
                     stackInverse,
                     colorAdapter(color_color, linearColor),
                     background_backgroundColor,
@@ -25612,6 +25851,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(),
@@ -25644,6 +25890,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(),
@@ -25699,6 +25946,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(),
@@ -25720,6 +25968,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(),
@@ -25737,6 +25986,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(),
@@ -26273,6 +26523,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(),
@@ -26287,6 +26538,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()
             });
@@ -26302,6 +26554,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(),
@@ -26334,6 +26587,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(),
@@ -26363,6 +26617,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(),
@@ -26390,6 +26645,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(),
@@ -26535,6 +26791,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(),
@@ -26565,6 +26822,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(),
@@ -26592,6 +26850,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(),
@@ -26605,6 +26864,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()
             });
@@ -26619,6 +26879,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(),